Formatage des dates, des heures, des nombres et autres

Les informations contenues dans cette page d’aide s’appliquent à la fois à CXone Studio et à Desktop Studio.

Cette page décrit les options de formatage valables pour les dates, les heures et les valeurs numériques dans Studio. Vous pouvez utiliser les options de formatage pour définir la manière 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 au format souhaité en utilisant la fonction datefmt() et les spécificateurs de format de date de cette page.

Des exemples de la plupart des spécificateurs de format de cette page sont disponibles dans l’exemple de script pour les fonctions. Vous pouvez télécharger et importer le script, puis ouvrir les actions datefmt et format Snippet.

Formats de la date et de l’heure

Utilisez les caractères de spécification de format lorsque vous devez spécifier le format dans lequel une actionFermé Exécute un processus au sein d’un script Studio, tel que la collecte de données client, l’écoute d’un message ou de musique, ou le routage d’un contact vers un agent. ou une fonction date/heure telle que datefmt() doit renvoyer une valeur de date ou d’heure. Il existe des caractères de spécification pour chaque partie d’une valeur 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 souhaitez que les valeurs date/heure apparaissent. Cette fonction est utile si votre organisation a des exigences concernant l’apparence des valeurs date/heure. Une fois que vous connaissez le format date/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 quelques 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 de spécification, tels que M, d, h, s, etc., représentent une partie de la valeur date/heure, comme le mois, le jour, l’heure, etc.

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

6/29/2022 3:15:45 PM

M/d/yy h :m:s tt

Sam 22 avril 2023  ddd MMM dd yyyy
Jeudi 15 juin 2023 dddd, MMMM dd yyyy

Studio prend en charge les heures au format 24 heures, mais pas au format 12 heures. Tenez-en compte lorsque vous travaillez avec le temps dans des scripts.

OLE Automation

Une date OLE Automation est une date écrite sous la forme d’un nombre à virgule flottante. Le côté gauche de la virgule est le nombre de jours depuis minuit le 30 décembre 1899. Le côté droit de la virgule est l’heure de ce jour divisée par 24. Par exemple, 6 h 00 le 31 décembre 1899 correspond à 1,25.

Les dates et heures OLE Automation sont utilisées à plusieurs endroits dans les scripts Studio. Certaines fonctions qui gèrent les dates et les heures utilisent ce format en entrée ou en sortie. De nombreux formats de date et d’heure décrits dans cette page d’aide utilisent les dates et heures OLE Automation.

Spécificateurs de formatage de la date et de l’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 le résultat. Par exemple, une lettre minuscule f donne un nombre de millisecondes qui inclut un zéro à droite le cas échéant. Une majuscule F supprime les zéros à droite. Dans un autre exemple, une minuscule m indique les minutes, mais une majuscule M indique le mois.
  • Le nombre de chaque caractère que vous incluez : L’inclusion d’un, deux ou plus spécificateurs de formatage modifie la sortie. Par exemple, l’utilisation d’un seul h pour l’heure fait que toutes les heures à un chiffre n’ont pas de zéro à gauche. Deux caractères hh donnent des heures à un chiffre avec des zéros à gauche.
  • Combinaison de caractères ou utilisation seule : Pour utiliser un caractère de spécification seul sans autres spécificateurs, vous devez le faire précéder du signe de pourcentage %. 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, vous n’avez pas besoin 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 de pourcentage.

Tous les caractères non spécifiques inclus dans la spécification du format date/heure sont transmis à la sortie et n’affectent pas la valeur date/heure. Vous pouvez l’utiliser pour séparer les parties de la valeur date/heure. Les deux points (:) et la barre oblique (/) sont traditionnellement utilisés pour séparer les parties d’une valeur date/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 souhaitez séparer la date et l’heure avec une barre verticale, vous pouvez l’inclure dans le format et elle sera 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() nécessite 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 compris entre 1 et 31 : 27.

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

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

dd

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.

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 de 1 à 12 : 11.

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

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

MM

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.

MMM Représente le nom abrégé du mois : Oct.
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 d’ordre le moins élevé apparaissent dans le résultat. Par exemple, pour l’année 2023, 23 apparaît.

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

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 d'ordre le moins élevé apparaissent dans le résultat. Par exemple, pour l’année 2023, 23 apparaît.

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

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

yyy

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

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

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

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 d’ordre le moins élevé apparaissent dans le résultat. Si l’année comporte moins de quatre chiffres, des zéros seront ajoutés en tête du nombre afin d’obtenir quatre chiffres.

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

yyyyy

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

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

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

Période ou ère g, gg (plus un nombre quelconque de spécificateurs g supplémentaires)

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

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

Heure (horloge 12 heures) h

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

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

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

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

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

hh

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

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

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

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

