Date, heure, nombre et autres mises en forme

Les informations sur cette page d’aide concernent à la fois Studio et Desktop Studio.

Cette page décrit les options de formatage valides pour les dates, les heures et les valeurs numériques dans Studio. Vous pouvez utiliser les options de formatage pour définir la façon dont vous souhaitez que certaines informations soient formatées dans la sortie de votre script. Par exemple, si votre organisation souhaite que les dates soient affichées d'une certaine manière, vous pouvez convertir les dates de leur format existant vers le format souhaité à l'aide de la fonction datefmt() et des spécificateurs de format de date de cette page.

Des exemples de nombreux spécificateurs de format de cette page sont disponibles dans le script d'exemple pour les fonctions. Vous pouvez télécharger et importer le script, puis ouvrir les actions datefmt et format Extrait.

Formats de date et d'heure

Utilisez des caractères de spécificateur de format lorsque vous devez préciser le format dans lequel vous souhaitez qu'une actionClosed Performs a process within a Studio script, such as collecting customer data or playing music. ou une fonction de date/heure, telle que datefmt(), renvoie une valeur de date ou d'heure. Il existe des caractères de spécification pour chaque partie d'une valeur de date/heure, comme le jour, le mois, l'année, l'heure, la minute, etc.

En combinant des caractères de spécification avec des caractères de séparation, vous pouvez définir la manière dont vous voulez que les valeurs de date et d'heure apparaissent. Cette fonction est utile si votre organisation a des exigences concernant l'apparence des valeurs de date et d'heure. une fois que vous connaissez le format de date et d'heure dont vous avez besoin, utilisez les spécificateurs de format définis dans cette section pour construire le format dans votre script.

Le tableau suivant présente des exemples de dates et d'heures avec leurs formats correspondants. La colonne Format avec spécificateurs montre comment utiliser les spécificateurs de format pour construire chaque exemple de date/heure dans la colonne Style de date. Les caractères spécificateurs, tels que M, d, h, s, etc., représentent une partie de la valeur de date/heure telle que le mois, le jour, l'heure, etc.

Style de date Format avec spécificateurs
04/04/2022 04:29:12 MM/dd/aaaa hh:mm:ss tt

6/29/2022 3:15:45 PM

M/d/yy h :m:s tt

Sam Avr. 22 2023 ddd MMM dd yyyy
Jeudi, 15 Juin 2023 dddd, MMMM dd yyyy

Studio prend en charge le format 24 heures, et non le format 12 heures. Tenez-en compte lorsque vous définissez les heures dans les scripts.

Automatisation OLE

Un OLE Automation Date Icône d'un carré avec un point de flèche du centre à travers le coin supérieur droit. est une date écrite sous forme de nombre à virgule flottante. La partie située à gauche du point correspond au nombre de jours écoulés depuis minuit, le 30 Décembre 1899. La partie droite du point décimal correspond au temps de ce jour divisé par 24. Par exemple, 6 h 00 le 31 Décembre 1899 correspond à 1,25.

Les dates-heures d'automatisation OLE sont utilisées à divers endroits dans les scripts Studio. Certaines fonctions qui gèrent les dates et les heures utilisent ce format en tant que saisie ou sortie. De nombreux formats de date et d'heure décrits dans cette page d'aide utilisent les dates et heures d'automatisation OLE.

Spécificateurs de format de date et d'heure

Lors de l'utilisation de spécificateurs de formatage de la date et de l'heure, les éléments suivants sont importants :

  • Majuscules et minuscules : la casse du spécificateur modifie la sortie. Par exemple, un f minuscule donne un nombre de millisecondes qui comprend un zéro final, le cas échéant. Un F majuscule supprime les zéros finaux. Dans un autre exemple, un m minuscule affiche les minutes, mais un M majuscule affiche le mois.
  • Le nombre de chaque caractère que vous incluez : l'inclusion d'un, de deux ou de plusieurs caractères d'un spécificateur de format modifie la sortie. Par exemple, l'utilisation d'un seul h pour l'heure a pour résultat que toutes les heures à un seul chiffre n'ont pas de zéro initial. Deux caractères hh ont pour résultat que les heures à un seul chiffre comportent des zéros initiaux.
  • Combinaison des caractères ou utilisation seule : pour utiliser un seul caractère spécificateur seul, sans autres spécificateurs, vous devez le préfixer avec un signe pour cent %. Par exemple, pour afficher uniquement les minutes, vous devez utiliser %m. Si vous n'incluez pas le signe de pourcentage, le formatage ne fonctionnera pas. Si vous utilisez un spécificateur unique en combinaison avec d'autres spécificateurs, il n'est pas nécessaire d'inclure le signe de pourcentage. Par exemple, si votre format comprend les heures et un seul m, comme dans hh:m, vous n'avez pas besoin du signe pourcentage.

