iCalamus 2: Syntaxe des chaînes de formatage de dates

Syntaxe des chaînes de formatage de dates

iCalamus utilise la syntaxe de formatage de date ICU qui est décrite ci-dessous.

Le format du groupe date/heure est spécifié sous la forme d'une chaîne de caractères spécifiques. Chacune des lettres permet de définir la structure du format à afficher. Les lettres structurelles (colonne Symbole), décrites ci-dessous, sont réservées à la construction de la syntaxe d'un groupe date/heure :

Tableau 8: Formatage de date ICU
Symbole	Signification	Présentation
Exemple
G	indicateur d'époque	(Texte)	AD
y	année	(Nombre)	1996
M	mois dans l'année	(Texte + nombre)	Juillet et 07
d	jour dans le mois	(Nombre)	10
h	heure en am/pm (1 12)	(Nombre)	12
H	heure dans le jour (0 23)	(Nombre)	0
m	minutes dans une heure	(Nombre)	30
s	secondes dans une minute	(Nombre)	55
S	milliseconde	(Nombre)	978
E	jour dans la semaine	(Texte)	Mardi
D	jour dans l'année	(Nombre)	189
F	jour de la semaine dans le mois	(Nombre)	2 (2ième Mardi en Mai)
w	semaine dans l'année	(Nombre)	27
W	semaine dans le mois	(Nombre)	2
a	indicateur am/pm	(Texte)	pm
k	heure dans le jour (1 24)	(Nombre)	24
K	heure en am/pm (0 11)	(Nombre)	0
Z	fuseau horaire	(Texte)	Heure standard du Pacifique
'	échappement pour le texte
''	guillemet simple		'

Texte: Quatre caractères permettent d'afficher le libellé intégral, avec moins de quatre caractères, le libellé abrégé sera affiché, s'il existe. Exemple :
EEEE génére Lundi, EEE génère Lun.
Nombre: Indique le nombre minimum de chiffres. Un zéro est ajouté aux nombres qui sont inférieurs au format demandé. Exemple :
Si 'm' génère '6', 'mm' génère '06'. L'année est traitée à part, si le nombre de 'y' est 2, l'année sera tronquée à deux chiffres. Exemple :
Si 'yyyy' génère '1997', 'yy' génère '97'.
Texte + nombre: Trois caractères et plus génèrent du texte, sinon un nombre est généré. (par exemple, 'M' génère '1', 'MM' génère '01', 'MMM' génère 'Jan', et 'MMMM' génère 'Janvier'.)

Remarque : Tous caractères de la structure qui ne sont pas dans l'intervalle ['a'..'z'] et ['A'..'Z'] seront traités comme du texte placé entre guillemet. Par exemple, les caractères comme ':', '.', ' ', '#' et '@' apparaîtront dans le texte du groupe date/heure résultant même s'ils ne sont pas placés entre guillemets.

Une structure contenant des lettres structurelles invalides générera une erreur.

Tableau 9: Exemples de format de date ICU
Format de la structure	Résultat
yyyy.MM.dd G 'à' HH:mm:ss Z	1996.07.10 AD à 15:08:56 PDT
EEE, MMM d, ''yy	Mer, Juli 10, '96
h:mm a	8:08 PM
hh 'o''clock' a, ZZZZ	09 o'clock AM. Eastern Standard Time
K:mm a, Z	9:34 AM, PST
yyyy.MMMM.dd GGG hh:mm aaa	1996.Juli.10 AD 12:08 PM