Formatage des dates, des heures, des nombres et autres

Représente le jour du mois sous la forme d’un nombre compris entre 1 et 31 : 27.

Un jour à un chiffre est formaté sans zéro à gauche : 3.

Si utilisé seul, il doit être précédé du préfixe %.

Représente le jour du mois sous la forme d’un nombre à deux chiffres de 01 à 31 : 27.

Un jour à un chiffre est formaté avec un zéro à gauche : 03.

Représente le mois sous la forme d’un nombre de 1 à 12 : 11.

Un mois à un chiffre est formaté sans zéro à gauche : 5.

Si utilisé seul, il doit être précédé du préfixe %.

Représente le mois sous la forme d’un nombre à deux chiffres de 01 à 12 : 11.

Un mois à un chiffre est formaté avec un zéro à gauche : 05.

Représente l’année sous la forme d’un nombre à un ou deux chiffres : 23.

Si l’année comporte plus de deux chiffres, seuls les deux chiffres d’ordre le moins élevé apparaissent dans le résultat. Par exemple, pour l’année 2023, 23 apparaît.

Si le premier chiffre d’une année à deux chiffres commence par un zéro (par exemple, 02), le nombre est formaté sans zéro à gauche : 2.

Représente l’année sous la forme d’un nombre à deux chiffres : 23.

Si l'année comporte plus de deux chiffres, seuls les deux chiffres d'ordre le moins élevé apparaissent dans le résultat. Par exemple, pour l’année 2023, 23 apparaît.

Si l’année à deux chiffres comporte moins de deux chiffres significatifs, le nombre est complété par des zéros à gauche pour obtenir deux chiffres : 02.

Si utilisé seul, il doit être précédé du préfixe %.

Représente l’année avec un minimum de trois chiffres : 2023.

Si l’année comporte plus de trois chiffres significatifs, ils sont inclus dans la chaîne résultante. Si l’année comporte moins de trois chiffres, des zéros seront ajoutés en tête du nombre afin d’obtenir trois chiffres.

Remarque : Pour le calendrier bouddhiste thaïlandais, qui peut avoir des années à cinq chiffres, ce spécificateur de format affiche les cinq chiffres.

Représente l’année sous la forme d’un nombre à quatre chiffres : 2023.

Si l’année comporte plus de quatre chiffres, seuls les quatre chiffres d’ordre le moins élevé apparaissent dans le résultat. Si l’année comporte moins de quatre chiffres, des zéros seront ajoutés en tête du nombre afin d’obtenir quatre chiffres.

Remarque : Pour le calendrier bouddhiste thaïlandais, qui peut avoir des années à cinq chiffres, ce spécificateur de format affiche les cinq chiffres.

Représente l’année sous forme de nombre à cinq chiffres.

Si l’année comporte plus de cinq chiffres, seuls les cinq chiffres d’ordre le moins élevé apparaissent dans le résultat. Si l’année a moins de cinq chiffres, le nombre est complété par des zéros à gauche pour obtenir cinq chiffres : 02023.

S’il y a plus de cinq spécificateurs y, le nombre est complété par autant de zéros à gauche que nécessaire pour atteindre le nombre de spécificateurs y. Par exemple, s’il y a huit spécificateurs y, la sortie est 00002023.

Représente la période ou l’ère, par exemple E.C.. Le script ignore ce spécificateur si la date à formater n’est pas associée à une chaîne de période ou d’ère.

Un g unique ne peut être utilisé seul. Si vous ne voulez modifier que le nom de l’époque ou de l’ère, utilisez un gg double.

Représente l’heure sous la forme d’un nombre de 1 à 12 sur une horloge de 12 heures qui compte les heures entières depuis minuit ou midi.

Il est impossible de déterminer si une heure se situe après minuit ou après midi. Par exemple, 1 heure du matin est la même chose que 1 heure de l’après-midi.

L’heure n’est pas arrondie, et une heure à un chiffre est mise en forme sans zéro de tête.

Si utilisé seul, il doit être précédé du préfixe %.

Par exemple, pour une heure de 5:43, ce spécificateur de format personnalisé affiche 5.

Représente l’heure sous la forme d’un nombre à deux chiffres de 01 à 12 sur une horloge de 12 heures qui compte les heures entières depuis minuit ou midi.

Il est impossible de déterminer si une heure se situe après minuit ou après midi. Par exemple, 1 heure du matin est la même chose que 1 heure de l’après-midi.

L’heure n’est pas arrondie, et une heure à un chiffre est mise en forme avec un zéro de tête.

