Vorlage:FormatDate/Doku: Unterschied zwischen den Versionen

Aus WiiDatabase Wiki
Zur Navigation springenZur Suche springen
(Die Seite wurde neu angelegt: „<noinclude>{{Dokumentation/Dokuseite}}</noinclude> {{Lua}} Die Vorlage '''FormatDate''' formatiert ein in Anlehnung an ISO 8601 angegebenes Datu…“)
 
KKeine Bearbeitungszusammenfassung
 
Zeile 4: Zeile 4:


Zur Verwendung in sortierbaren Tabellen gibt es die fast gleichwertige [[Vorlage:SortDate]], die neben der Formatierung auch noch für die richtige Sortierung sorgt.
Zur Verwendung in sortierbaren Tabellen gibt es die fast gleichwertige [[Vorlage:SortDate]], die neben der Formatierung auch noch für die richtige Sortierung sorgt.
== Verwendung ==
=== Kopiervorlagen ===
;Syntax: <code><nowiki>{{FormatDate|&lt;ISO-Datum&gt;|&lt;Format&gt;|&lt;Extra1&gt;|&lt;Extra2&gt;|AT=(ja{{!}}|)}}</nowiki></code>
# <code><nowiki>{{FormatDate| -- |L| }}</nowiki></code>
# <code><nowiki>{{FormatDate| -- |M| }}</nowiki></code>
# <code><nowiki>{{FormatDate| -- |S| }}</nowiki></code>
=== Parameter ===
;Erster Parameter (&lt;ISO-Datum&gt;): Datum in einem ISO-Format wie beispielsweise <code>JJJJ-MM-TT</code>, also z. B. <code>2013-09-03</code>. Tag und Monat können auch ohne führende Null angegeben werden, also <code>JJJJ-M-T</code>.  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 kann man entweder als Tagesdatum eine Null angeben oder den dritten Teil ganz weglassen. Will man auch den Monat weglassen, so kann dort ebenfalls eine Null angegeben werden oder man gibt nur die Jahreszahl an. Sollen nur Tag und Monat erscheinen, so wird als Jahr die Null angegeben (Ein Jahr Null gibt es nicht). Zulässig sind also folgende Formate:
{| class="wikitable"
! Format
! Ausgabe
|-
|
* <code>JJJJ-MM-TT</code>
* <code>JJJJ-MM-T</code>
* <code>JJJJ-M-TT</code>
* <code>JJJJ-M-T</code>
| Tag, Monat und Jahr
|-
|
* <code>JJJJ-MM-0</code>
* <code>JJJJ-MM</code>
| Monat und Jahr
|-
|
* <code>JJJJ-0-0</code>
* <code>JJJJ</code>
| nur das Jahr
|-
|
* <code>JJJJ-0-TTT</code>
* <code>JJJJ-0-TT</code>
* <code>JJJJ-0-T</code>
| Tag, Monat und Jahr des „TTT-ten“ Tages im Jahr.
|}
;Zweiter Parameter (&lt;Format&gt;): 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.
{| class="wikitable"
|- class="hintergrundfarbe6"
! Format&shy;code !! Form der Monatsangabe !! Beispiel !! Resultat
|-
| align="center" | L || Januar, Februar, ...
| <code><nowiki>{{FormatDate|2000-03-01|L}}</nowiki></code>
|{{FormatDate|2000-03-01|L}}
|-
| align="center" | M
| „Jan.“, „Feb.“, „März“, „Apr.“, „Mai“, „Juni“, „Juli“, „Aug.“, „Sep.“, „Okt.“, „Nov.“, „Dez.“
| <code><nowiki>{{FormatDate|2000-03-01|M}}</nowiki></code>
| {{FormatDate|2000-03-01|M}}
|-
| align="center" | S
| „Jan.“, „Feb.“,  „Mrz.“, „Apr.“, „Mai“, „Jun.“, „Jul.“, „Aug.“, „Sep.“, „Okt.“, „Nov.“, „Dez.“
| <code><nowiki>{{FormatDate|2000-03-01|S}}</nowiki></code>
| {{FormatDate|2000-03-01|S}}
|}
;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.
{| class="wikitable"
|- class="hintergrundfarbe6"
! Parameter !! Wirkung !! Anmerkung
|-
| nbsp
| zwischen Monat und Jahr wird ein geschütztes Leerzeichen (&amp;nbsp;) 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 <code>AT=ja</code> wird Jänner anstatt Januar geschrieben.
== Beispiele ==
{| class="wikitable"
|- class="hintergrundfarbe6"
! Aufruf !! Ergebnis !! Anmerkung
|-
| <nowiki>{{FormatDate|2012-2-1}} </nowiki> || {{FormatDate|2012-02-01}} || Langformat
|-
| <nowiki>{{FormatDate|2012-12-0}}</nowiki> || {{FormatDate|2012-12-0}} || Ohne Tag
|-
| <nowiki>{{FormatDate|2012-12}}</nowiki> || {{FormatDate|2012-12}} || Ohne Tag (alternativ)
|-
| <nowiki>{{FormatDate|2012-0-0}}</nowiki>  || {{FormatDate|2012-0-0}}  || Nur die Jahreszahl
|-
| <nowiki>{{FormatDate|2012-0}}</nowiki>  || {{FormatDate|2012-0}}  || Nur die Jahreszahl
|-
| <nowiki>{{FormatDate|2012}}</nowiki>  || {{FormatDate|2012}}  || Nur die Jahreszahl
|-
| <nowiki>{{FormatDate|2012-0-256}}</nowiki> || nowrap | {{FormatDate|2012-0-256}}  || Der 12. September ist der 256. Tag eines Schaltjahres
|-
| <nowiki>{{FormatDate|2012-256}}</nowiki> || nowrap | {{FormatDate|2012-0-256}}  || Der 12. September ist der 256. Tag eines Schaltjahres
|-
| <nowiki>{{FormatDate|01}}</nowiki>  || {{FormatDate|01}}  || Nur Jahr (ohne Suffix und führende Nullen)
|-
| <nowiki>{{FormatDate|-01}}</nowiki>  || {{FormatDate|-01}}  || Nur Jahr (mit Suffix, ohne führende Nullen)
|-
| <nowiki>{{FormatDate|--01}}</nowiki>  || {{FormatDate|--01}}  || Nur Monat, nur Tag des Monats wird nicht unterstützt
|-
| <nowiki>{{FormatDate|---01}}</nowiki>  || {{FormatDate|---01}}  || Tag und erster Monat, nur Tag des Monats wird nicht unterstützt
|-
| <nowiki>{{FormatDate|-12-24}}</nowiki>  || {{FormatDate|-12-24}}  || Fehler, implizites Jahr wird so nicht unterstützt
|-
| <nowiki>{{FormatDate|--12-24}}</nowiki>  || {{FormatDate|--12-24}}  || Nur Tag und Monat
|-
| <nowiki>{{FormatDate|0-12-24}}</nowiki>  || {{FormatDate|0-12-24}}  || Nur Tag und Monat
|-
| <nowiki>{{FormatDate|0000-12-24}}</nowiki>  || {{FormatDate|0000-12-24}}  || Nur Tag und Monat, Jahr 0 wird nicht unterstützt
|-
| <nowiki>{{FormatDate|2012-W12-5}}</nowiki>  || {{FormatDate|2012-W12-5}}  || Fehlinterpretation: Kalenderwoche und Wochentag wird nicht unterstützt und nicht als Fehler erkannt
|-
| <nowiki>{{FormatDate|2012-02-01|L}}</nowiki> || {{FormatDate|2012-02-01|L}} || „L“ bewirkt das gleiche wie keine Formatangabe
|-
| <nowiki>{{FormatDate|2012-06-29|M}}</nowiki> || {{FormatDate|2000-06-29|M}} || Mittleres Format
|-
| <nowiki>{{FormatDate|2000-07-28|S}}</nowiki> || {{FormatDate|2000-07-28|S}} || Kurzformat
|-
| <nowiki>{{FormatDate|2000-08-0|M}}</nowiki> || {{FormatDate|2000-08-0|M}} || Mittleres Format ohne Tagesangabe
|-
| <nowiki>{{FormatDate|2012-01-02|L|link}}</nowiki> || {{FormatDate|2012-01-02|L|link}} || Langformat, verlinkt. Hier ist die explizite Angabe „L“ sinnvoll, weil im Quelltext besser lesbar.
|-
| <nowiki>{{FormatDate|2012-01-02|L|link|nbsp}}</nowiki> || {{FormatDate|2012-01-02|L|link|nbsp}} || Langformat, verlinkt und mit nbsp (hier natürlich nicht sichtbar...)
|-
| <nowiki>{{FormatDate|2012-01-02|L|link|nbsp|AT=ja}}</nowiki> || {{FormatDate|2012-01-02|L|link|nbsp|AT=ja}} || Langformat, verlinkt, mit nbsp und „Jänner“ statt „Januar“.
|-
| <nowiki>{{FormatDate|0-01-02|link|AT=ja}}</nowiki>  || {{FormatDate|0-01-02|link|AT=ja}}  || Nur Tag und Monat, verlinkt  und „Jänner“ statt „Januar“.
|-
| <nowiki>{{FormatDate|-333}}</nowiki>  || {{FormatDate|-333}}  || vor Christus
|-
| <nowiki>{{FormatDate|-333-11}}</nowiki>  || {{FormatDate|-333-11}}  || [[Schlacht bei Issos]]
|}

Aktuelle Version vom 11. Juli 2018, 17:39 Uhr

Dokumentations-Unterseite Diese Seite ist die Dokumentations-Unterseite der Vorlage:FormatDate.

Die Vorlage FormatDate formatiert ein in Anlehnung an ISO 8601 angegebenes Datum wie 2000-06-29 (29. Juni 2000), 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 (&nbsp;).

Zur Verwendung in sortierbaren Tabellen gibt es die fast gleichwertige Vorlage:SortDate, die neben der Formatierung auch noch für die richtige Sortierung sorgt.

Verwendung

Kopiervorlagen

Syntax
{{FormatDate|<ISO-Datum>|<Format>|<Extra1>|<Extra2>|AT=(ja{{!}}|)}}
  1. {{FormatDate| -- |L| }}
  2. {{FormatDate| -- |M| }}
  3. {{FormatDate| -- |S| }}

Parameter

Erster Parameter (<ISO-Datum>)
Datum in einem ISO-Format wie beispielsweise JJJJ-MM-TT, also z. B. 2013-09-03. Tag und Monat können auch ohne führende Null angegeben werden, also JJJJ-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 kann man entweder als Tagesdatum eine Null angeben oder den dritten Teil ganz weglassen. Will man auch den Monat weglassen, so kann dort ebenfalls eine Null angegeben werden oder man gibt nur die Jahreszahl an. Sollen nur Tag und Monat erscheinen, so wird als Jahr die Null angegeben (Ein Jahr Null gibt es nicht). Zulässig sind also folgende Formate:
Format Ausgabe
  • JJJJ-MM-TT
  • JJJJ-MM-T
  • JJJJ-M-TT
  • JJJJ-M-T
 Tag, Monat und Jahr
  • JJJJ-MM-0
  • JJJJ-MM
 Monat und Jahr
  • JJJJ-0-0
  • JJJJ
 nur das Jahr
  • JJJJ-0-TTT
  • JJJJ-0-TT
  • JJJJ-0-T
 Tag, Monat und Jahr des „TTT-ten“ Tages im Jahr.
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.
Format­code Form der Monatsangabe Beispiel Resultat
L Januar, Februar, ... {{FormatDate|2000-03-01|L}} 1. März 2000
M „Jan.“, „Feb.“, „März“, „Apr.“, „Mai“, „Juni“, „Juli“, „Aug.“, „Sep.“, „Okt.“, „Nov.“, „Dez.“ {{FormatDate|2000-03-01|M}} 1. März 2000
S „Jan.“, „Feb.“, „Mrz.“, „Apr.“, „Mai“, „Jun.“, „Jul.“, „Aug.“, „Sep.“, „Okt.“, „Nov.“, „Dez.“ {{FormatDate|2000-03-01|S}} 1. Mrz. 2000
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 (&nbsp;) 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-2-1}} 1. Februar 2012 Langformat
{{FormatDate|2012-12-0}} Dezember 2012 Ohne Tag
{{FormatDate|2012-12}} Dezember 2012 Ohne Tag (alternativ)
{{FormatDate|2012-0-0}} 2012 Nur die Jahreszahl
{{FormatDate|2012-0}} 2012 Nur die Jahreszahl
{{FormatDate|2012}} 2012 Nur die Jahreszahl
{{FormatDate|2012-0-256}} 12. September 2012 Der 12. September ist der 256. Tag eines Schaltjahres
{{FormatDate|2012-256}} 12. September 2012 Der 12. September ist der 256. Tag eines Schaltjahres
{{FormatDate|01}} 1Vorlage:FormatDate/Wartung/0 Nur Jahr (ohne Suffix und führende Nullen)
{{FormatDate|-01}} 1 v. Chr. Nur Jahr (mit Suffix, ohne führende Nullen)
{{FormatDate|--01}} Januar Nur Monat, nur Tag des Monats wird nicht unterstützt
{{FormatDate|---01}} 1. Januar Tag und erster Monat, nur Tag des Monats wird nicht unterstützt
{{FormatDate|-12-24}} Vorlage:FormatDate: Ungültiges Datum!Vorlage:FormatDate/Wartung/Error Fehler, implizites Jahr wird so nicht unterstützt
{{FormatDate|--12-24}} 24. Dezember Nur Tag und Monat
{{FormatDate|0-12-24}} 24. Dezember Nur Tag und Monat
{{FormatDate|0000-12-24}} 24. DezemberVorlage:FormatDate/Wartung/0 Nur Tag und Monat, Jahr 0 wird nicht unterstützt
{{FormatDate|2012-W12-5}} 5. Januar 2012 Fehlinterpretation: Kalenderwoche und Wochentag wird nicht unterstützt und nicht als Fehler erkannt
{{FormatDate|2012-02-01|L}} 1. Februar 2012 „L“ bewirkt das gleiche wie keine Formatangabe
{{FormatDate|2012-06-29|M}} 29. Juni 2000 Mittleres Format
{{FormatDate|2000-07-28|S}} 28. Jul. 2000 Kurzformat
{{FormatDate|2000-08-0|M}} Aug. 2000 Mittleres Format ohne Tagesangabe
{{FormatDate|2012-01-02|L|link}} 2. Januar 2012 Langformat, verlinkt. Hier ist die explizite Angabe „L“ sinnvoll, weil im Quelltext besser lesbar.
{{FormatDate|2012-01-02|L|link|nbsp}} 2. Januar 2012 Langformat, verlinkt und mit nbsp (hier natürlich nicht sichtbar...)
{{FormatDate|2012-01-02|L|link|nbsp|AT=ja}} 2. Jänner 2012 Langformat, verlinkt, mit nbsp und „Jänner“ statt „Januar“.
{{FormatDate|0-01-02|link|AT=ja}} 2. Jänner Nur Tag und Monat, verlinkt und „Jänner“ statt „Januar“.
{{FormatDate|-333}} 333 v. Chr. vor Christus
{{FormatDate|-333-11}} November 333 v. Chr. Schlacht bei Issos
Abgerufen von „https://wiki.wiidatabase.de/index.php?title=Vorlage:FormatDate/Doku&oldid=6456“