Tout caractère non spécificateur inclus dans la spécification du format de date/heure est transmis dans la sortie et n'affecte pas la valeur de date/heure. Vous pouvez l'utiliser pour séparer les parties de la valeur de la date ou de l'heure. Les deux points ( : ) et la barre oblique ( / ) sont traditionnellement utilisés pour séparer les parties d'une valeur de date ou d'heure. Vous pouvez utiliser n'importe quel séparateur dans les formats que vous spécifiez, y compris des caractères non traditionnels tels que le tiret ( - ).

Par exemple, si vous souhaitiez séparer la date et l'heure par une barre verticale, vous pourriez l'inclure dans le format et elle serait ajoutée à la sortie. Les deux points et la barre oblique peuvent être nécessaires selon la fonction utilisée. Par exemple, la fonction asdatetime() requiert ces caractères.

Pour représenter Spécificateur de format Détails
Jour d

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.

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

jj

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.

ddd Représente le nom abrégé du jour de la semaine : Jeu.
dddd Représente le nom complet du jour de la semaine : Jeudi.
Mois M

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 %.

MM

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.

MMM Représente le nom abrégé du mois : Octobre.
MMMM Représente le nom complet du mois : Octobre.
Année y

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.

yy

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 %.

yyy

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.

yyyy

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.

yyyyy

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 non significatifs 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.

Période ou ère g, gg (plus n'importe quel nombre de spécificateurs g supplémentaires)

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 sortir uniquement le nom de l'ère ou de la période, utilisez un double gg.

Heure (12 heures) h

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 % devant.

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

hh

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.

Heure (24 heures) H

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

HH

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.

Minute m

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 %.

mm

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.

Deuxième s

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 %.

ss

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.

Fraction de Secondes ff, F

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 majuscule omettent les zéros de fin.

Ce spécificateur ne fonctionne qu'avec les dates/heures d’automatisation OLEClosed A way to write dates as a floating point integer. Indicates the number of days since December 30, 1899..

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

  • F : dixièmes de seconde, ou le chiffre le plus significatif. Si le chiffre est un zéro, rien n'est affiché.
  • ff ou FF : centièmes de seconde, soit 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, soit quatre chiffres significatifs.
  • fffff ou FFFFF : Cent millièmes de seconde, ou cinq chiffres significatifs.
  • ffffff ou FFFFFF : millionièmes 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 temporelle dépend de la résolution de l'horloge système de l'ordinateur.

AM/PM t

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 où le second caractère change, utilisez le spécificateur tt.

Si utilisé seul, ajoutez le préfixe %.

tt

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.

Décalage local par rapport à UTC z

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.
  • : Mesure le décalage en heures et minutes.

Le décalage s'affiche toujours avec un signe en tête. Un signe plus (+) indique les heures d'avance et un signe moins (-) indique les heures de retard par rapport à UTC. Le décalage va de –12 à +13. Un décalage à un seul chiffre est formaté avec un zéro en tête.

En cas d'utilisation seule, faites précéder de %.

Formats numérique

Utilisez ces caractères de spécificateur de format lorsque vous devez définir le format dans lequel vous souhaitez qu'une actionClosed Performs a process within a Studio script, such as collecting customer data or playing music. ou une fonction, telle que format(), renvoie une valeur numérique. Il existe des caractères de spécificateur pour de nombreux usages, tels que la monnaie, les pourcentages, les nombres à virgule fixe, et plus encore.

Spécificateur de précision

De nombreux spécificateurs de format décrits dans cette section acceptent un spécificateur de précision. Le spécificateur de précision vous permet de définir le nombre de chiffres après la virgule décimale à inclure dans la sortie.

Un spécificateur de précision est un nombre que vous incluez après le spécificateur de format. Dans cet exemple, C est le spécificateur de format et 3 est le spécificateur de précision.Cela indique que la sortie comportera trois chiffres après le point décimal.

ASSIGN CurrencyResultBigC = "{StringVal.format('C3')}"

Pour un nombre de départ égal à 0013001.93912837, la sortie de cet exemple est $13,001.939.

Spécificateurs numérique

Type de numéro Spécificateur de format Détails Description
Monnaie C ou c

La valeur numérique est convertie en chaîne qui représente un montant en 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

Notation exponentielle (scientifique) E or e

E0

E-0

e0

e+0

e-0

La valeur numérique est convertie 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 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 utilisant la 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 à 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 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

Point fixe F or f

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

Général \n G ou g

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 ou non. 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 à l'indicateur 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

Hexadécimal X ou x

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 sur sa gauche afin d'obtenir le nombre de chiffres indiqué par le spécificateur de précision.

Numéro N ou n

Le nombre est converti en une chaîne au format -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 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

Pour cent P ou p

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%

Aller-retour R ou r

Ce format est pris en charge uniquement pour les types Simple et Double. Le spécificateur de conversion bidirectionnelle garantit qu'une valeur numérique convertie en chaîne sera réanalysée pour obtenir 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 correctement reconvertie en 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 reconvertie avec succès en la même valeur numérique, elle est alors formatée en utilisant 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 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

Espace réservé zéro 0

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 à mettre 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 nombre n'apparaît à la position où un 0 figure dans la chaîne de format, 0 apparaît alors dans la chaîne de sortie à sa 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 entraîne l'arrondi de la valeur au nombre entier le plus proche (arrondi).

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

Espace réservé pour chiffres #

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 mise en forme comporte un chiffre à la position où figure un # dans la chaîne de format, ce chiffre apparaît dans le résultat de sortie. Si aucun chiffre ne figure à la position où apparaît un # dans la chaîne de format, cet emplacement reste 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 de la chaîne à mettre en forme.

La chaîne de format ## entraîne l'arrondi de 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 cet exemple sont :

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

Point décimal .

Le premier point ( . ) caractère 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é.

Séparateur de milliers et mise à l'échelle des numéros ,

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 formatent les chiffres de la partie entière d'un nombre, un caractère séparateur de groupe est inséré entre chaque groupe de chiffres dans la partie entière 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 d'échelle de nombre : 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 1 000 pour chaque spécificateur d'échelle de nombre. 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.

Séparateur de Section ;

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 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 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 Autre

Tous les autres caractères

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

Séquences d'échappement

Studio prend en charge les séquences d'échappement dans les constantes de chaîne. Les séquences d'échappement permettent d'inclure certains caractères spéciaux dans une chaîne. Les Caractères tels que les guillemets doubles ou une accolade ouvrante sont reconnus comme du code. Lorsqu'ils sont inclus dans une chaîne, le compilateur les interprète avec la signification non littérale du code au lieu de leur valeur littérale. Les séquences d'échappement permettent d'inclure ces caractères dans des chaînes.Si vous incluez ces caractères dans des chaînes sans séquence d'échappement, la sortie ne correspondra pas à ce que vous attendez, et une erreur peut en résulter.

Il n'est pas nécessaire d'ajouter des séquences d'échappement aux chaînes qui contiennent du XML ou du JSON converti. Les séquences d'échappement sont automatiquement ajoutées pour les caractères qui le nécessitent.

Prefix any string where you use an escape sequence with a dollar sign ($): $"...". Within the double quotes, you can use any of the following escape sequences:

Séquence Détails
\" Intégrez un guillemet double.
\' Intégrez une citation unique.
\t Permet d'intégrer une tabulation (ASCII 9).
\r Permet d'intégrer un retour chariot (ASCII 13).
\n Permet d'intégrer un saut de ligne (ASCII 10).
\b Permet d'intégrer un retour arrière (ASCII 8).
\{ Intégrez une accolade ouverte. Vous ne devez utiliser une séquence d’échappement devant l'accolade fermante que si le texte qui la précède ne contient pas d'accolade ouverte avec séquence d’échappement. Si vous devez échapper une accolade fermante, cela ressemble à ceci : \}
\0 Intégrez un null (0 est un zéro).

L'exemple suivant utilise la séquence d'échappement \n pour ajouter un saut de ligne à la chaîne. Cela permet de déplacer le curseur vers la ligne suivante sans revenir au début de la ligne.

x = $"A phrase\nAnd a new line" 

Lorsque la chaîne est imprimée, la sortie ressemble à ceci :

phrase

Et une nouvelle ligne ]

