Quelltext der Seite Vorlage:Dtsx/Doku

{{SEITENTITEL:Vorlage:dtsx<noinclude>/Doku</noinclude>}}<noinclude>{{Dokumentation/Dokuseite}}</noinclude>

'''dtsx''' steht für '''d'''ate '''t'''ime '''s'''ort e'''x'''tended. Sie dient, ähnlich wie die [[Vorlage:dts]], der Sortierung von Datumsangaben mit etwaiger Zeitangabe.
{{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]].
* Insbesondere ist der von dieser Vorlage generierte private Sortierschlüssel mit keiner anderen Angabe kompatibel und erfordert, dass ausnahmslos alle Zellen einer Spalte auch mit dieser Vorlagengruppe ausgerüstet sind. Die moderne Sortierung lässt hingegen taggenaue Angaben in den Zellen ohne besondere Maßnahmen zu und benötigt nur bei davon abweichenden Inhalten die  [[Vorlage:DatumZelle]].
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;dtsx{{!}}{{LOCALDAY}}{{!}}{{LOCALMONTH}}{{!}}{{LOCALYEAR}}&#125;&#125;</code> produziert sehr viel ansonsten sinnlose Syntax:<br /> <code>{{#tag:nowiki|{{dtsx|{{LOCALDAY}}|{{LOCALMONTH}}|{{LOCALYEAR}}}}}}</code>
}}

== Wozu dient die Vorlage? ==
Um [[Wikipedia:Tabellen|Tabellenspalten]] korrekt zu sortieren, <s>müssten sie im Format JJJJ-MM-TT sortiert werden, was aber nicht den Zeitangaben der Wikipedia entspricht</s> <small>(veraltete Feststellung)</small>. Diese Vorlage erstellt daher einen Sortierschlüssel. Dieser Sortierschlüssel gilt nur privat für diese Vorlage sowie [[Vorlage:dts]] und ist mit keinerlei anderen Werten in der Tabellenzelle kompatibel.

Alle Monate außer Mai, Juni, Juli werden abgekürzt.

== Parameter ==
* 1. Parameter – Tag
** Tageszahl – <code>7</code> oder <code>07</code>
* 2. Parameter – Monat
** Monatszahl – <code>2</code> oder <code>02</code>
* 3. Parameter – Jahr
** Jahreszahl – führende Nullen müssen nicht angegeben werden.
* <s>4. Parameter - Stunden (optional)</s>
** ohne oder mit führender Null
* <s>5. Parameter - Minuten (optional)</s>
** ohne oder mit führender Null
* <s>6. Parameter - Sekunden (optional)</s>
** ohne oder mit führender Null

=== Eingabe ===
<pre>{{dtsx|1= |2= |3= }}</pre>

== Beispiele ==
{|  class="wikitable sortable"
|-
!Vorlage-Syntax
!Dargestelltes Datum
|-
| {{Vorlage|dtsx|7|4|1688}}          ||{{dtsx|7|4|1688}}
|-
| {{Vorlage|dtsx|08|04|1688}}        ||{{dtsx|08|04|1688}}
|-
| {{Vorlage|dtsx|15|3|-44}} || {{dtsx|15|3|-44}}
|-
| {{Vorlage|dtsx|9|4|1688}}          ||{{dtsx|9|4|1688}}
|-
| {{Vorlage|dtsx|11|10|2007}} ||{{dtsx|11|10|2007}}
|-
| {{Vorlage|dtsx|11|9|2007}}        ||{{dtsx|11|09|2007}}
|-
| {{Vorlage|dtsx||9|2007}} (nur Monat und Jahr) || {{dtsx||9|2007}}
|-
| {{Vorlage|dtsx|||1969}} (nur Jahr) || {{dtsx|||1969}}
|-
| {{Vorlage|dtsx|11|9}} (nur Tag und Monat) || {{dtsx|11|9}}
|-
| {{Vorlage|dtsx|12|10|2020}} ||{{dtsx|12|10|2020}}
|}
<includeonly>
<!--[[Kategorie:Vorlage:Tabellenformatierung]]-->
</includeonly>