Vorlage:FormatDate/Doku
Die Vorlage FormatDate formatiert ein in Anlehnung an ISO 8601 angegebenes Datum wie 2000-06-29 ({{#invoke:Vorlage:FormatDate|Execute}}), etwa zur Verwendung in Listen oder Infoboxen. Dabei wird der volle oder ein abgekürzter deutscher Monatsname erzeugt, der volle Name ist Standard. Im Gegensatz zur Parser-Funktion #time kann diese Vorlage alle Daten verarbeiten, auch Daten vor dem Jahr 1. Durch Angabe einer 0 für Monat bzw. Tag kann eine Ausgabe ohne Monats-/Tagesangabe erzielt werden. Zusätzliche Parameter bewirken Verlinkung oder durchgängige Verwendung von geschützten Leerzeichen ( ).
Zur Verwendung in sortierbaren Tabellen gibt es die fast gleichwertige Vorlage:SortDate, die neben der Formatierung auch noch für die richtige Sortierung sorgt.
Inhaltsverzeichnis
Verwendung
Die Syntax für Jahre vor Chr. wurde geändert! Jetzt gilt die kalendarische Zuordnung: -N = N v. Chr., statt bisher N+1 v. Chr. |
Kopiervorlagen
- Syntax
-
{{FormatDate|<ISO-Datum>|<Format>|<Extra1>|<Extra2>|AT=(ja{{!}}|)}}
-
{{FormatDate| -- |L| }}
-
{{FormatDate| -- |M| }}
-
{{FormatDate| -- |S| }}
Parameter
- Erster Parameter (<ISO-Datum>)
- Datum im Format
JJJJ-MM-TT
, also z. B.2013-09-03
Tag und Monat können auch ohne führende Null angegeben werden, alsoJJJJ-M-T
. Hierbei ist ausschließlich der ASCII-Strich "-" erlaubt. Jahre vor 1 n. Chr. werden mit Minuszeichen angegeben. Dabei bedeutet z.B. "-333" soviel wie 333 v. Chr. Will man den Tag weglassen, dann gibt man als Tagesdatum eine Null an. will man auch den Monat weglassen, so kann auch dort eine Null angegeben werden. Sollen nur Tag und Monat erscheinen, so wird als Jahr die Null angegeben (Ein Jahr Null gibt es nicht). Zulässig sind (optionale Stellen in Klammern):JJJJ-(M)M-(T)T
,JJJJ-(M)M-0
,JJJJ-0-0
und0-(M)M-(T)T
. - Zweiter Parameter (<Format>)
- Damit wird das Ausgabeformat des Monats festgelegt. Mögliche Werte sind:
- "L" oder leer: Monatsname wird ausgeschrieben.
- "M": Monatsname wird auf vier Zeichen abgekürzt.
- "S": Monatsname wird auf drei Zeichen abgekürzt.
Formatcode | Form der Monatsangabe | Beispiel | Resultat |
---|---|---|---|
L | Januar, Februar, ... | {{FormatDate|2000-03-01|L}}
|
Execute}} |
M | "Jan.", "Feb.", "März", "Apr.", "Mai", "Juni", "Juli", "Aug.", "Sep.", "Okt.", "Nov.", "Dez." | {{FormatDate|2000-03-01|M}}
|
Execute}} |
S | "Jan.", "Feb.", "Mrz.", "Apr.", "Mai", "Jun.", "Jul.", "Aug.", "Sep.", "Okt.", "Nov.", "Dez." | {{FormatDate|2000-03-01|S}}
|
Execute}} |
- Dritter und vierter Standardparameter
- Dieser kann die Werte "nbsp" und / oder "link" haben. In diesem Fall sollte Parameter 2 für das Langformat explizit angegeben werden.
Parameter | Wirkung | Anmerkung |
---|---|---|
nbsp | zwischen Monat und Jahr wird ein geschütztes Leerzeichen ( ) gesetzt | Standard ist an dieser Stelle ein normales Leerzeichen, überall sonst wird immer ein geschütztes Leerzeichen erzeugt. |
link | Tag und Monat, sowie die Jahreszahl werden verlinkt. |
- Benannter Parameter AT
- Mit
AT=ja
wird Jänner anstatt Januar geschrieben.
Beispiele
Aufruf | Ergebnis | Anmerkung |
---|---|---|
{{FormatDate|2012-02-01}} oder {{FormatDate|2012-02-1}} oder {{FormatDate|2012-2-1}} | Execute}} | Langformat |
{{FormatDate|2012-12-0}} | Execute}} | Ohne Tag |
{{FormatDate|2012-0-0}} | Execute}} | Nur die Jahreszahl |
{{FormatDate|2012-0-12}} | Execute}} | Tag ohne Monat nicht sinnvoll, daher auch hier nur die Jahreszahl |
{{FormatDate|0-12-24}} | Execute}} | Nur Tag und Monat |
{{FormatDate|2012-02-01|L}} | Execute}} | "L" bewirkt das gleiche wie keine Formatangabe |
{{FormatDate|2012-06-29|M}} | Execute}} | Mittleres Format |
{{FormatDate|2000-07-28|S}} | Execute}} | Kurzformat |
{{FormatDate|2000-08-0|M}} | Execute}} | Ohne Tagesangabe |
{{FormatDate|2012-01-02|L|link}} | Execute}} | Langformat, verlinkt |
{{FormatDate|2012-01-02|L|link|nbsp}} | Execute}} | Langformat, verlinkt und mit nbsp (hier natürlich nicht sichtbar...) |
{{FormatDate|2012-01-02|L|link|nbsp|AT=ja}} | Execute}} | Langformat, verlinkt, mit nbsp und "Jänner" statt "Januar". |
{{FormatDate|0-01-02|link|AT=ja}} | Execute}} | Nur Tag und Monat, verlinkt und "Jänner" statt "Januar". |
{{FormatDate|-333}} | Execute}} | vor Christus |