Formatage de la date, de l'heure, des nombres et autres formats

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

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

En cas d'utilisation seule, préfixez avec %.

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

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

Représente le mois sous la forme d'un nombre entre 1 et 12 : 11.

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

En cas d'utilisation seule, préfixez avec %.

Représente le mois sous la forme d'un nombre à deux chiffres entre 01 et 12 : 11.

Un mois à un chiffre est formaté avec un zéro non significatif : 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 de poids faible apparaissent dans le résultat. Par exemple, pour l'année 2023, 23 sera indiqué.

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 non significatif : 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 de poids faible apparaissent dans le résultat. Par exemple, pour l'année 2023, 23 sera indiqué.

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

En cas d'utilisation seule, préfixez avec %.

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 de résultat. Si l'année comporte moins de trois chiffres, le nombre est complété par des zéros non significatifs pour obtenir trois chiffres.

Note : 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 de poids faible apparaissent dans le résultat. Si l'année comporte moins de quatre chiffres, le nombre est complété par des zéros non significatifs pour obtenir quatre chiffres.

Note : 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 à cinq chiffres.

Si l'année comporte plus de cinq chiffres, seuls les cinq chiffres de poids faible apparaissent dans le résultat. Si l'année comporte moins de cinq chiffres, le nombre est complété par des zéros non significatifs pour obtenir cinq chiffres : 02023.

S'il existe plus de cinq spécificateurs y, le nombre est rempli avec autant de zéros non significatifs que nécessaire pour atteindre le nombre de spécificateurs y. Par exemple, s'il existe huit spécificateurs y, la sortie est 00002023.

Représente la période ou l'ère, par exemple A.D.. Le script ignore ce spécificateur si la date à formater n'a pas de chaîne de période ou d'ère associée.

Un seul g ne peut être utilisé seul. Si vous ne voulez sortir que le nom de l'ère ou de la période, utilisez un double gg.

Représente l'heure sous la forme d'un nombre entre 1 et 12 en format 12 heures, qui compte les heures entières depuis minuit ou midi.

Une heure particulière après minuit est indiscernable de la même heure après midi. Par exemple, 1:00 AM est la même chose que 1:00 PM.

L'heure n'est pas arrondie et une heure à un seul chiffre est formatée sans zéro non significatif.

En cas d'utilisation seule, préfixez avec %.

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 entre 01 et 12 en format 12 heures, qui compte les heures entières depuis minuit ou midi.

Une heure particulière après minuit est indiscernable de la même heure après midi. Par exemple, 1:00 AM est la même chose que 1:00 PM.

L'heure n'est pas arrondie et une heure à un chiffre est formatée avec un zéro non significatif.

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 entre 0 et 12 en format 24 heures, qui compte les heures depuis minuit.

Une heure à un chiffre est formatée sans zéro non significatif.

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

En cas d'utilisation seule, préfixez avec %.

Représente l'heure sous la forme d'un nombre à deux chiffres entre 00 et 23 en format 24 heures, qui compte les heures depuis minuit.

Une heure à un chiffre est formatée avec un zéro non significatif.

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 entre 0 et 59.

La minute représente les minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un chiffre est formatée sans zéro non significatif.

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

En cas d'utilisation seule, préfixez avec %.

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

La minute représente les minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un chiffre est formatée avec un zéro non significatif.

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

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

Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un chiffre est formatée sans zéro non significatif.

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

En cas d'utilisation seule, préfixez avec %.

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

Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un chiffre est formatée avec un zéro non significatif.

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

Représente un nombre de chiffres de la fraction de seconde. Les spécificateurs f en minuscules incluent les zéros de fin. Les spécificateurs F en majuscules omettent les zéros de fin.

Ce spécificateur ne fonctionne qu'avec les dates/heures d’automatisation OLE Un moyen d'écrire des dates sous forme de nombre entier à virgule flottante. Indique le nombre de jours 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ème de seconde, ou deux chiffres significatifs.
• fff ou FFF : millièmes de secondes, ou trois chiffres significatifs. On parle également de millisecondes.
• ffff ou FFFF : dix millièmes de seconde, ou quatre chiffres significatifs.
• fffff ou FFFFF : cent millièmes de secondes, ou cinq chiffres significatifs.
• ffffff ou FFFFFF : millionièmes de secondes, ou six chiffres significatifs.
• ou FFFFFFF : dix millionièmes de seconde, ou sept chiffres significatifs.

Plus la précision est grande, moins elle est fiable ou significative. La précision des valeurs d'heure dépend de la résolution de l'horloge système de l’ordinateur.

Représente le premier caractère de l'indicateur AM/PM. L'indicateur AM est utilisé si l'heure de l'heure formatée est inférieure à 12. Sinon, l'indicateur PM est utilisé.

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.

En cas d'utilisation seule, préfixez avec %.

Représente l'indicateur AM/PM. L'indicateur AM est utilisé si l'heure de l'heure formatée est inférieure à 12. Sinon, l'indicateur PM est utilisé.

Utilisez le spécificateur tt pour les langues comme le japonais, qui utilisent une désignation AM/PM où le premier caractère est le même et où 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), mesuré en heures. 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 en minutes.

Le décalage est toujours affiché avec un signe avant-coureur. Un signe plus (+) indique des heures d'avance et un signe moins (-) indique des heures de retard UTC. Le décalage est compris entre –12 et +13. Un décalage à un chiffre est formaté avec un zéro non significatif.

En cas d'utilisation seule, préfixez avec %.

Le nombre est converti en une chaîne qui représente un montant en devise. Ajoutez un nombre au spécificateur de format pour indiquer le nombre de décimales que vous voulez 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 nombre 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 commence par un signe moins si le nombre est négatif. Un chiffre précède toujours la virgule décimale.

