Chaînes de modèles de temps valides

Cette rubrique explique comment exprimer le format de date et d'heure (la chaîne de modèle de temps) pour la variable DATE_TIME.

Par exemple, dans l'activité Gestion du numéro suivant, vous pouvez utiliser la variable DATE_TIME pour inclure la date et (ou) l'heure dans une définition de schéma de numéros.

La syntaxe est la suivante, où le paramètre timepatternstring est décrit dans cette rubrique : %DATE_TIME.[timepatternstring]%

Limitations concernant la numérotation séquentielle

Si le paramètre DATE_TIME est utilisé pour définir le modèle de numérotation séquentielle pour les SFC, les numéros générés doivent être conformes aux règles des SFC valides. Les symboles décrits ci-dessous peuvent être utilisés dans la chaîne timepatternstring de la variable DATE_TIME.[timepatternstring], mais vous devez porter une attention particulière à la création des modèles, car leur utilisation pourrait générer des chaînes ne correspondant pas à des SFC valides.

Un SFC ne peut pas comprendre plus de 128 caractères. Si un modèle contient un caractère non valide, une erreur risque de se produire durant le formatage ou l'analyse.

Notez que tous les SFC générés sont mis en majuscules.

Caractères valides dans une chaîne de modèle de temps

Le tableau ci-dessous décrit les caractères (symboles) valides pouvant être utilisés dans la chaîne de modèle de temps (timepatternstring) :

Symbole	Signification	Présentation	Exemple
G	indicateur de l'ère	Texte	AD
y	année	Nombre	2010 (yyyy dans la chaîne)
M	mois de l'année	Texte* ou nombre	Mars ou Mar ou 03
d	jour du mois	Nombre	10
h	heure am/pm (1-12)	Nombre	12
H	heure du jour (0-23)	Nombre	0
m	minute de l'heure	Nombre	30
s	seconde de la minute	Nombre	55
S	millième de la seconde	Nombre	978
E	jour de la semaine	Texte*	Mardi
D	jour de l'année	Nombre	189
F	jour de la semaine dans le mois	Nombre	2 (2ème semaine de juillet)
w	semaine de l'année	Nombre	27
W	semaine du mois	Nombre	2
a	indicateur am/pm	Texte*	PM
k	heure du jour (1-24)	Nombre	24
K	heure am/pm (0-11)	Nombre	0
z	fuseau horaire	Texte*	heure normale du Pacifique ou PST

Effet du nombre de symboles sur le formatage

Le nombre de lettres du modèle détermine le format :

Présentation	Incidence du nombre de symboles
Texte	Le nombre de lettres du modèle détermine si c'est la forme complète ou l'abréviation (si elle existe) qui est utilisée : Si le modèle comprend quatre lettres ou plus, la forme complète est utilisée. Si le modèle comprend moins de quatre lettres, c'est la forme courte ou abrégée qui est utilisée, si elle existe.
Nombre	Le nombre de lettres du modèle détermine le nombre minimum de chiffres. Des zéros sont ajoutés aux nombres trop courts. Le traitement de l'année (y) représente un cas particulier : Si le nombre de `y` est 2, l'année est tronquée à 2 chiffres.
Texte et nombre	Le nombre de lettres du modèle détermine si c'est un nombre ou une lettre qui est utilisé. Si le nombre est 3 ou plus, utilisez Texte, autrement utilisez Nombre.

Présentation

Incidence du nombre de symboles

Texte

Le nombre de lettres du modèle détermine si c'est la forme complète ou l'abréviation (si elle existe) qui est utilisée :

Si le modèle comprend quatre lettres ou plus, la forme complète est utilisée.
Si le modèle comprend moins de quatre lettres, c'est la forme courte ou abrégée qui est utilisée, si elle existe.

Nombre

Le nombre de lettres du modèle détermine le nombre minimum de chiffres. Des zéros sont ajoutés aux nombres trop courts. Le traitement de l'année (y) représente un cas particulier :

Si le nombre de y est 2, l'année est tronquée à 2 chiffres.

Texte et nombre

Le nombre de lettres du modèle détermine si c'est un nombre ou une lettre qui est utilisé.

Si le nombre est 3 ou plus, utilisez Texte, autrement utilisez Nombre.

Exemple

Voici des exemples de modèles de formatage de date pour DATE_TIME, ainsi que l'affichage résultant :

Modèle	Résultat
`yyyy MM dd G hh mm ss zzzz`	2008 11 12 AD 06 56 00 HEURE DE L'EUROPE ORIENTALE
`EEE MMM d yy`	LUN NOV 12 07
`h mm a`	7 00 PM
`K mm a z`	7 02 PM HEO

Notez que les exemples ci-dessus illustrent une grande variété de possibilités pour l'expression des dates avec DATE_FORMAT, mais comme indiqué précédemment, toutes les options ne sont pas adaptées à la définition de la numérotation séquentielle.