Quelltext der Seite Vorlage:Dts/Doku

{{SEITENTITEL:Vorlage:dts<noinclude>/Doku</noinclude>}}<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{Veraltete Vorlage|[[Vorlage:DatumZelle]] oder eine andere Formatierung, siehe Box hier drunter.}}
{{Achtung|1='''Diese Vorlage ist obsolet.'''
* Zu den Gründen siehe [[Hilfe:Tabellen/Sortierung #Veraltet]].
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
* 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 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 <code>&#123;&#123;dts{{!}}{{LOCALDAY}}{{!}}{{LOCALMONTH}}{{!}}{{LOCALYEAR}}&#125;&#125;</code> produziert sehr viel ansonsten sinnlose Syntax:<br /> <code>{{#tag:nowiki|{{dts|{{LOCALDAY}}|{{LOCALMONTH}}|{{LOCALYEAR}}}}}}</code>
Unerwünschte neue Einfügungen können in [[:Kategorie:Wikipedia:Vorlagenfehler/Veraltete Vorlage]] vermerkt sein.
}}


{{TemplateData|JSON=
{	"description": "Diente der korrekten Sortierung und Darstellung von Datumsangaben in Tabellenspalten. VERALTET – nicht mehr neu einfügen; siehe Vorlagendokumentation.",
	"params": {
		"1": {
			"suggested": true,
			"label": "Tag",
			"type": "number",
			"description": "Tageszahl – 7 oder 07"
		},
		"2": {
			"suggested": true,
			"label": "Monat",
			"type": "line",
			"description": "Ausgeschriebener Name des Monats – Februar\nAbgekürzter Name des Monats – Feb\nMonatszahl – 2 oder 02"
		},
		"3": {
			"suggested": true,
			"label": "Jahr",
			"type": "number",
			"description": "Jahreszahl – führende Nullen müssen nicht angegeben werden."
		}
	},
  "format": "inline"
}
|TOC=1}}

== Beschreibung ==
'''dts''' steht für '''D'''atum-'''T'''abellen-'''S'''ortierung (oder auch englisch: '''''d'''ate '''t'''able '''s'''orting'') und wird verwendet, um Datumsangaben in [[WP:TAB|Tabellenspalten]] richtig zu sortieren und darzustellen.

== Wozu dient die Vorlage? ==
Um [[Wikipedia:Tabellen|Tabellenspalten]] korrekt zu sortieren, mussten sie früher im Format TT.MM.JJJJ bzw. JJJJ-MM-TT angegeben werden, was zwar den [[Wikipedia:Datumskonventionen#Datumsangaben in Tabellen|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 Wiki-Software auch Datumsangaben mit Monatsnamen (z.&nbsp;B. 7. Feb. 1997) ohne diese Vorlage als Datum. 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.

=== Eingabe ===
<pre>{{dts|7|Feb|1997}}</pre>

=== Ausgabe ===
{{dts|7|Feb|1997}}

== Beispiele ==
{| class="wikitable sortable"
|-
!Vorlage-Syntax!!Dargestelltes Datum
|-
|<nowiki>{{dts|7|4|1688}}</nowiki>||{{dts|7|4|1688}}
|-
|<nowiki>{{dts|08|04|1688}}</nowiki>||{{dts|08|04|1688}}
|-
|<nowiki>{{dts|15|3|-44}}</nowiki>||{{dts|15|3|-44}}
|-
|<nowiki>{{dts|9|April|1688}}</nowiki>||{{dts|9|April|1688}}
|-
|<nowiki>{{dts|11|Okt|2007}}</nowiki>||{{dts|11|Okt|2007}}
|-
|<nowiki>{{dts|11|08|2007}}</nowiki>||{{dts|11|08|2007}}
|-
|<nowiki>{{dts||Sep|2007}}</nowiki>||{{dts||Sep|2007}}
|-
|<nowiki>{{dts|||2007}}</nowiki>||{{dts|||2007}}
|-
|<nowiki>{{dts|2|1|}}</nowiki>||{{dts|2|1|}}
|-
|<nowiki>{{dts|1|1|}}</nowiki>||{{dts|1|1|}}
|}
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…
<includeonly>
<!--[[Kategorie:Vorlage:Tabellenformatierung]]
[[Kategorie:Vorlage:Datumsberechnung]]-->
</includeonly>