Ajoutez un nombre au spécificateur de format pour indiquer le nombre de chiffres que vous voulez voir figurer après la virgule décimale. Si vous n’incluez pas le spécificateur de précision, le script utilise par défaut six décimales.

La casse du spécificateur de format indique s'il faut précéder l'exposant dans la sortie d’un E ou d’un e. L'exposant est toujours composé d'un signe plus ou moins et d'au moins trois chiffres. L'exposant est complété par des zéros pour respecter ce minimum, si nécessaire.

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

Le nombre de caractères 0 après l'indicateur de notation scientifique détermine le nombre minimum de chiffres à produire 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 caractère de 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 commence 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 voulez voir figurer dans le résultat. Sans l'indicateur de précision, le script utilise par défaut deux décimales.

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 en la plus compacte des notations à virgule fixe ou scientifique, selon le type du nombre et si un spécificateur de précision est inclus. Si le spécificateur de précision est omis ou est égal à zéro, le type du nombre détermine la précision par défaut, comme indiqué par la liste suivante  :

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

La notation à virgule fixe est utilisée si l'exposant qui résulterait de l'expression du nombre en notation scientifique est supérieur à -5 et inférieur au spécificateur de précision ; sinon, la notation scientifique est utilisée. Le résultat contient un point décimal si nécessaire et les zéros à droite sont omis.

Si le spécificateur de précision est présent et que le nombre de chiffres significatifs dans le résultat dépasse la précision spécifiée, les chiffres de fin en excès sont supprimés par arrondi. L'exception à cette règle se présente si le nombre est un décimal et que le spécificateur de précision est omis. Dans ce cas, la notation à virgule fixe est toujours utilisée et les zéros de fin sont conservés.

Si la notation scientifique est utilisée, l'exposant dans le 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 est pris en charge uniquement pour 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 faut 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 minimum de chiffres souhaité dans la chaîne résultante. Si nécessaire, le nombre est rempli de zéros à sa gauche pour produire le nombre de chiffres donné 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 nombres.
• Le point ( . ) indique un symbole de point décimal.

Ajoutez un spécificateur de précision pour indiquer le nombre de décimales que vous voulez voir figurer dans le résultat. Si aucun spécificateur de précision n'est inclus, 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 qui représente un pourcentage. Le nombre converti est multiplié par 100 afin d'être présenté sous forme de pourcentage.

Ajoutez un spécificateur de précision pour indiquer le nombre de décimales que vous voulez voir figurer dans le résultat. Si aucun spécificateur de précision n'est inclus, 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 est pris en charge uniquement pour les types Simple et Double. Le spécificateur aller-retour garantit qu'une valeur numérique convertie en chaîne sera analysée en retour dans la même valeur numérique. Lorsqu'une valeur numérique est formatée à l'aide de ce spécificateur, elle est d'abord testée à l'aide du format général, avec 15 espaces de précision pour un Double et 7 espaces de précision pour un Single. Si la valeur est analysée avec succès vers la même valeur numérique, elle est formatée à l'aide du spécificateur de format général. Toutefois, si la valeur n'est pas analysée avec succès vers la même valeur numérique, la valeur est formatée à l'aide de 17 chiffres de précision pour un Double et de 9 chiffres de précision pour un Single.

Bien qu'un spécificateur de précision puisse être présent, il est ignoré. Les allers-retours sont prioritaires sur la précision lors de l'utilisation de 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 mise en forme comporte un chiffre à l’endroit où 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. Si la valeur mise en forme comporte un chiffre à l’endroit où 0 apparaît dans la chaîne de format, ce nombre apparaît dans la chaîne en sortie.

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

Le spécificateur 00 fait que la valeur est 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')

Le résultat de l’exemple est

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Utilisez un ou plusieurs espaces réservés pour chiffres 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 mise en forme comporte un chiffre à l’endroit où# apparaît dans la chaîne de format, ce nombre apparaît dans le résultat en sortie. Si aucun nombre n'apparaît à l'endroit où un # apparaît dans la chaîne de format, cet endroit 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 ## fait que la valeur est arrondie au nombre entier le plus proche.

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

Le résultat de l’exemple est

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

Le premier caractère de 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é.

Le caractère virgule ( , ) sert à la fois de spécificateur de séparateur des milliers et de spécificateur de mise à l'échelle numérique.

Spécificateur de séparateur de milliers : si un ou plusieurs caractères de virgule ( , ) sont spécifiés entre deux espaces réservés de chiffres (0 ou #) qui mettent en forme les chiffres entiers d'un nombre, un caractère séparateur de groupe 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 invariante sont utilisées pour formater le nombre 1000, la sortie est 1 000.

Spécificateur de mise à l'échelle des nombres : si un ou plusieurs caractères de virgule ( , ) sont spécifiés immédiatement à gauche de la virgule décimale explicite ou implicite, le nombre à formater est divisé par 1000 pour chaque spécificateur de mise à l'échelle des nombres. 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 numérique dans la même chaîne de format. Par exemple, si la chaîne #,0,, et la culture invariante sont utilisées pour formater le nombre un 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 chaîne unique. Chaque option est séparée par un point-virgule ( ; ). Utilisez les espaces réservés 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.##')	

Le résultat de l’exemple est

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 nombres nuls.

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')

Le résultat de l’exemple est

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Tous les autres personnages

Tout autre caractère est copié dans la chaîne de résultat et n'affecte pas le formatage.

A utiliser pour 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 afin de la déclarer comme un type de date/heure. Le caractère # doit se trouver à l'extérieur des guillemets. Par exemple :

ASSIGN var = #"02/09/2023"