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).
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).
Symbole de séparateur | Symbole de séparateur | Symbole de séparateur |
---|---|---|
, | . | / |
- | < | > |
? | : | | |
^ | ; | " |
[ | ] | { |
} | _ | = |
@ | % | + |
( | ) | * |
& | # | <espace> |
Modèles
- Mercredi 8 juin 2000 à 14h05 et 32 secondes (Wednesday, June 8, 2000 at 32 seconds after 2:05 PM).
Masque | Résultats |
---|---|
|
Jun. 8, 2000 |
|
June 8, 2000 |
|
Jun 8, 00 (Wed) |
|
140532 |
|
02:05 pm |
|
8-6-00, 14:05 |
|
6/8/2000, 02:05:032 pm |
|
167, 14:05:32 |
|
05:32 pm |
|
2000-06-08T14:05:32 |