Par exemple, pour une heure de 5:43, ce spécificateur de format personnalisé affiche 05.

Représente l’heure sous la forme d’un nombre de 0 à 23 sur une horloge de 24 heures qui compte les heures depuis minuit.

Une heure à un chiffre est mise en forme sans zéro de tête.

Par exemple, pour une heure de 17:43, ce spécificateur de format personnalisé affiche 17.

Si utilisé seul, il doit être précédé du préfixe %.

Représente l’heure sous la forme d’un nombre à deux chiffres de 00 à 23 sur une horloge de 24 heures qui compte les heures depuis minuit.

Une heure à un chiffre est mise en forme avec un zéro de tête.

Par exemple, pour une heure de 17:43, ce spécificateur de format personnalisé affiche 17.

Représente la minute sous la forme d’un nombre compris entre 0 et 59.

La minute représente le nombre de minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un chiffre est mise en forme sans zéro de tête.

Par exemple, pour une heure de 05:43:34, ce spécificateur de format personnalisé affiche 43.

Si utilisé seul, il doit être précédé du préfixe %.

Représente la minute sous la forme d’un nombre à deux chiffres compris entre 00 et 59.

La minute représente le nombre de minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un chiffre est mise en forme avec un zéro de tête.

Par exemple, pour une heure de 05:03:34, ce spécificateur de format personnalisé affiche 03.

Représente les secondes sous la forme d’un nombre compris entre 0 et 59.

Le résultat représente le nombre de secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un chiffre est mise en forme sans zéro de tête.

Par exemple, pour une heure de 05:43:04, ce spécificateur de format personnalisé affiche 4.

Si utilisé seul, il doit être précédé du préfixe %.

Représente les secondes sous la forme d’un nombre à deux chiffres compris entre 00 et 59.

Le résultat représente le nombre de secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un chiffre est mise en forme avec un zéro de tête.

Par exemple, pour une heure de 05:43:04, ce spécificateur de format personnalisé affiche 04.

Représente un nombre de chiffres de la fraction des secondes. Les spécificateurs f minuscules incluent les zéros à droite. Les spécificateurs F majuscules omettent les zéros à droite.

Ce spécificateur ne fonctionne qu’avec la date/heure OLE Automation Un moyen d’écrire des dates sous forme d’entiers à virgule flottante. Indique le nombre de jours écoulés depuis le 30 décembre 1899..

Le nombre de caractères f ou F inclus détermine le nombre de chiffres significatifs de la deuxième fraction à inclure :

• F : Dixième de seconde, ou chiffre le plus significatif. Si le chiffre est un zéro, rien n’est affiché.
• ff ou FF : centièmes de seconde, ou deux chiffres significatifs.
• fff ou FFF : Milliers de secondes, ou trois chiffres significatifs. On parle également de millisecondes.
• ffff ou FFFF : Dix millièmes de seconde, soit quatre chiffres significatifs.
• fffff ou FFFFF : Cent millièmes de seconde, soit cinq chiffres significatifs.
• ffffff ou FFFFFF : Millionième de seconde, ou six chiffres significatifs.
• FFFFFFF : Dix millionièmes de seconde, soit sept chiffres significatifs.

Plus la précision est grande, moins elle est fiable ou significative. La précision de la valeur du temps dépend de la résolution de l’horloge système de l’ordinateur.

Représente le premier caractère du désignateur AM/PM. Le désignateur AM est utilisé si le chiffre des heures de l’heure mise en forme est inférieur à 12. Dans le cas contraire, le désignateur PM est employé.

Pour les langues qui utilisent une désignation AM/PM où le premier caractère est le même et le second change, utilisez le spécificateur tt.

Si utilisé seul, il doit être précédé du préfixe %.

Représente le désignateur AM/PM. Le désignateur AM est utilisé si le chiffre des heures de l'heure mise en forme est inférieur à 12. Dans le cas contraire, le désignateur PM est employé.

Utilisez le spécificateur tt pour les langues telles que le japonais qui utilisent un désignateur AM/PM où le premier caractère est le même et le second change.

Représente le décalage signé du fuseau horaire du système d’exploitation local par rapport au temps universel coordonné (UTC). Le nombre de caractères z définit la partie du décalage à afficher :

• z, zz : Mesure le décalage en heures.
• zzz : Mesure le décalage en heures et minutes.

Le décalage est toujours affiché précédé d’un signe. Un signe plus (+) indique les heures d’avance et un signe moins (-) indique les heures de retard par rapport à UTC. Le décalage est compris entre -12 et +13. Un décalage à un chiffre est mis en forme avec un zéro de tête.

