Vorlage:Dts/Doku

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

Achtung: Diese Vorlage ist – ebenso wie die Vorlage:Nts – bei sehr häufiger Einbindung in eine Seite eine starke Belastung des Servers (genauer: Parsers). Sie sollte daher zusammen mit der Vorlage:Nts nicht öfter als ca. 500 mal auf einer Seite auftauchen.

Dts steht für Datum-Tabellen-Sortierung (oder auch englisch: Date Table Sorting) und wird verwendet, um Datumsangaben in Tabellenspalten richtig zu sortieren und darzustellen. Im Unterschied dazu wird in Vorlage:SortDate das Datum in ISO-Format eingegeben.

Übrigens: Die PlusPedia ist NICHT die Wikipedia. Wir sind ein gemeinnütziger Verein, PlusPedia ist werbefrei. Wir freuen uns daher über eine kleine Spende!

1 Wozu dient die Vorlage?

Um Tabellenspalten korrekt zu sortieren, mussten sie früher im Format TT.MM.JJJJ bzw. JJJJ-MM-TT angegeben werden, was zwar den Wikipedia-Datumskonventionen entspricht, aber manchmal nicht gewollt ist. Diese Vorlage löste das Problem indem ein unsichtbarer Sortierschlüssel vor den Text in die Tabellen-Zelle geschrieben wurde.

Seit September 2012 erkennt die Software auch Datumsangaben mit Monatsnamen (z. B. 7. Feb. 1997) ohne diese Vorlage als Datum (siehe Hilfe). Wenn alle Zeilen der Datumsspalte das gleiche Format haben, kann auf diese Vorlage verzichtet werden, außer wenn

• Jahresangaben v. Chr. vorkommen,
• einzelne Zeilen Text (kein Datum) enthalten,
• nach Datumsangaben mit Monatsnamen noch Text folgt (z. B. eine Quellenangabe),
• die unten genannte Formatierung gewünscht wird.

Für eine gleichmäßige und kompakte Darstellung werden vor einstelligen Tagen eine unsichtbare 0 gesetzt und die Monate mit fester Breite ausgegeben. Alle Monate außer Mai, Juni, Juli werden abgekürzt. Ein Zeilenumbruch in der Datumsangabe wird verhindert.

2 Parameter

• 1. Parameter – Tag
  • Tageszahl – 7 oder 07
• 2. Parameter – Monat
  • Ausgeschriebener Name des Monats – Februar
  • Abgekürzter Name des Monats (deutsch/englisch) – Feb
  • Monatszahl – 2 oder 02
• 3. Parameter – Jahr
  • Jahreszahl – führende Nullen müssen nicht angegeben werden.
• 4. Parameter – Uhrzeit
  • in der Form hh:mm:ss – 14:27:52
• Parameter „noFormat“ (optional)
  • Standardmäßig wird der Monatsname abgekürzt und die Breite festgeschrieben (was Tabellen leichter lesbar macht); mit diesem Parameter lässt sich dies verhindern. Der Wert ist beliebig.

2.1 Eingabe

{{dts|7|Feb|1997|14:27:52}}

2.2 Ausgabe

Darstellung

1997-02-07T14:27:5207. Feb. 1997, 14:27:52 Uhr

Quelltext

<span style="display: none;" class="sortkey">1997-02-07-14:27:52</span><span style="visibility: hidden;">0</span>7.&nbsp;<span style="text-align: left; width: 2em; display: inline-block;">Feb.</span>&nbsp;1997,</span>&nbsp;14:27:52&nbsp;Uhr

2.2.1 Mit optionalem Parameter „noFormat“

Darstellung

1997-02-07T14:27:527. Februar 1997, 14:27:52 Uhr

Quelltext

<span style="display: none;" class="sortkey">1997-02-07-14:27:53</span>7.&nbsp;Februar&nbsp;1997,&nbsp;14:27:52&nbsp;Uhr

3 Beispiele

mit Parameter „noFormat“

Vorlage-Syntax	Dargestelltes Datum
{{dts|7|4|1688|noFormat=ja}}	1688-04-077. April 1688
{{dts|08|04|1688|noFormat=ja}}	1688-04-088. April 1688
{{dts|15|3|-44|noFormat=ja}}	!9956-03-1515. März 44 v. Chr.
{{dts|9|April|1688|noFormat=ja}}	1688-04-099. April 1688
{{dts|11|Oct|2007|noFormat=ja}}	2007-10-1111. Oktober 2007
{{dts|11|08|2007|noFormat=ja}}	2007-08-1111. August 2007
{{dts|11|Sep|2007|13:55|noFormat=ja}}	2007-09-11T13:5511. September 2007, 13:55 Uhr
{{dts|11|Sep|2007|14:12|noFormat=ja}}	2007-09-11T14:1211. September 2007, 14:12 Uhr
{{dts|11|Sep|2007|14:15|noFormat=ja}}	2007-09-11T14:1511. September 2007, 14:15 Uhr
{{dts||Sep|2007|noFormat=ja}}	2007-09-00September 2007
{{dts|||2007|noFormat=ja}}	2007-00-00 2007
{{dts|2|1||noFormat=ja}}	?-01-022. Januar
{{dts|1|1||noFormat=ja}}	?-01-011. Januar
	keine Angabe

ohne Parameter „noFormat“

Vorlage-Syntax	Dargestelltes Datum
{{dts|7|4|1688}}	1688-04-0707. Apr. 1688
{{dts|08|04|1688}}	1688-04-0808. Apr. 1688
{{dts|15|3|-44}}	!9956-03-1515. Mär. 44 v. Chr.
{{dts|9|April|1688}}	1688-04-0909. Apr. 1688
{{dts|11|Oct|2007}}	2007-10-1111. Okt. 2007
{{dts|11|08|2007}}	2007-08-1111. Aug. 2007
{{dts|11|Sep|2007|13:55}}	2007-09-11T13:5511. Sep. 2007, 13:55 Uhr
{{dts|11|Sep|2007|14:12}}	2007-09-11T14:1211. Sep. 2007, 14:12 Uhr
{{dts|11|Sep|2007|14:15}}	2007-09-11T14:1511. Sep. 2007, 14:15 Uhr
{{dts||Sep|2007}}	2007-09-00Sep. 2007
{{dts|||2007}}	2007-00-00 2007
{{dts|2|1|}}	?-01-0202. Jan.
{{dts|1|1|}}	?-01-0101. Jan.
	keine Angabe

Anmerkung: Ist das Jahr nicht angegeben, sortiert die Vorlage mit führendem »?« und Datum – dieser Schlüssel steht dann zwischen den vollständigen Daten mit Jahr, und allfälligen Texten…

4 Siehe auch

• Vorlage:Datum – dasselbe, aber ohne Sortierschlüssel
• Vorlage:Dtsx – dasselbe, für große Tabellen
• Vorlage:SortDate – dasselbe, aber mit Eingabe im ISO-Format 2006-01-01 (Vorlage:FormatDate ohne Sortierschlüssel)
• Vorlage:Nts und Vorlage:0 für Zahlen, Vorlage:SortKeyName für Personennamen, Vorlage:SortKey