IBM FileNet P8, Version 5.2.1            

Masques de date/heure

Un masque de date/heure peut répondre à l'une ou l'autre de deux finalités : il détermine le format de la sortie de différentes fonctions, ou détermine la conversion entre la représentation de chaîne d'une valeur et la forme interne de cette valeur.

Un masque de date/heure peut être utilisé de deux manières :

  • Le masque détermine le format du résultat de diverses fonctions. Par exemple, dans la fonction timetostring, le masque de date/heure indique le format à utiliser pour la chaîne de résultat. Si le masque de date/heure est "hh:tt:ss" et que la valeur temporelle équivaut à 09h12 et 24 secondes, la chaîne de résultat est 09:12:24.
  • Le masque détermine la conversion entre la représentation de chaîne d'une valeur et la forme interne de cette valeur. Par exemple, dans la fonction stringtotime, le masque de date/heure indique le format de la chaîne de résultat pour la convertir en valeur temporelle. Si la chaîne d'entrée est "05/06/1995", le masque de date/heure "mm/dd/yyyy" indique que la sous-chaîne "05" représente le mois et non le jour.

Un masque de date/heure est une expression de chaîne qui contient une combinaison valide de composants et, le cas échéant, de séparateurs. Le masque de date/heure étant une chaîne, vous devez l'encadrer entre des doubles guillemets.

Pour obtenir des exemples d'utilisation, voir les informations sur les modèles de date/heure.

Composants

Les composants admis dans un masque de date/heure sont les suivants : (L'intervalle de valeurs admises pour chaque composant est fourni le cas échéant).

Tableau 1. Tableau des composants de masque de date/heure
Composant Signification
dd Deux chiffres correspondant au jour du mois (1 à 31).
ddd Trois chiffres correspondant au jour de l'année (1 à 366).
mm Un ou deux chiffres correspondant au mois (1 à 12).
mon Abréviation du mois en trois lettres (Jan à Déc).
month Intitulé complet du mois (janvier à décembre)
yy Deux chiffres correspondant à l'année (00 à 99)

Il est fortement recommandé d'utiliser le composant d'année à 4 chiffres (yyyy) au lieu du composant à deux chiffres. Dans le deuxième cas, les deux premiers chiffres sont réputés correspondre en interne à "20", ce qui n'est pas forcément votre intention. L'utilisation du composant à quatre chiffres identifie clairement le siècle et élimine ainsi toute ambiguïté.

yyyy Quatre chiffres correspondant à l'année (0000 à 9999)
w Chiffre unique correspondant au jour de la semaine (0-6, 0 = Dimanche, 6 = Samedi).
day Abréviation du jour en trois lettres (Dim à Sam).
dayname Intitulé complet du jour (dimanche à samedi)
hh Heure du jour (0 à 23).
tt Minute de l'heure (0 à 59).
ss Seconde de la minute (0 à 59).
am Indique le système de temps AM/PM (matin/après midi) par opposition au format 24 heures.
xs:datetime

Indique la date et l'heure au format XML conforme à la spécification de schéma W3C XML et à la norme ISO 8601. Ce format est le suivant :

CCYY-MM-DDThh:mm:ss

Toutes les zones doivent être présentes. Elles peuvent être précédées le cas échéant d'un signe et de chiffres en tête et suivies de valeurs fractionnelles pour les secondes et d'un fuseau horaire. Vous pouvez spécifier le fuseau horaire avec la lettre "Z", qui désigne le temps universel coordonné (UTC) ou par la différence avec le temps UTC.

Séparateurs

Les symboles suivants constituent des séparateurs valides. (L'utilisation de séparateurs est facultative).

Tableau 2. Tableau des symboles de séparateur valides
Symbole de séparateur Symbole de séparateur Symbole de séparateur
, . /
- < >
? : |
^ ; "
[ ] {
} _ =
@ % +
( ) *
& # <espace>

Modèles

Dans tous les exemples, le temps indiqué est :
  • Mercredi 8 juin 2000 à 14h05 et 32 secondes (Wednesday, June 8, 2000 at 32 seconds after 2:05 PM).
Tableau 3. Tableau des masques de date et d'heure et des résultats pour l'exemple
Masque Résultats
"mon. dd, yyyy"
Jun. 8, 2000
"month dd, yyyy"
June 8, 2000
"mon dd, yy (day)"
Jun 8, 00 (Wed)
''hhttss"
140532
"hh:tt am"
02:05 pm
"dd-mm-yy, hh:tt"
8-6-00, 14:05
"mm/dd/yyyy, hh:tt:ss am"
6/8/2000, 02:05:032 pm
"ddd, hh:tt:ss"
167, 14:05:32
"tt:ss am"
05:32 pm
"xs:datetime"
2000-06-08T14:05:32


Last updated: March 2016
bpfe019.htm

© Copyright IBM Corp. 2016.