Si utilisé seul, il doit être précédé du préfixe %.

Le nombre est converti en une chaîne qui représente un montant monétaire. Ajoutez un nombre au spécificateur de format pour indiquer le nombre de décimales que vous souhaitez voir figurer dans le nombre. La casse du spécificateur de format n’affecte pas les résultats.

ASSIGN StringVal = "0013001.93912837"
ASSIGN CurrencyResult = "{StringVal.format('C')}"
ASSIGN CurrencyResult3 = "{StringVal.format('C3')}"

Résultat :

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

E0

E-0

e0

e+0

e-0

Le numéro est converti en une chaîne de la forme -d.ddd…E+ddd ou -d.ddd…e+ddd, où chaque d indique un chiffre (0-9). La chaîne débute par un signe moins si le nombre est négatif. Le séparateur décimal est toujours précédé d’un chiffre.

Ajoutez un nombre au spécificateur de format pour indiquer le nombre de chiffres que vous souhaitez voir apparaître après la virgule. Si vous ne précisez pas de spécificateur de précision, le script utilise six décimales par défaut.

La casse du spécificateur de format indique si l’exposant dans la sortie est préfixé par un E ou un e. L’exposant comprend toujours un signe plus ou moins et un minimum de trois chiffres. Des zéros seront ajoutés en tête de l’exposant afin de respecter ce minimum, le cas échéant.

Si l’une des chaînes E, E+, E-, e, e+ ou e- est présente dans la chaîne de format et est suivie immédiatement d’au moins un caractère 0, le nombre est formaté en utilisant la notation scientifique avec un E ou un e inséré entre le nombre et l’exposant.

Le nombre de caractères 0 suivant l’indicateur de notation scientifique détermine le nombre minimum de chiffres à afficher pour l’exposant. Les formats E+ et e+ indiquent qu’un signe (plus ou moins) doit toujours précéder l’exposant. Les formats E, E-, e ou e- indiquent qu’un signe ne doit précéder que les exposants négatifs.

 ASSIGN StringVal = "0013001.93912837"
ASSIGN ScientificResult = "{StringVal.format('e')}"		
ASSIGN ScientificResult = "{StringVal.format('E2')}"	

Résultat :

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

Le nombre est converti en une chaîne de la forme -ddd.ddd… où chaque d indique un chiffre (0-9). La chaîne débute par un signe moins si le nombre est négatif.

Ajoutez un nombre au spécificateur de format pour indiquer le nombre de décimales que vous souhaitez voir figurer dans le résultat. Sans l’indicateur de précision, le script utilise deux décimales par défaut.

ASSIGN StringVal = "0013001.93912837"
ASSIGN FixedPointResult = "{StringVal.format('F3')}"
ASSIGN FixedPointResult2 = "{StringVal.format('f')}"

Résultat :

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

Le nombre est converti dans la notation la plus compacte, soit en virgule fixe, soit en notation scientifique, en fonction du type de nombre et de la présence ou non d’un spécificateur de précision. Si le spécificateur de précision est omis ou nul, le type du nombre détermine la précision par défaut, comme indiqué dans la liste suivante :

• Byte ou SByte : 3
• Int16 ou UInt16 : 5
• Int32 ou UInt32 : 10
• Int64 ou UInt64 : 19
• Unique : 7
• Double : 15
• Décimale : 29

La notation à point fixe est utilisée si l’exposant résultant de l’expression du nombre en notation scientifique est supérieur à -5 et inférieur au spécificateur de précision. Dans le cas contraire, la notation scientifique est utilisée. Le résultat contient le cas échéant un séparateur décimal et les zéros de queue sont omis.

Si le spécificateur de précision est présent et le nombre de chiffres significatifs du résultat dépasse la précision spécifiée, les chiffres de queue excédentaires sont supprimés et le chiffre arrondi. Il existe une exception à la règle si le nombre est un nombre de type Décimal et que le spécificateur de précision est omis. Dans ce cas, la notation à point fixe est toujours utilisée et les zéros de queue sont conservés.

Si la notation scientifique est utilisée, l’exposant du résultat est préfixé par E si le spécificateur de format est G, ou par e si le spécificateur de format est g.

ASSIGN StringVal = "0013001.93912837"
ASSIGN GeneralResult1 = "{StringVal.format('G')}"
ASSIGN StringVal2 = 6002348902348890234.234432234
ASSIGN GeneralResult2 = "{StringVal2.format('G')}"

Résultat :

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

