Quelltext der Seite Vorlage:DatumZelle/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "description": "Formatierung eines sortierbaren Datums in Tabellen<noexport>.<br />
Ohne Pipe-Symbol direkt an den Zellenbeginn anzuschließen.</noexport>",
  "params": {
     "1":
        { "label":       "Datum/Zeit",
          "description": "Format beliebig (deutsch/englisch), sofern eindeutig interpretierbar. Einzelner Tag, auch unspezifischer Monat oder Tag im Monat ohne Jahr usw.<noexport><br />
[[#preAd|Bekannte Schlüsselwörter]] dürfen vorangestellt werden.<br />
Mit dem Zeichen <code>∞</code> wird ein fiktives Datum ''hinter'' allen Daten eingeordnet, aber nichts optisch dargestellt; analog <code>-∞</code> ''vor'' allen Daten (typografisches oder ASCII-Minuszeichen sowie Pluszeichen zulässig).</noexport>",
          "type":        "date",
          "suggested":   true,
          "default":     "jetzt",
          "example":     "{{#time:Y-m-d}}" },
     "2":
        { "label":       "Format",
          "description": "Darstellungsformat; [[Wikipedia:Lua/Modul/DateTime#formatspec|bekannte Schablone]] oder [[Hilfe:Parserfunktionen/Datum und Zeit#time|frei programmierbare Formatspezifikation]]<noexport>.<br />
Der Wert „<code>-</code>“ unterdrückt die optische Darstellung.</noexport>",
          "type":        "line",
          "required":    false,
          "default":     "T._Mon4 JJJJ",
          "example":     "T.M.JJJJ" },
     "br":
        { "label":       "Zeilen&shy;umbruch",
          "description": "Im Standardformat Jahreszahl ohne Zeilenumbruch an den Monat anschließen. Hinweis: Wegen zunehmendem Abruf über Mobiltelefone sollte besser die Möglichkeit bleiben, eine Spalte möglichst schmal darzustellen.",
          "type":        "boolean",
          "required":    false,
          "default":     "0",
          "example":     "1" },
     "kurz":
        { "label":       "abkürzen",
          "description": "Monatsnamen auf maximal vier Zeichen kürzen",
          "type":        "boolean",
          "required":    false,
          "default":     "1",
          "example":     "0" },
     "link":
        { "label":       "verlinken",
          "description": "Tag im Monat sowie Jahreszahl verlinken (erst ab dem Jahr 1582 sinnvoll)",
          "type":        "boolean",
          "required":    false,
          "default":     "0",
          "example":     "1" },
     "target":
        { "label":       "Wikilink",
          "description": "Wiki-Seite verlinken",
          "type":        "wiki-page-name",
          "required":    false,
          "example":     "Wikipedia:Hauptseite" },
     "url":
        { "label":       "URL",
          "description": "Externe Seite verlinken",
          "type":        "url",
          "required":    false,
          "example":     "http://www.example.org/ " },
     "ISO":
        { "label":       "",
          "description": "Statt Alltagsformat [[ISO 8601]] zur Darstellung",
          "type":        "boolean",
          "required":    false,
          "default":     "0",
          "example":     "1" },
     "fett":
        { "label":       "Fettschrift",
          "description": "Die Angabe „1“ zeigt das Datum in Fettschrift an",
          "type":        "boolean",
          "suggested":   false,
          "default":     "0",
          "example":     "1" },
     "kursiv":
        { "label":       "Kursivschrift",
          "description": "Die Angabe „1“ zeigt das Datum in Kursivschrift an",
          "type":        "boolean",
          "suggested":   false,
          "default":     "0",
          "example":     "1" },
     "de-AT":
        { "label":       "Öster&shy;reich",
          "description": "österreichische Darstellung des Januar (das ist: „[[Jänner]]“)",
          "type":        "boolean",
          "required":    false,
          "default":     "0",
          "example":     "1",
          "aliases":     [ "AT" ] },
     "type":
        { "label":       "Sortier&shy;modus",
          "description": "Kennwort für die Spalte, kann bis auf den ersten Buchstaben abgekürzt werden; effektiver Sortiermodus",
          "type":        "line",
          "required":    false,
          "suggestedvalues": [
            { "code":  "date",
              "label": "Tagesdatum" },
            { "code":  "isoDate",
              "label": "Datum gemäß [[ISO 8601]] (mit Uhrzeiten und Antike)" },
            { "code":  "usLongDate",
              "label": "US-Notation, aber bei uns kaum anwendbar" }
                             ],
          "default":     "date",
          "example":     "iso" },
     "pre":
        { "label":       "Präfix",
          "description": "Kurzes Präfix<noexport>.<br />
Wird ohne Zeilenumbruch mit der vollständigen Zeitangabe verbunden; dazwischen normaler Weißraum.<br />
Kann insbesondere ein [[#preAd|bekanntes Schlüsselwort]] spezifizieren</noexport>",
          "type":        "content",
          "required":    false,
          "example":     "um" },
     "post":
        { "label":       "Postfix",
          "description": "Kurzes Postfix<noexport>.<br />
Wird ohne Zeilenumbruch mit dem Datum verbunden; dazwischen normaler Weißraum.</noexport>",
          "type":        "content",
          "required":    false,
          "example":     "–" },
     "pad":
        { "label":       "Aus&shy;richtung",
          "description": "Versuch einer Ausrichtung von einstelligen Tagesdaten",
          "type":        "boolean",
          "required":    false,
          "default":     "0",
          "example":     "1" },
     "rowspan":
        { "label":       "",
          "description": "Tabellen-Attribut: Anzahl der Zeilen",
          "type":        "number",
          "required":    false,
          "example":     "2" },
     "colspan":
        { "label":       "",
          "description": "Tabellen-Attribut: Anzahl der Spalten",
          "type":        "number",
          "required":    false,
          "example":     "3" },
     "class":
        { "label":       "",
          "description": "Zusätzliche Klassenbezeichner, etwa zur CSS-Zuordnung (der gesamten Tabellenzelle) als Leerzeichen-getrennte Aufzählung",
          "type":        "line",
          "required":    false,
          "example":     "hintergrundfarbe8" },
     "style":
        { "label":       "CSS",
          "description": "CSS-Eigenschaften (der gesamten Tabellenzelle)",
          "type":        "line",
          "required":    false,
          "example":     "color:#800080;text-align:right" },
     "id":
        { "label":       "Fragment",
          "description": "[[Fragmentbezeichner]] („Anker“, Sprungziel)<noexport>.<br />
Günstiger wäre es, die gesamte Tabellenzeile mit einem Fragmentbezeichner zu versehen.</noexport>",
          "type":        "line",
          "required":    false,
          "example":     "Gründung" }
            }
}
|TOC=1}}

== Kopiervorlagen ==
<syntaxhighlight lang="wikitext">
{{DatumZelle|}}
{{DatumZelle | |  |br= |kurz= |link= |ISO= |de-AT= |type=|pre= |pad= |post= |rowspan= |colspan= |class= |style= |id=}}
</syntaxhighlight>

== {{Anker|preAd}} Schlüsselwörter (adverbial) ==
Die nachstehenden Schlüsselwörter werden erkannt und bei ungenauen Angaben ausgewertet:
{{#invoke:Sort/cellDate|furnish}}

== Beispiele ==
{{#tag:syntaxhighlight
|{{DatumZelle{{!}}{{#time:Y-m-d}}{{!}}kurz=0}}
|lang=wikitext}}
{{DatumZelle|{{#time:Y-m-d}}|kurz=0}}

{{#tag:syntaxhighlight
|{{DatumZelle{{!}}{{#time:Y-m-d}}{{!}}T.M.JJJJ}}
|lang=wikitext}}
{{DatumZelle|{{#time:Y-m-d}}|T.M.JJJJ}}

{{#tag:syntaxhighlight
|{{DatumZelle{{!}}0044-03-15 v.Chr.{{!}}type=i}}
|lang=wikitext}}
{{DatumZelle|0044-03-15 v.Chr.|type=i}}

{{#tag:syntaxhighlight
|{{DatumZelle{{!}}{{#time:Y-m-d}}{{!}}-}} Heute.
|lang=wikitext}}
{{DatumZelle|{{#time:Y-m-d}}|-}} Heute.

== Hinweise ==

=== Antike Perioden ===
Sollen Zeitpunkte vor dem Jahr 100 n. Chr. liegen, so muss das ISO-System <code>[[#templatedata:type|type]]=i</code> und ggf. <code style="white-space:nowrap">data-sort-type="isoDate"</code> verwendet werden. Das Alltagsformat wird erst ab dem Jahr 100 ausgewertet.

=== Parametrisierung ===
Die Parametrisierung ist speziell auf den [[H:VE|VisualEditor]] ausgerichtet; sie verwendet deshalb logische Schalter statt kryptischer Kürzel. Logische Schalter können einfach angekreuzt oder deaktiviert werden.

=== data-sort-value ===
Für den Sortierschlüssel wird die Methode <code style="white-space:nowrap">[[Hilfe:Tabellen/Sortierung#data-sort-value|data-sort-value]]</code> verwendet, wodurch der Sortierschlüssel nicht zum Bestandteil des Inhalts der Zelle wird.

== Wartung ==
{{Vorlagenfehler-Wartungskat |Vorlage=Parameter:Datum |ignoriere=3}}

{{Navigationsleiste Vorlagen zur Tabellensortierung}}
<includeonly>
{{Lua-Vorlage|Sort/cellDate #f|TemplUtl #faculty|Vorlage:Anker #feasible}}

[[Kategorie:Vorlage:Tabellenformatierung]]
[[Kategorie:Vorlage:Datumsberechnung]]
</includeonly>