Date, heure, Nombre et autres Formatting

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, faites-le précéder de %.

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, faites-le précéder de %.

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 de poids faible 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 de poids faible 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, faites-le précéder de %.

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

Si l'année comporte plus de trois chiffres significatifs, ceux-ci sont inclus dans la chaîne de résultat. 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 de poids faible 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 de poids faible apparaissent dans le résultat. Si l'année comporte moins de cinq chiffres, des zéros seront ajoutés en tête du nombre afin d'obtenir cinq chiffres : 02023.

S'il y a plus que cinq spécificateurs y, le nombre est complété par autant de zéros de tête 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, telle que A.D. Le script ignore ce spécificateur si la date à mettre en forme n'a pas de chaîne de période ou d'ère associée.

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

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:00 AM est identique à 1:00 PM.

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

Si utilisé seul, ajoutez le 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:00 AM est identique à 1:00 PM.

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 5:43 PM, ce spécificateur de format personnalisé affiche 17.

Si utilisé seul, ajoutez le 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 5:43 PM, 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 les minutes entières é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, ajoutez le préfixe %.

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

La minute représente les minutes entières é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 les secondes entières é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, préfixez avec %.

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

Le résultat représente les secondes entières é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 en minuscule f incluent les zéros de fin. Les spécificateurs en majuscule F omettent les zéros de fin.

Ce spécificateur ne fonctionne qu’avec la date/heure OLE Automation Façon d'écrire des dates sous forme d'un nombre à 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 combien de chiffres significatifs de la fraction de seconde 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ème de seconde, ou trois chiffres significatifs. On appelle également cela des millisecondes.
• ffff ou FFFF : Dix-millième de seconde, ou quatre chiffres significatifs.
• fffff ou FFFFF : Cent-millième de seconde, ou 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 vous précisez la précision, moins elle risque d'être fiable ou significative. La précision de la valeur temporelle 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 l'heure du temps mis en forme est inférieure à 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 identique et le deuxième caractère change, utilisez le spécificateur tt.

En cas d'utilisation seule, ajoutez le préfixe %.

Représente le désignateur AM/PM. Le désignateur AM est utilisé si l'heure du temps mis en forme est inférieure à 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 portion du décalage à afficher :

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

Le décalage est toujours affiché avec un signe en tête. Un signe plus (+) indique les heures devant l'UTC et un signe moins (-) indique les heures derrière l'UTC. Le décalage varie de –12 à +13. Un décalage à un seul chiffre est mis en forme avec un zéro en tête.

En cas d'utilisation seule, ajoutez le préfixe %.

Le nombre est converti en une chaîne représentant un montant en monnaie. Inclure un nombre avec le spécificateur de format pour indiquer le nombre de décimales que vous souhaitez que le nombre comporte. La casse du spécificateur de format n'a pas d'incidence sur 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 le point décimal.

Inclure un nombre avec le spécificateur de format pour indiquer le nombre de chiffres que vous souhaitez après le point décimal. 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 si l'exposant dans la sortie est précédé d'un E ou d'un e. L'exposant est toujours composé d'un signe plus ou moins et d'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 immédiatement suivie d'au moins un caractère 0, le nombre est alors formaté à l'aide de 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 minimal de chiffres à afficher en sortie pour l'exposant. Les formats E+ et e+ indiquent qu'un caractère de 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.

Inclure un nombre avec le spécificateur de format pour indiquer le nombre de décimales que vous souhaitez que le résultat comporte. 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 selon la notation la plus compacte, qu'il s'agisse de la notation à virgule fixe ou de la notation scientifique, en fonction du type de nombre et de l'inclusion ou non d'un spécificateur de précision. Si le spécificateur precision est omis ou est égal à zéro, le type de 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
• Single : 7
• Double : 15
• Décimale : 29

La notation à point 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 de queue 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, alors les chiffres de queue excédentaires sont supprimés par arrondissement. L'exception à cette règle est le cas où le nombre est un Décimal et où 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écédé de E si le spécificateur de format est G, ou de 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. 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 nombres.
• Le point ( . ) indique un symbole de point décimal.

Inclure un spécificateur de précision pour indiquer le nombre de décimales que vous souhaitez que le résultat comporte. 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.

Inclure un spécificateur de précision pour indiquer le nombre de décimales que vous souhaitez que le résultat comporte. 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 Single et Double. Le spécificateur d'aller-retour garantit qu'une valeur numérique convertie en chaîne sera analysée pour redonner 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 une précision de 15 espaces pour un Double et de 7 espaces pour un Single. Si la valeur est analysée avec succès pour redonner 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 pour redonner la même valeur numérique, alors la valeur est formatée avec une précision de 17 chiffres pour un Double et de 9 chiffres pour un Single.

Bien qu'un spécificateur de précision puisse être 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 afin de définir le format des nombres dans la sortie. Vous pouvez combiner cet espace réservé avec les autres caractères d'espace réservé définis dans ce tableau.

Si la valeur formatée comporte un nombre à la position 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 à la position où un 0 apparaît dans la chaîne de format, un 0 apparaît à la place dans la chaîne de sortie. 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 afin de définir le format des nombres dans la sortie. Vous pouvez combiner cet espace réservé avec les autres caractères d'espace réservé définis dans ce tableau.

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

Si le nombre mis en forme 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 0 est le seul nombre dans la chaîne à mettre en forme.

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 caractère de point ( . ) dans la chaîne de format détermine l'emplacement du séparateur décimal dans la valeur mise en forme. Tout caractère de point supplémentaire est ignoré.

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

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 chiffre (0 ou #) qui mettent en forme les chiffres entiers d'un nombre, un caractère de séparateur de groupe est inséré entre chaque groupe de nombres dans la partie entière 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 un ou plusieurs caractères de virgule ( , ) sont spécifiés immédiatement à gauche du point décimal explicite ou implicite, le nombre à mettre en forme 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 mettre en forme 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 un milliard, la sortie est 1,000.

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

Les options de mise en forme sont définies dans une seule chaîne. Chaque option est séparée par un caractère de point-virgule ( ; ). Utilisez les espaces réservés de zéro, de chiffre, de milliers et de décimale pour définir la mise en forme, comme illustré 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.

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

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

Utilisez ce caractère pour préfixer une valeur afin de la déclarer comme type date/heure. Le caractère # doit se trouver à l'extérieur des guillemets doubles. Par exemple :

ASSIGN var = #"02/09/2023"