Ce format n’est pris en charge que par les types intégraux. Le nombre est converti en une chaîne de chiffres hexadécimaux. La casse du spécificateur de format indique s’il convient d’utiliser des caractères majuscules ou minuscules pour les chiffres hexadécimaux supérieurs à 9. Par exemple, utilisez X pour produire ABCDEF et x pour produire abcdef.

Le spécificateur de précision indique le nombre minimal de chiffres souhaité dans la chaîne résultante. Le cas échéant, des zéros seront ajoutés à la gauche du nombre afin de fournir le nombre de chiffres déterminé par le spécificateur de précision.

Le nombre est converti en une chaîne de la forme -d,ddd,ddd.ddd…, où :

• Le signe moins ( - ) indique un symbole de nombre négatif si nécessaire.
• Chaque d représente un chiffre (0-9).
• Une virgule ( , ) indique un séparateur de milliers entre les groupes de chiffres.
• La période (. ) indique un symbole de point décimal.

Incluez un spécificateur de précision pour indiquer le nombre de décimales que vous souhaitez voir figurer dans le résultat. Si aucune précision n’est spécifiée, la valeur par défaut est de deux décimales. Si le nombre ne comporte pas de point décimal, .00 est ajouté au nombre de sortie.

ASSIGN StringVal = "0013001.93912837"
ASSIGN NumberResult = StringVal.format('N')
ASSIGN NumberResult2 = "{StringVal.format('n2')}"

Résultat :

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

Le nombre est converti en une chaîne représentant un pourcentage. Le nombre converti est multiplié par 100 afin d’être présenté sous forme de pourcentage.

Incluez un spécificateur de précision pour indiquer le nombre de décimales que vous souhaitez voir figurer dans le résultat. Si aucune précision n’est spécifiée, la valeur par défaut est de deux décimales. Si le nombre ne comporte pas de point décimal, .00 est ajouté au nombre de sortie.

ASSIGN StringVal = "0013001.93912837"
ASSIGN PercentResult = "{StringVal.format('P')}"
ASSIGN PercentResult2 = StringVal.format('P2')	

Résultat :

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

Ce format n’est pris en charge que par les types Single et Double. Le spécificateur d’aller-retour garantit qu’une valeur numérique convertie en chaîne sera analysée dans la même valeur numérique. Lorsqu’une valeur numérique est mise en forme avec ce spécificateur, elle est tout d’abord testée à l’aide du format général, avec 15 espaces de précision pour une valeur de type Double et 7 espaces de précision pour une valeur de type Single. Si la valeur est correctement analysée dans la même valeur numérique, elle est mise en forme à l’aide du spécificateur de format général. Cependant, si la valeur n’est pas analysée correctement dans la même valeur numérique, la valeur est mise en forme en utilisant 17 chiffres de précision pour une valeur de type Double et 9 chiffres de précision pour une valeur de type Single.

Bien qu’un spécificateur de précision soit présent, il est ignoré. Les aller-retour prévalent sur la précision lorsque vous utilisez ce spécificateur.

ASSIGN StringVal = "0013001.93912837"
ASSIGN RoundTripResult = "{StringVal.format('R')}"	

Résultat :

ROUNDTRIPRESULT=13001.93912837

Utilisez un ou plusieurs espaces réservés pour zéro pour définir le format des nombres dans la sortie. Vous pouvez combiner ce caractère générique avec les autres caractères génériques définis dans ce tableau.

Si la valeur formatée comporte un nombre à l’endroit où un 0 apparaît dans la chaîne de format, ce nombre apparaît dans la chaîne de sortie. Si aucun nombre n’apparaît à l’endroit où un 0 apparaît dans la chaîne de format, 0 apparaît dans la chaîne de sortie à la place. Cela peut être utile pour ajouter des zéros à un nombre qui a besoin de zéros à gauche, mais qui n’en a pas.

La position du 0 le plus à gauche avant la virgule et du 0 le plus à droite après la virgule détermine le nombre de chiffres qui sont toujours présents dans la chaîne de sortie.

Le spécificateur 00 fait en sorte que la valeur soit arrondie au nombre entier le plus proche.

ASSIGN number = "2343456.2343"
ASSIGN zeroPlaceholders = "number.format(000,000.00)
ASSIGN number = "456.47"
ASSIGN doubleZeroSpecifier = number.format('00')

Les résultats de l’exemple sont

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Utilisez un ou plusieurs espaces réservés pour chiffre pour définir le format des nombres dans la sortie. Vous pouvez combiner ce caractère générique avec les autres caractères génériques définis dans ce tableau.