Heure (horloge 24 heures) H

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

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

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

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

HH

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

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

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

Minute m

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

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

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

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

mm

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

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

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

Deuxième s

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

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

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

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

ss

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

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

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

Fraction de seconde ff, F

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

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

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

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

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

AM/PM t

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

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

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

tt

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

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

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

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

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

Formats numériques

Utilisez ces caractères de spécification de format lorsque vous devez définir le format dans lequel une actionFermé Exécute un processus au sein d’un script Studio, tel que la collecte de données client, l’écoute d’un message ou de musique, ou le routage d’un contact vers un agent. ou une fonction telle que format() doit renvoyer une valeur numérique. Il existe des caractères de spécification pour de nombreux usages, tels que les devises, les pourcentages, les nombres en virgule fixe, etc.

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 permet de définir le nombre de chiffres après la virgule à inclure dans la sortie.

Un spécificateur de précision est un nombre que vous incluez après le spécificateur de format. Dans l’exemple suivant, C est le spécificateur de format et 3 est le spécificateur de précision. Il indique que la sortie aura trois chiffres après la virgule.

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

Avec un numéro de départ de 0013001.93912837, le résultat de cet exemple est $13,001.939.

Spécificateurs numériques

Type de numéro Spécificateur de format Description détaillée
Monnaie C ou c

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

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

Résultat :

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

Notation exponentielle (scientifique) E ou e

E0

E-0

e0

e+0

e-0

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

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

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

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

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

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

Résultat :

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

Point fixe F ou 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 débute par un signe moins si le nombre est négatif.

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

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

Résultat :

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

Général G ou g

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

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

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

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

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

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

Résultat :

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

Hexadécimal X ou x

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

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

Numéro N ou n

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

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

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

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

Résultat :

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

Pour cent P ou p

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

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

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

Résultat :

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

Aller-retour R ou r

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

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

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

Résultat :

ROUNDTRIPRESULT=13001.93912837

Espace réservé pour zéro 0

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

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

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

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

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

Les résultats de l’exemple sont

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Espace réservé pour chiffre #

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

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

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

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

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

Les résultats de l’exemple sont

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

Séparateur décimal .

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

Séparateur des milliers et mise à l’échelle des nombres ,

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

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

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

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

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 seule chaîne. Chaque option est séparée par un point-virgule (;). Utilisez les espaces réservés pour zéro, chiffre, milliers et décimale pour définir le formatage, comme indiqué dans les exemples ci-dessous. Ces espaces réservés sont décrits dans ce tableau.

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

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

Par exemple :

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

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

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

Les résultats de l’exemple sont

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

S’il y a trois sections :

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

Par exemple :

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

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

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

Les résultats de l’exemple sont

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Tous les autres caractères Autre

Tous les autres caractères

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

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 les chaînes. Si vous incluez ces caractères dans des chaînes sans séquence d’échappement, le résultat ne sera pas celui que vous attendez et une erreur risque de survenir.

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.

Préfixez toute chaîne dans laquelle vous utilisez une séquence d’échappement par un signe de dollar ($) : $"...". À l’intérieur des guillemets, vous pouvez utiliser l’une des séquences d’échappement suivantes :

Séquence Détails
\" Intégrez un double devis.
\' Intégrez un devis unique.
\t Intégrez une tabulation (ASCII 9).
\r Intégrez un retour chariot (ASCII 13).
\n Intégrez un saut de ligne (ASCII 10).
\b Intégrez un retour arrière (ASCII 8).
\{ Intégrez une accolade ouverte. Vous ne devez échapper l’accolade fermante que si le texte qui la précède ne contient pas d’accolade ouverte échappée. Si vous devez échapper à une accolade fermante, cela ressemble à ceci : \}
\0 Intégrez une valeur nulle (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 :

A phrase

And a new line ]

Dans l’exemple précédent, l’accolade fermante 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, cela ressemble à ceci : Embedding "double quotes" in a string. Sans la séquence d’échappement, le script ne reconnaîtrait la chaîne que jusqu’au symbole de guillemets doubles 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, cela ressemble à ceci :  Using {curly} braces. Sans la séquence d’échappement, le script aurait interprété {curly} comme une variable. Si aucune valeur n’est trouvée pour l’accolade de variable, le script la remplacera par rien, de sorte que la valeur de la variable sera Using braces..

Autres caractères

Caractère Description
" Représente une chaîne entre guillemets (guillemet double). 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 (guillemet simple/apostrophe). Affiche la valeur littérale de toute chaîne entre deux guillemets simples (’). Utilisez le caractère d’échappement (\) partout dans votre script où vous devez afficher un caractère apostrophe littéral.
$

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

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

#

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

ASSIGN var = #"02/09/2023"

% À utiliser avec les spécificateurs de formatage date/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.