Vorlage:SortDate/Doku

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen

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

Diese Vorlage ist veraltet.

Bitte verwende stattdessen Vorlage:DatumZelle oder eine andere Formatierung, siehe Box hier drunter..

Diese Vorlage sollte in keiner anderen Kategorie außer Kategorie:Vorlage:Veraltet stehen, damit sie möglichst schnell verwaist. Sobald sie nicht mehr verwendet wird, kann ein Löschantrag für diese Vorlage gestellt werden.

Diese Vorlage ist obsolet.

  • Zu den Gründen siehe Hilfe:Tabellen/Sortierung #Veraltet.
  • Insbesondere ist der proprietäre Sortierschlüssel mit nichts anderem kompatibel und erfordert, dass alle Zellen der Spalte mit genau dieser Vorlage ausgerüstet sein müssen; nicht einmal Vorlage:dts bzw. Vorlage:dtsx lassen sich damit kombinieren.

Ein Ersatz ist möglich:

  • Durch ein taggenaues Datum direkt in einem der gängigen Formate
  • Durch Verwendung der Vorlage:DatumZelle; auch gemischt mit direkten taggenauen Angaben
    • Falls bisher korrektes ISO-Format verwendet wurde, kann einfach der Name der Vorlage gegen DatumZelle getauscht werden.
    • Der Wert 0 für Tage oder Monate ist jedoch unzulässig, und diese Werte sind zweistellig anzugeben.
    • Zu beachten ist, dass Vorlage:DatumZelle unmittelbar nach dem die Zelle öffnenden Pipe-Symbol stehen muss; weitere Zell-Attribute könen vorangestellt sein, jedoch kein weiteres Pipe-Symbol.
  • Treten in einer Spalte ausschließlich Jahreszahlen auf, dann können diese als Zahlenwerte aufgefasst werden und es bedarf überhaupt keiner Vorlage.

Achtung: Öfters mal wird die Vorlage auch mitten in einem Fließtext oder als Vorlagenparameter nur zur Datumsformatierung eingesetzt, hier ist durch Klartext-Datum ohne alle Vorlagen zu ersetzen.

  • Diese Vorlage war nur zur Sortierung in Tabellen vorgesehen.
  • Das heutige Datum {{SortDate|2024-04-26}} produziert sehr viel ansonsten sinnlose Syntax:
    <span style="display:none" class="sortkey">50240426♠</span>26. April 2024

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 (&nbsp;).

Aufruf (Normalfall)[Quelltext bearbeiten]

  • {{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 3. November 1881. 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 11. Juli 33 v. Chr. (nicht den 11. Juli 32 v. Chr.!). 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: „M“ (= ‚month‘, dreibuchstabig) wie bei #time, zusätzlich „S“ (= ‚short‘, vierbuchstabig/drei mit «.»). „ausgeschrieben“ ist Standard, kann also weggelassen werden:

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

Aufruf mit Zusatzparametern[Quelltext bearbeiten]

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 (&nbsp;) 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
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[Quelltext bearbeiten]

Sortdate-Aufruf Ergebnis
{{SortDate|1-1-1}} 01. Januar 1
{{SortDate|1234-2-28}} 28. Februar 1234
{{SortDate|1881-3-1}} 01. März 1881
{{SortDate|1881-04-01}} 01. April 1881
{{SortDate|2000-05-30}} 30. Mai 2000
{{SortDate|2000-06-29|M}} 29. Juni 2000
{{SortDate|2000-07-28|S}} 28. Jul. 2000
{{SortDate|2000-9-0}} September 2000
{{SortDate|2000-10-0}} Oktober 2000
{{SortDate|2000-11-00}} November 2000
{{SortDate|2000-12-00}} Dezember 2000
{{SortDate|2000-0-0}} 2000
{{SortDate|1881-3-1|nbsp}} 01. März 1881
{{SortDate|1881-3-1|sp}} 01. März 1881
{{SortDate|-200-12-1}} 01. Dezember 200 v. Chr.
{{SortDate|0-12-25}} 25. Dezember
{{SortDate|2000}} 2000
{{SortDate|1881-01-00|davor=ca.}} ca. Januar 1881
{{SortDate|1301-0-0}} 1301
{{SortDate|1350-0-0|display=Mitte des 14. Jahrhunderts}} Mitte des 14. Jahrhunderts
{{SortDate|6999-0-0|display=verschoben bis in alle Ewigkeit}} verschoben bis in alle Ewigkeit
{{SortDate|1401-0-0}} 1401

Lua

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.

Verwendetes Modul: Vorlage:FormatDate

Abgerufen von „https://de.wikipedia.org/w/index.php?title=Vorlage:SortDate/Doku&oldid=224279746“