Si la valeur formatée comporte un nombre à l’endroit où un # apparaît dans la chaîne de format, ce nombre apparaît dans le résultat de la sortie. Si aucun nombre n’apparaît à l’endroit où un # apparaît dans la chaîne de format, cet espace est vide dans la chaîne de sortie.

Si le nombre à formater contient un 0 comme chiffre significatif, le 0 apparaît dans la chaîne de sortie. Si le 0 n’est pas un chiffre significatif, il n’apparaît pas dans la chaîne de sortie, même si le 0 est le seul chiffre de la chaîne à formater.

La chaîne de format ## permet d’arrondir la valeur au nombre entier le plus proche.

ASSIGN number = "2343456.2043"
ASSIGN digitPlaceholders = "number.format(###,###.##)
ASSIGN number = "456.47"
ASSIGN doubleDigitSpecifier = number.format('##')

Les résultats de l’exemple sont

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

Le premier point ( . ) dans la chaîne de format détermine l’emplacement du séparateur décimal dans la valeur formatée. Tout point supplémentaire est ignoré.

La virgule ( , ) sert à la fois de séparateur de milliers et de spécificateur de mise à l’échelle des nombres.

Spécificateur de séparateur de milliers : Si une ou plusieurs virgules (,) sont spécifiées entre deux espaces réservés aux chiffres (0 ou #) qui mettent en forme les chiffres intégraux d’un nombre, un caractère de séparation des groupes est inséré entre chaque groupe de nombres dans la partie intégrale de la sortie. Par exemple, si la chaîne #,# et la culture indifférente sont utilisées pour mettre en forme le nombre 1000, la sortie est « 1,000 ».

Spécificateur de mise à l’échelle des nombres : si une ou plusieurs virgules (,) sont spécifiées immédiatement à gauche du séparateur décimal explicite ou implicite, le nombre à mettre en forme est divisé par 1000 chaque fois qu’un spécificateur de mise à l’échelle des nombres se présente. Par exemple, si la chaîne 0,, est utilisée pour formater le nombre 100 millions, la sortie est 100.

Vous pouvez utiliser des spécificateurs de séparateur de milliers et de mise à l’échelle des nombres dans la même chaîne de format. Par exemple, si la chaîne #,0,, et la culture indifférente sont utilisées pour mettre en forme le nombre 1 milliard, la sortie est 1,000

Permet de définir deux ou trois options de formatage possibles pour les nombres. Le formatage est appliqué selon que le nombre est positif, négatif ou nul.

Les options de formatage sont définies dans une seule chaîne. Chaque option est séparée par un point-virgule (;). Utilisez les espaces réservés pour zéro, chiffre, milliers et décimale pour définir le formatage, comme indiqué dans les exemples ci-dessous. Ces espaces réservés sont décrits dans ce tableau.

S’il y a deux sections dans la chaîne de format personnalisée :

• La section de gauche définit le formatage des nombres positifs et nuls.
• La section de droite définit le formatage des nombres négatifs.

Par exemple :

ASSIGN number9 = 928374
ASSIGN sectionSeparator4 = number9.format('000,000.##;00.##')

ASSIGN number10 = -998822.25
ASSIGN sectionSeparator5 = number10.format('000,000.##;00.##')

ASSIGN number11 = 0
ASSIGN sectionSeparator6 = number11.format('000,000.##;00.##')	

Les résultats de l’exemple sont

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

S’il y a trois sections :

• La section de gauche définit le formatage des nombres positifs.
• La section centrale définit le formatage des nombres négatifs.
• La section de droite définit le formatage des zéros.

Par exemple :

ASSIGN number1 = 1789789
ASSIGN sectionSeparator1 = number1.format('000,000.##;00.##;000.0000')

ASSIGN number2 = 0
ASSIGN sectionSeparator2 = number2.format('000,000.##;00.##;000.0000')

ASSIGN number3 = -4321
ASSIGN sectionSeparator3 = number3.format('000,000.##;00.##;000.0000')

Les résultats de l’exemple sont

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Tous les autres caractères

Tout autre caractère est copié dans la chaîne résultante, sans affecter la mise en forme.

Sert à préfixer une chaîne qui comprend une séquence d’échappement. Le caractère $ doit se trouver à l’extérieur des guillemets. Par exemple :

z = $"Use the \{myVar} variable."

Sert à préfixer une valeur pour la déclarer comme un type date/heure. Le caractère # doit se trouver à l’extérieur des guillemets. Par exemple :

ASSIGN var = #"02/09/2023"