Dans l'exemple précédent, le crochet fermant représente le curseur.

L'exemple suivant utilise la séquence d'échappement \" pour inclure des guillemets doubles dans la chaîne :

y = $"Embedding \"double quotes\" in a string."

Lorsque la chaîne est imprimée, elle ressemble à ceci : intégration de « guillemets doubles » dans une chaîne. Sans la séquence d'échappement, le script ne reconnaîtrait la chaîne que jusqu'au symbole de guillemet double précédant le mot double.

L'exemple suivant utilise la séquence d'échappement \{ pour inclure des accolades littérales dans la chaîne :

z = $"Using \{curly} braces."

Lorsque la chaîne est imprimée, elle ressemble à ceci : utilisation des accolades {curly}. Sans la séquence d'échappement, le script aurait interprété {curly} comme une variable. Si aucune valeur n'est trouvée pour la variable curly, le script la remplacerait par rien, de sorte que la valeur de la variable serait utilisation des accolades.

Autres Caractères

Caractère Description
" Représente une chaîne entre guillemets (guillemet). Affiche la valeur littérale de toute chaîne entre deux guillemets ("). Utilisez le caractère d'échappement (\) partout dans votre script où vous devez afficher un guillemet littéral.
' Représente une chaîne entre guillemets (apostrophe). Affiche la valeur littérale de toute chaîne entre deux apostrophes ('). Utilisez le caractère d'échappement (\) partout dans votre script où vous devez afficher un caractère apostrophe littéral.
$

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"

% S’utilise avec les spécificateurs de formatage de la date et de l'heure lors de l'utilisation d'un spécificateur unique. Le caractère % précède directement le caractère de spécification de formatage. Par exemple, pour afficher uniquement les minutes, utilisez %m.