Altova MapForce 2025 Enterprise Edition

Convertit une valeur de type xs:dateTime en un string. La représentation string de date et time est formattée conformément à la valeur de l’argument format.

Langages

Built-in, C++, C#, Java, XSLT 2.0, XSLT 3.0.

Paramètres

Formatage

L’argument format consiste en un string contenant de soit-disant marqueurs de variable contenus dans des crochets, par exemple [Y]/[M]/[D]. Les caractères se trouvant en dehors des crochets sont des caractères littéraux. Si les crochets sont nécessaires en tant que caractères littéraux dans le résultat, alors ils devraient être doublés.

Chaque marqueur de variable consiste en les parties suivantes :

•un spécificateur identifiant quelle partie du type de données doit être affiché (par ex., date ou heure),

•un modificateur de formatage optionnel,

•un modificateur de présentation optionnel, et

•un modificateur de largeur optionnel, qui doit être précédé par une virgule s’il est présent.

Spécificateurs

Les spécificateurs disponibles sont décrits dans la table ci-dessous.

Modificateurs de formatage

Le modificateur de formatage peut être un des suivants :

Important

Les modificateurs N, n, et Nn sont pris en charge par les spécificateurs suivants : M, F et P. Les modificateurs N, n, et Nn sont également pris en charge par le spécificateur z mais uniquement dans Built-In et la génération de code (éditions Professional et Enterprise).

Si vous avez besoin d’un modificateur de largeur, mettez une virgule avant celui-ci. Le modificateur de largeur est un chiffre qui exprime la largeur minimum. En option, vous pouvez ajouter un tiret et un chiffre qui expriment la largeur maximale. Par exemple :

•[D,2] est la date du mois, avec des zéros leader (deux chiffres).

•[MNn,3-3] est le nom du mois, écrit comme trois caractères, par ex., Jan, Fév, Mar, etc.

Exemples

La table ci-dessous illustre quelques exemples de valeurs de formatage xs:dateTime avec l’aide de la fonction format-dateTime. La colonne Value spécifie la valeur fournie dans l’argument value. La colonne Format spécifie la valeur de l’argument format. La colonne Result affiche ce qui est retourné par la fonction.