iCalamus 2: Datum-Formaatsyntax

Datum-Formaatsyntax

iCalamus gebruikt de ICU-syntax voor datumformaten. Deze wordt hierna in detail beschreven.

Het datum/tijdformaat wordt gedefinieerd met een tekstpatroon. Het aantal letters bepaalt het uitvoerformaat. De volgende letters zijn voor tekstpatronen gereserveerd:

Tabel 8: ICU-Datum-formaat
Symbool	Bedoeling	Presentatie	Monster
G	Tijdvakmarkering	(Text)	AD
y	Jaar	(Nummer)	2006
M	Maand in jaar	(Tekst + nummer)	Juli en 07
d	Dag in maand	(Nummer)	10
h	Uur in am/pm (1 12)	(Nummer)	12
H	Uur in dag (0 23)	(Nummer)	0
m	Minuut in het uur	(Nummer)	30
s	Seconde in de minuut	(Nummer)	55
S	Milliseconde	(Nummer)	978
E	Dag in de week	(Tekst)	Dinsdag
D	Dag in het jaar	(Nummer)	189
F	Weekdag in de maand	(Nummer)	2 (2. woensdag in juli)
w	Week in het jaar	(Nummer)	27
W	Week in de maand	(Nummer)	2
a	am/pm-aanduiding	(Tekst)	pm
k	Uur in de dag (1 24)	(Nummer)	24
K	Uur in am/pm (0 11)	(Nummer)	0
Z	Tijdzone	(Tekst)	Pacific Standard Time
'	Escapeteken voor tekst
''	Enkel aanhalingsteken		'

Tekst: Vier of meer letters vormen de lange vorm, minder dan vier vormen de korte vorm of een afgekorte vorm, als die bestaat. Voorbeeld:
EEEE vormt maandag, EEE vormt maan.
Nummer: Het minimale aantal cijfers. Kortere cijfer-tekens geven resutlaten zonder een nul aan het begin. Voorbeeld:
'm' geeft '6', 'mm' geeft '06'. Het jaar wordt bijzonder behandeld: als het aantal 'y' 2 is, wordt het jaar op 2 cijfers afgekort (voorbeeld: 'yyyy' geeft '2006', 'yy' geeft '06'.)
Tekst + nummer: Drie of meer letters vormen tekst, anders cijfers. (Voorbeeld: 'M' geeft '1', 'MM' geeft '01', 'MMM' geeft 'Jan' en 'MMMM' geeft 'januari'.)

Hint: Alle tekens in het tekstpatroon, die buiten de reeks ['a'..'z'] en ['A'..'Z'] liggen, worden als normale tekst weergegeven. Zo worden bijvoorbeeld tekens als ':', '.', ' ', '#' en '@' in het resultaat weergegeven, zelfs als ze niet tussen enkelvoudige aanhalingstekens staan.

Een tekstpatroon met niet-toegestane tekens of tekencombinaties geeft een foutmelding.

Tabel 9: ICU Datumpatroon-voorbeeld
Formaat-tekstvoorbeeld	Resultaat
yyyy-MM-dd G 'om' HH:mm:ss Z	1996-07-10 AD om 15:08:56 PDT
EEE, d. MMM ''yy	Woe, 10. Juli '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
dd MMMM yyyy GGG hh:mm aaa	10 juli 1996 AD 12:08 PM