TEXT

Renvoie la valeur sous forme de texte

Utilisation

TEXT(valeur, [format])

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

Exemple Avec ces variables Résultat

TEXT(123)

(Aucune)

“123”

TEXT(“123”)

(Aucune)

“123”

TEXT(valeur)

valeur est 9.99

“9.99”

TEXT(valeur)

valeur est DATE(2021, 2, 3)

“2021-02-03”

TEXT(valeur, “dd/mm/yyyy”)

valeur est DATE(2021, 2, 3)

“03/02/2021”

TEXT(valeur, “dddd, d mmmm, yyyy”)

valeur est DATE(2024, 2, 6)

“mardi, 6 février, 2024”

TEXT(val, “#!.####”)

val est 12.345

“12.345”

TEXT(val, “#!,###”)

val est -12.345

“-12,345”

TEXT(val, “#!,###;(#!,###)”)

val est 12.3456

“12,346”

TEXT(val, “#!,###;(#!,###)”)

val est -12.345

“(12,345)”

TEXT(val, “#!.###;(#!.###);ZERO!”)

val est 0

“ZERO”

TEXT(val, “### ###!.##”)

val est 1234567890.345

“1 234 567 890.35”

TEXT(val, “#!.00”)

val est 4.5

“4.50”

TEXT(val, “???!.00”)

val est 4.357

” 4.36”

TEXT(valeur, “### ###!.##”)

valeur est 5

“5”

TEXT(valeur, “###.###!,###”)

valeur est 43023.1

“43.023,1”

TEXT(valeur, “###’###!,##”)

valeur est 43023.555

“43’023,56”

TEXT(valeur, “000 000!.0000”)

valeur est 25.66

“000 025.6600”

TEXT(valeur, “????!.???”)

valeur est 25.66

” 25.66 “

TEXT(valeur)

valeur est NOTHING

””

TEXT(valeur)

valeur est TRUE

“TRUE”

TEXT(valeur)

valeur est FALSE

“FALSE”

TEXT(valeur)

valeur est [1, 2]

“1, 2”

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 disponible
  • 0 é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”.

Voir aussi