Fonction de format de chaîne de date

La fonction Format de chaîne de date convertit le type de données de schéma XML xs:dateTime en une chaîne au format défini par le deuxième paramètre.

Paramètre : dateTime

Date et heure dans un type de données de schéma XML xs:dateTime.

Paramètre : chaîne

Cette chaîne définit le format de date et d'heure renvoyé par cette fonction. Par exemple, la chaîne de format peut être égale à MM/dd/yyyy. Pour plus d'informations sur les chaînes de métacaractères de date et d'heure prises en charge, voir la classe SimpleDataFormat dans le document Java Sun J2SE 1.4.2 : http://www.science.uva.nl/ict/ossdocs/java/jdk1.3/docs/api/java/text/SimpleDateFormat.html.
Lettre du masque Description Exemple1 Exemple2
G Désignation de l'ère AD BC
y Année 2004 2001
M Mois de l'année Avril 04
w Semaine de l'année 12 24
W Semaine du mois 3 1
D Jour de l'année 234 333
d Jour du mois 13 20
F Jour de semaine dans un mois 1 3
E Jour de la semaine Lundi Vendredi
a Désignation AM ou PM AM PM
H Heure du jour - nombre compris entre 0 et 23 12 13
k Heure du jour - nombre compris entre 1 et 24 14 23
K Heure au format AM ou PM — nombre compris entre 0 et 11 0 10
h Heure au format AM ou PM — nombre compris entre 1 et 12 11 12
m Minute d'une heure 20 50
s Seconde d'une minute 10 30
S Millisecondes 224 338
z Fuseau horaire au format général de fuseau horaire PDT EDT
Z Fuseau horaire au format de fuseau horaire ISO-8601 -03:00 +02:00
Paramètre : chaîne  (facultatif)

Cette chaîne définit l'environnement local. Par exemple, l'environnement local États-Unis est défini avec la chaîne suivante : en_US.

L'environnement local peut être défini par l'un des formats suivants :

  • LANGUE
  • LANGUE_PAYS
  • LANGUE_PAYS_VARIANTE
Où LANGUE représente un code à deux lettres défini par la norme ISO-639, PAYS, un code à deux lettres défini par la norme ISO-3166 et VARIANTE, un code spécifique d'un fournisseur ou d'un navigateur, par exemple, WIN pour Windows.

Ce paramètre est facultatif.

Pour ajouter ce paramètre :
  1. Faites glisser la fonction de format de chaîne de date dans le panneau central de l'éditeur de mappage.
  2. Cliquez deux fois sur la fonction. Le panneau des propriétés de la fonction s'ouvre.
  3. Cliquez sur Ajouter. Le paramètre d'entrée Locale apparaît dans la liste des paramètres.

Renvoie : chaîne

Date et heure transmises en tant que chaîne au format défini par le deuxième paramètre.

Par exemple, si la fonction de format de chaîne a été appelée avec les paramètres d'entrée suivants :

dateTime: 2005-02-22T16:18:00.852-08:00

chaîne de format : MM/dd/yyyy

chaîne d'environnement local : en_US

La chaîne suivante est renvoyée : 02/22/2005.