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 :
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 | ' |
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.
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 |