Vorlage:SortDate/Doku: Unterschied zwischen den Versionen

Aus WikilovesParliaments
Zur Navigation springen Zur Suche springen
K (Kategorien von Vorlagenseite und Meta übernommen)
 
K (1 Version von wikipedia:Vorlage:SortDate/Doku importiert)
 
(kein Unterschied)

Aktuelle Version vom 19. März 2019, 22:36 Uhr

Diese Seite ist die Dokumentations-Unterseite der Vorlage:SortDate.
Lua-logo-nolabel.svg Diese Vorlage wurde ganz oder teilweise mit Hilfe der Programmiersprache Lua erstellt.
Die Module sind mit #invoke eingebunden. In der Dokumentation der einzelnen Module finden sich auch weitere Hinweise zu Rückfragen.

Diese Vorlage entspricht der Vorlage:FormatDate, erweitert diese jedoch um die Eigenschaft, in sortierbaren Tabellen für die richtige Reihenfolge zu sorgen. Dabei wird das Datum im ISO-Format (YYYY-MM-DD) angegeben. 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 ( ).

Aufruf (Normalfall)

  • {{SortDate|Datum}}
  • {{SortDate|Datum|Formatcode}}

Dabei muss „Datum“ in der Form „jjjj-mm-tt“ oder „jjjj-m-t“ angegeben werden, also z. B. „1881-11-03“ für den {{#invoke:Vorlage:FormatDate|Execute}}. 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 (Bindestrich‑)Minus wie „-33-07-11“ bezeichnen Daten vor dem Jahr 1, hier den {{#invoke:Vorlage:FormatDate|Execute}} (nicht den {{#invoke:Vorlage:FormatDate|Execute}}!). Eine Null als Jahreszahl (ein Jahr Null gab es nicht) bewirkt, dass nur Tag und Monat wiedergegeben werden. Drei Nullwerte (0-0-0) sind nicht erlaubt. Als Trennzeichen ist ausschließlich das ASCII-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‘, dreibuchstabig) wie bei #time, zusätzlich „S“ (= ‚short‘, vierbuchstabig/drei mit «.»). „F“ ist Standard, kann also weggelassen werden:

Format-
code
Form der Monatsangabe Beispiel Resultat
ohne Januar Februar ... {{SortDate|2000-02-29}}
{{SortDate|2000-03-01}}
Sort}}
{{#invoke:Vorlage:FormatDate|Sort}}
F Januar Februar ... {{SortDate|2000-02-29|F}}
{{SortDate|2000-03-01|F}}
Sort}}
{{#invoke:Vorlage:FormatDate|Sort}}
M Jan. Feb. März Apr. Mai Juni Juli Aug. ... {{SortDate|2000-02-29|M}}
{{SortDate|2000-03-01|M}}
Sort}}
{{#invoke:Vorlage:FormatDate|Sort}}
S Jan. Feb. Mrz. Apr. Mai Jun. Jul. Aug. ... {{SortDate|2000-02-29|S}}
{{SortDate|2000-03-01|S}}
Sort}}
{{#invoke:Vorlage:FormatDate|Sort}}

Aufruf mit Zusatzparametern

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

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.
sp zwischen Monat und Jahr wird ein normales Leerzeichen gesetzt
link das Datum wird verlinkt
AT=ja Jänner anstatt Januar
davor=<text> gibt vor dem Datum "<text>", gefolgt von einem Leerzeichen, aus.
display=<text> Für den Fall, dass ein sehr unbestimmtes Datum einsortiert werden muss, kann man hier einen Ersatztext angeben, welcher das formatierte Datum überschreibt. Ein geeignetes Datum zum Sortieren muss jedoch angegeben werden. Bitte nur im Ausnahmefall benutzen.

Beispiele

Sortdate-Aufruf Ergebnis
{{SortDate|1-1-1}} Sort}}
{{SortDate|1234-2-28}} Sort}}
{{SortDate|1881-3-1}} Sort}}
{{SortDate|1881-04-01}} Sort}}
{{SortDate|2000-05-30}} Sort}}
{{SortDate|2000-06-29|M}} Sort}}
{{SortDate|2000-07-28|S}} Sort}}
{{SortDate|2000-08-27|F}} Sort}}
{{SortDate|2000-9-0}} Sort}}
{{SortDate|2000-10-0}} Sort}}
{{SortDate|2000-11-00}} Sort}}
{{SortDate|2000-12-00}} Sort}}
{{SortDate|2000-0-0}} Sort}}
{{SortDate|2000-9-9|link}} Sort}}
{{SortDate|2000-9-0|link}} Sort}}
{{SortDate|2000-0-0|link}} Sort}}
{{SortDate|1881-3-1|nbsp}} Sort}}
{{SortDate|1881-3-1|sp}} Sort}}
{{SortDate|1881-3-1|nbsp|link}} Sort}}
{{SortDate|1881-3-1|sp|link}} Sort}}
{{SortDate|-200-12-1}} Sort}}
{{SortDate|0-12-25}} Sort}}
{{SortDate|2000}} Sort}}
{{SortDate|1881-01-11|AT=ja}} Sort}}
{{SortDate|1881-01-00|davor=ca.}} Sort}}
{{SortDate|1301-0-0}} Sort}}
{{SortDate|1350-0-0|display=Mitte des 14. Jahrhunderts}} Sort}}
{{SortDate|6999-0-0|display=verschoben bis in alle Ewigkeit}} Sort}}
{{SortDate|1401-0-0}} Sort}}

Siehe auch