Date, heure, nombre et autre mise en forme

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, ajoutez le préfixe %.

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.

Si vous l'utilisez seul, ajoutez le préfixe %.

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.

Si vous l'utilisez seul, ajoutez le préfixe %.

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

Si l'année comporte plus que trois chiffres significatifs, ceux-ci 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 y a plus que cinq spécificateurs y, le nombre est complété avec 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, 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 pas être utilisé seul. Si vous souhaitez afficher en sortie 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 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.

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

Si vous l'utilisez seul, ajoutez le préfixe %.

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

Si vous l'utilisez seul, ajoutez le préfixe %.

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:34, 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:04, ce spécificateur de format personnalisé affiche 4.

Si vous l'utilisez seul, ajoutez le préfixe %.

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:04, ce spécificateur de format personnalisé affiche 04.

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

Ce spécificateur ne fonctionne qu'avec les dates/heures d’automatisation OLE 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 f ou F caractères inclus détermine le nombre de chiffres significatifs de la seconde fraction à inclure :

• F : Dixièmes 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 : millièmes de seconde, ou trois chiffres significatifs. On parle également de millisecondes.
• ffff ou FFFF : dix millièmes de seconde, ou quatre chiffres significatifs.
• fffff ou FFFFF : centième millième de seconde, soit cinq chiffres significatifs.
• ffffff ou FFFFFF : millionièmes de seconde, soit 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 de temps 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 dans laquelle le premier caractère est identique et le second caractère change, utilisez le spécificateur tt.

Si vous l'utilisez seul, ajoutez le préfixe %.

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). Le nombre de caractères z définit la portion du décalage à afficher :

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

Le décalage s'affiche toujours avec un signe précédent. Un signe plus (+) indique des heures d'avance et un signe moins (-) indique des heures de retard par rapport à l'UTC. Le décalage varie de –12 à +13. Un décalage à un chiffre est formaté avec un zéro précédent.

Si vous l'utilisez seul, ajoutez le préfixe %.

Le nombre est converti en une chaîne qui représente un montant de monnaie. 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

The number is converted to a string of the form -d.ddd…E+ddd or -d.ddd…e+ddd, where each d indicates a digit (0-9). Attendez, je dois traduire ce texte. 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.

Incluez un nombre avec le spécificateur de format pour indiquer le nombre de chiffres que vous souhaitez 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 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'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, le nombre est alors formaté en notation scientifique avec un E ou 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 à générer en sortie 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 dans la notation la plus compacte, qu'elle soit à virgule fixe ou scientifique, selon le type du nombre et selon qu'un spécificateur de précision est inclus. Si le spécificateur de précision est omis ou égal à zéro, 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
• **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 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. Si nécessaire, le nombre est complété par des zéros à gauche afin d'obtenir le nombre de chiffres indiqué 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.
• 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 numéro ne comporte pas de point décimal, .00 est ajouté au numéro 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 numéro ne comporte pas de point décimal, .00 est ajouté au numéro 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 de conversion 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 chiffres pour un Double et de 7 chiffres pour un Single. Si la valeur est analysée avec succès pour redonner la même valeur numérique, elle est formatée en utilisant le 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 en utilisant 17 chiffres de précision pour un Double et 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 zéro pour 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 mise en forme comporte un chiffre à la position où un 0 apparaît dans la chaîne de format, ce chiffre apparaît dans la chaîne de sortie. Si aucun chiffre n'apparaît à la position où figure un 0 dans la chaîne de format, le 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')

Les résultats de cet exemple sont :

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Utilisez un ou plusieurs espaces réservés de chiffres pour 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 en cours de mise en forme comporte un chiffre à la position où apparaît un # dans la chaîne de format, ce chiffre apparaît dans le résultat de sortie. Si aucun chiffre n'apparaît à la position où apparaît un # dans la chaîne de format, cet emplacement est vide dans la chaîne de sortie.

Si le nombre à formater contient un 0 en tant que 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 à formater.

La chaîne de format ## entraîne l'arrondi de la valeur au nombre entier le plus proche (arrondi).

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

Les résultats de cet exemple sont :

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

La première période ( . ) 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 de milliers et de spécificateur d'échelle numérique.

Spécificateur de séparateur de milliers : Si un ou plusieurs caractères 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 de séparation 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 invariante 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 virgule ( , ) sont spécifiés immédiatement à gauche du point décimal 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 mettre en forme 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 caractère 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 le tableau suivant.

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

Les résultats de cet 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 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"