TEXT
Renvoie la valeur sous forme de texte
Utilisation
Paramètres
valeur |
(Requis) La valeur à transformer en texte |
format |
Si la valeur est une date ou un nombre, ceci est le format d’affichage à utiliser. Voir “Plus d’information” pour plus de détails. |
Exemples
Plus d'information
Si on donne un texte, il est retourné tel quel.
Formater une date
Si valeur
est une date, alors un format peut être spécifié en donnant une seconde valeur. ce format est un texte qui contient des instructions
indiquant comment écrire la date. Par exemple, "(yyyy)--mm//dd"
écrirait une date comme (2024)--02//23
.
Le tableau suivant liste les instructions possibles et leurs résultats finaux :
instruction | résultat |
yy | Numéro de l’année, seulement les 2 derniers chiffres (00..99) |
yyyy | Numéro de l’année complet |
m | Numéro du mois sans zéro initial (1..12) |
mm | Numéro du mois avec zéro initial (01..12) |
mmm | Nom* du mois abrégé |
mmmm | Nom* du mois |
d | Jour du mois sans zéro initial (1..31) |
dd | Jour du mois avec zéro initial (01..31) |
ddd | Nom* du jour de la semaine abrégé |
dddd | Nom* du jour de la semaine |
Note importante : Pour les instructions donnant un nom (identifiées par *
), DocuMold doit connaître la langue du document.
Voir la documentation de l’action @LANGUAGE
pour plus de détails.
Pour indiquer un format, il suffit de remplacer les instructions par d’autres caractères pour correspondre à ce que vous voulez recevoir.
Voici des exemples, en supposant que @LANGUAGE
est réglé sur anglais.
instruction | exemple |
"yyyy-mm-dd" |
2024-02-07 |
"mm-dd-yyyy" |
02-07-2024 |
"mmmm d, yyyy" |
février 7, 2024 |
"dddd, d mmmm, yyyy" |
mercredi, 7 février, 2024 |
"dd-mm-yyyy" |
07-02-2024 |
"d mmmm yyyy" |
7 février 2024 |
Tout caractère autre que “y”, “m” et “d” peut être utilisé tel quel dans le résultat. Si vous voulez écrire un “y”, “m” et “d” dans
votre format et l’avoir affiché comme la lettre elle-même, préfixez chaque lettre avec un antislash (\
), ex : “wh\y”.
Formater un nombre
Si valeur
est un nombre, alors un format peut être spécifié en donnant une seconde valeur. Ce format est un texte qui contient
des instructions indiquant comment écrire le nombre. Par exemple, "### ###!,##"
écrirait le nombre 12345.6789
ainsi: 12 345,68
.
Voici les instruction possibles dans les formats de nombre :
#
écrit un chiffre significatif, ou est retiré s’il n’y a pas de tel chiffre disponible0
écrit un chiffre significatif, ou un 0 s’il n’y a pas de tel chiffre disponible?
écrit un chiffre significatif, ou un espace s’il n’y a pas de tel chiffre disponible (utile pour l’alignement lors de l’utilisation d’une police à taille fixe)!
indique l’emplacement du séparateur décimal, inscrivez le séprateur désiré après celui-ci. Ex:!,
pour utiliser une virgule. Le point d’exclamation sera omis du résultat.;
sépare le format en jusqu’à trois sections pour différents cas. La valeur du nombre déterminera quelle section est utilisée :- nombre positif : première section
- nombre négatif : deuxième section (si elle est absente, la première section sera utilisée avec un signe moins (
-
) en préfixe) - zéro : troisième section (si elle est absente, la première section sera utilisée)
Le point d’exclamation (!
) est nécessaire car différentes langues/pays/contextes utilisent différents symboles pour séparer les décimales
(généralement un point ou une virgule) et séparer les groupes de chiffres (parfois des espaces, des points, autres). Pour éviter les erreurs, s’il n’y a
pas de point d’exclamation (!
) dans le format, il y aura une erreur. Si vous n’avez pas besoin de décimales dans votre nombre, placez le
point d’exclamation (!
) à la fin du format : "### ###!"
.
Tout autre caractère entre les #
, 0
, ?
et !
du format est traité comme un séparateur de groupe. Ces séparateurs sont seulement conservés s’ils
sont entre le point d’exclamation (!
) et une instruction de chiffre qui n’a pas été retirée.
Les charactères qui ne sont pas entre des instructions sont gardés tel quel.
Donc TEXT(1234, "##'##_##! $")
résulte en 12_34 $
.
Ce que l’on entend par un chiffre significatif :
- “10” et “000010” sont le même nombre. Les zéros supplémentaires (à gauche) ne sont pas nécessaires, ils ne sont pas significatifs.
- “5.0200” et “5.02” sont le même nombre. Les zéros (à droite) ne sont pas nécessaires, ils ne sont pas significatifs.
Les instructions indiquant des chiffres, tels que le dièse (#
), sont remplacés par un chiffre provenant du nombre. L’ordre dans lequel cela se produit est centré sur
le point d’exclamation (!
), les instructions les plus proches de celui-ci sont remplacés en premier. Donc pour "###!.###"
, si vous avez 12.34
, alors
l’étape par étape est :
###!.###
##2!.3##
#12!.34#
12!.34
S’il n’y a pas assez d’instructions pour les chiffres à gauche du format (partie entière trop large), alors le format sera
étendu en dupliquant le dernier groupe d’instructions. Donc 11223344556
avec le format "### ###!.#"
donne 11 223 344 556
.
S’il n’y a pas assez d’instructions pour les chiffres à droite du format (trop de décimales), alors le nombre sera arrondi au nombre
de chiffres disponibles en utilisant la règle commune (voir la fonction ROUND
).
Si vous souhaitez écrire un des caractères d’instruction, tels qu’un dièse (#
), dans votre format et l’afficher directement (au lieu d’être transformé),
préfixez chaque caractère avec un antislash (\
), ex : “# #” donnerait “# 123”.