Fg68at: http://de.wikipedia.org/wiki/Vorlage:FormatDate/Doku

2010-01-21T21:47:57Z

http://de.wikipedia.org/wiki/Vorlage:FormatDate/Doku

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}
</noinclude>

Die Vorlage '''FormatDate''' formatiert ein in Anlehnung an [[w:ISO 8601|ISO 8601]] angegebenes Datum wie 2000-06-29 ({{FormatDate|2000-06-29}}), 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 [[w:Hilfe:Vorlagenprogrammierung#Funktion time|#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.

== Aufruf (Normalfall) ==

* <nowiki>{{FormatDate|Datum}}</nowiki>
* <nowiki>{{FormatDate|Datum|Formatcode}}</nowiki>

Dabei muss „Datum“ in der Form „jjjj-mm-tt“ oder „jjjj-m-t“ angegeben werden, also z.B. „1881-11-03“ für den {{FormatDate|1881-11-03}}. Die Angabe in der Form „jjjj-mm-0“ oder „jjjj-mm-00“ unterdrückt die Angabe des Tages für Datumsangaben, die nur monatsgenau sind. Die Angabe in der Form „jjjj-0-0“ oder „jjjj-00-00“ gibt nur das Jahr aus. Angaben mit führendem [[Viertelgeviertstrich#Bindestrich‑Minus|(Bindestrich‑)Minus]] wie „-33-07-11“ bezeichnen Daten vor dem Jahr {{FormatDate|0-00-00}}, hier den {{FormatDate|-33-07-11}} (nicht den {{FormatDate|-32-07-11}}!). (Als Trennzeichen ist ausschließlich das Zeichen „-“, das Bindestrich‑Minus, zu verwenden, keine andere Variante eines Striches wie Gedankenstrich, „typografisch korrektes“ Minuszeichen, usw. Das gleiche gilt, abweichend von ISO 8601, für die eventuell einleitende Minus-Angabe.).

Als zweiter Parameter kann ein Formatcode angegeben werden: „F“ (= full) oder „M“ (= month) wie bei #time, zusätzlich „S“ (= short). „F“ ist Standard, kann also weggelassen werden:

{| class="prettytable"
|- class="hintergrundfarbe6"
!Format- code!!Form des Monatsangabe!! Beispiel !! Resultat
|---
| align="center" | ohne|| Januar Februar ...
| <nowiki>{{FormatDate|2000-02-29}}</nowiki> <nowiki>{{FormatDate|2000-03-01}}</nowiki>
| {{FormatDate|2000-02-29}} {{FormatDate|2000-03-01}}
|---
| align="center" | F || Januar Februar ...
| <nowiki>{{FormatDate|2000-02-29|F}}</nowiki> <nowiki>{{FormatDate|2000-03-01|F}}</nowiki>
| {{FormatDate|2000-02-29|F}} {{FormatDate|2000-03-01|F}}
|---
| align="center" | M || Jan. Feb. Mär. Apr. Mai Jun. Jul. Aug. ...
| <nowiki>{{FormatDate|2000-02-29|M}}</nowiki> <nowiki>{{FormatDate|2000-03-01|M}}</nowiki>
| {{FormatDate|2000-02-29|M}} {{FormatDate|2000-03-01|M}}
|---
| align="center" | S || Jan. Feb. März Apr. Mai Juni Juli Aug. ...
| <nowiki>{{FormatDate|2000-02-29|S}}</nowiki> <nowiki>{{FormatDate|2000-03-01|S}}</nowiki>
| {{FormatDate|2000-02-29|S}} {{FormatDate|2000-03-01|S}}
|}

== Aufruf mit Zusatzparametern ==

Hinter dem Datum und evtl. dem Formatcode sind zwei weitere Parameter möglich:

{| class="prettytable"
|- class="hintergrundfarbe6"
! Parameter !! Wirkung !! Anmerkung
|---
| nbsp
| zwischen Monat und Jahr wird ein geschütztes Leerzeichen (&nbsp;) gesetzt
| rowspan="2" | Standard ist an dieser Stelle ein normales Leerzeichen, überall sonst wird immer ein geschütztes Leerzeichen erzeugt.
|---
| sp
| zwischen Monat und Jahr wird ein normales Leerzeichen gesetzt
|---
| link
| das Datum wird verlinkt
|
|}

== Beispiele ==

{| class="prettytable"
|- class="hintergrundfarbe6"
! Aufruf !! dargestelltes Ergebnis
|---
| <nowiki>{{FormatDate|1-1-1}}</nowiki> || {{FormatDate|1-1-1}}
|---
| <nowiki>{{FormatDate|1234-2-28}}</nowiki> || {{FormatDate|1234-2-28}}
|---
| <nowiki>{{FormatDate|1881-3-1}}</nowiki> || {{FormatDate|1881-3-1}}
|---
| <nowiki>{{FormatDate|1881-04-01}}</nowiki> || {{FormatDate|1881-04-01}}
|---
| <nowiki>{{FormatDate|2000-05-30}}</nowiki> || {{FormatDate|2000-05-30}}
|---
| <nowiki>{{FormatDate|2000-06-29|M}}</nowiki> || {{FormatDate|2000-06-29|M}}
|---
| <nowiki>{{FormatDate|2000-07-28|S}}</nowiki> || {{FormatDate|2000-07-28|S}}
|---
| <nowiki>{{FormatDate|2000-08-27|F}}</nowiki> || {{FormatDate|2000-08-27|F}}
|---
| <nowiki>{{FormatDate|2000-9-0}}</nowiki> || {{FormatDate|2000-9-0}}
|---
| <nowiki>{{FormatDate|2000-10-0}}</nowiki> || {{FormatDate|2000-10-0}}
|---
| <nowiki>{{FormatDate|2000-11-00}}</nowiki> || {{FormatDate|2000-11-00}}
|---
| <nowiki>{{FormatDate|2000-12-00}}</nowiki> || {{FormatDate|2000-12-00}}
|---
| <nowiki>{{FormatDate|2000-0-0}}</nowiki> || {{FormatDate|2000-0-0}}
|---
| <nowiki>{{FormatDate|2000-9-9|link}}</nowiki> || {{FormatDate|2000-9-9|link}}
|---
| <nowiki>{{FormatDate|2000-9-0|link}}</nowiki> || {{FormatDate|2000-9-0|link}}
|---
| <nowiki>{{FormatDate|2000-0-0|link}}</nowiki> || {{FormatDate|2000-0-0|link}}
|---
| <nowiki>{{FormatDate|1881-3-1|nbsp}}</nowiki> || {{FormatDate|1881-3-1|nbsp}}
|---
| <nowiki>{{FormatDate|1881-3-1|sp}}</nowiki> || {{FormatDate|1881-3-1|sp}}
|---
| <nowiki>{{FormatDate|1881-3-1|nbsp|link}}</nowiki> || {{FormatDate|1881-3-1|nbsp|link}}
|---
| <nowiki>{{FormatDate|1881-3-1|sp|link}}</nowiki> || {{FormatDate|1881-3-1|sp|link}}
|---
| <nowiki>{{FormatDate|-200-12-1}}</nowiki> || {{FormatDate|-200-12-1}}
|---
| <nowiki>{{FormatDate|0-12-25}}</nowiki> || {{FormatDate|0-12-25}}
|---
| <nowiki>{{FormatDate|2000}}</nowiki> || {{FormatDate|2000}}
|---
| <nowiki>{{FormatDate|xxx}}</nowiki> || {{FormatDate|xxx}}
|}

== Siehe auch ==

* [[Vorlage:FormatZahl]], zur länderspezifischen Formatierung von Zahlen

Vorlage:FormatDate/Doku - Versionsgeschichte

Fg68at: http://de.wikipedia.org/wiki/Vorlage:FormatDate/Doku