Fonction FORMATEX

Retourne le résultat de l’expression évaluée dans srcUnit sous la forme d’une chaîne mise en forme selon le format exprimé en dstUnit.

Syntaxe

FORMATEX(expression, » format « ,[ srcUnit ],[ dstUnit ],[ langID ][, calID ])

Paramètres

Nom	Requis/Facultatif	Type de données	Description
expression	Obligatoire	String	Combinaison de constantes, d’opérateurs, de fonctions et de références à des cellules ShapeSheet constituant une valeur.
format	Obligatoire	String	Image de format utilisée pour mettre en forme la chaîne. Pour plus d’informations sur la mise en forme des images, consultez À propos des images de mise en forme.
srcUnit	Facultatif	String	Unités utilisées pour calculer expression (po, cm, etc.).
dstUnit	Facultatif	String	Unités à utiliser pour le résultat d’expression (po, cm, etc.).
langID	Facultatif	Number	Langue utilisée lors de la mise en forme des dates/heures de Microsoft Office System.
calID	Facultatif	Number	Calendrier utilisé lors de la mise en forme des dates/heures de Microsoft Office System.

Valeur renvoyée

String

Remarques

Le type de l’expression et celui indiqué dans le modèle de format régissent le comportement de la chaîne renvoyée. L’argument format doit convenir au type de l’expression.

L’argument srcUnit est utilisé pour mettre à l’échelle des résultats d’expressions non typées, telles que 3 + 4. Si le résultat d’expression est associé à un type précis, comme 3 m + 8 m, l’argument srcUnit est ignoré.

L’argument dstUnit est utilisé pour définir les unités employées dans le résultat mis en forme. Si dstUnit n’est pas précisé, les unités du résultat de l’expression sont utilisées.

Renvoie une erreur si le résultat d’expression et le type attendu dans format ne sont pas de même nature, si des erreurs de syntaxe se sont glissées dans format ou si les unités transmises dans les arguments srcUnit ou dstUnit ne sont pas reconnues.

Exemple

FORMATEX(5,5, "0,00 u", "cm", "m")

Renvoie 0,06 mètre.