iCalamus: Datum-Formaatsyntax

Datum-Formaatsyntax

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

Het datum/tijdformaat wordt door een tekstvoorbeeld beschreven. Het aantal letters bepaalt het uitvoerformaat. De volgende letters zijn voor tekstvoorbeelden gereserveerd:

Tabel 1: ICU-Datum-formaat
Symbool	Bedoeling	Presentatie	Monster
G	Tijdvak-kentekener	(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
'	Tekstaanvang
''	Eenvoudige aanhaling		'

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 tekstvoorbeeld, die niet in het gebied van ['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 tekstvoorbeeld dat niet-toegestane tekens of tekencombinaties bevat geeft een foutmelding.

Tabel 2: ICU Datum-Format-Beispiele
Formaat-tekstvoorbeeld	Resultaat
yyyy.MM.dd G 'um' HH:mm:ss Z	1996.07.10 AD um 15:08:56 PDT
EEE, d. MMM ''yy	Mit, 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