### 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