Altova MapForce 2024 Enterprise Edition

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

mf-func-format-dateTime

 

Langages

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

 

Paramètres

Argument

Description

value

La valeur xs:dateTime à formater.

format

Un string de format identifiant la manière avec laquelle value doit être formatée. Voir "Remarques" ci-dessous.

language

Argument optionnel. Lorsqu’il est fourni, le nom du mois est le jour de la semaine sont retournés dans un langage spécifique. Valeurs valides :

 

de

Allemand

en (défaut)

Anglais

es

Espagnol

fr

Français

ja

Japonais

 

Note :Si la sortie de la fonction (résultat) est connectée à un item de type différent d’un string, le formatage peut être perdu lorsque la valeur est amenée vers le type de cible. Pour désactiver ce cast automatique, supprimer les cases à cocher Valeurs cibles cast vers les types de cible dans les Paramètres de composant du composant cible.

 

Remarques

L’argument format consiste en un string contenant de soit-disant marqueurs de variable contenue 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 un spécificateur de composant identifiant lequel des composants de date ou time doit être affiché, un modificateur de formatage optionnel, un autre modificateur de présentation optionnel et un modificateur de largeur optionnel, précédé par une virgule si elle est présente.

 

format := (literal | argument)*

argument := [component(format)?(presentation)?(width)?]

width := , min-width ("-" max-width)?

 

Les composants sont les suivants :

 

Spécificateur

echo Hello, World!

Présentation par défaut

Y

année (valeur absolue)

quatre chiffres (2010)

M

mois de l’année

1-12

J

jour du mois

1-31

d

jour de l'année

1-366

F

jour de la semaine

nom du jour (dépendant du langage)

W

semaine de l’année

1-53

w

semaine du mois

1-5

H

heure (24 heures)

0-23

h

heure (12 heures)

1-12

P

A.M. ou P.M.

alphabétique (selon le langage)

m

minutes dans l’heure

00-59

s

secondes dans la minute

00-59

f

secondes fractionnelles

numérique, une place décimale

Z

fuseau horaire en tant qu’offset d’heure depuis UTC

+08:00

z

fuseau horaire en tant qu’offset d’heure en utilisant GMT

GMT+n

 

Le modificateur de format peut être un des suivants :

 

Caractère

echo Hello, World!

Exemple

1

Format numérique décimal sans zéros au début

1, 2, 3

01

Format numérique, deux chiffres

01, 02, 03

N

Nom du composant , casse majuscule1

MONDAY, TUESDAY

n

Nom du composant, casse minuscule1

monday, tuesday

Nn

Nom du composant, casse de titre1

Monday, Tuesday

 

Notes de bas de page :

 

1. Les modificateurs N, n et Nn sont pris en charge par les composants suivants uniquement : M, d, D.

 

Le modificateur de largeur, si nécessaire, est introduit par une virgule, suivi par un chiffre qui exprime la largeur minimum. En option, vous pouvez ajouter une barre oblique suivie par un autre chiffre qui exprime la largeur maximum. Par exemple :

 

[D,2] est le jour du mois, avec des zéros en début de ligne (deux chiffres).

[MNn,3-3] est le nom du mois, écrit avec trois lettres, par ex. Jan, Feb, 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 à l’argument value. La colonne "Format" spécifie la valeur de l’argument format. La colonne "Result" illustre ce qui est retourné par la fonction.

 

Valeur

Format

Résultat

2003-11-03T00:00:00

[D]/[M]/[Y]

11/03/2003

2003-11-03T00:00:00

[Y]-[M,2]-[D,2]

03/11/2003

2003-11-03T00:00:00

[Y]-[M,2]-[D,2] [H,2]:[m]:[s]

2003-11-03 00:00:00

2010-06-02T08:02

[Y] [MNn] [D01] [F,3-3] [d] [H]:[m]:[s].[f]

2010 June 02 Wed 153 8:02:12.054

2010-06-02T08:02

[Y] [MNn] [D01] [F,3-3] [d] [H]:[m]:[s].[f] [z]

2010 June 02 Wed 153 8:02:12.054 GMT+02:00

2010-06-02T08:02

[Y] [MNn] [D1] [F] [H]:[m]:[s].[f] [Z]

2010 June 2 Wednesday 8:02:12.054 +02:00

2010-06-02T08:02

[Y] [MNn] [D] [F,3-3] [H01]:[m]:[s]

2010 June 2 Wed 08:02:12

© 2018-2024 Altova GmbH