Wikipedia:Lua/Modul/DateTime

Vorlagenprogrammierung	Diskussionen	Lua			Test	Unterseiten
		Modul	Deutsch	English		Modul:	Dokumentation

DateTime – Modul mit Funktionen für die Interpretation von Datums- und Zeitangaben, sowie ihre Berechnung und Vergleich, schließlich die Darstellung.

Das Modul ist für solche Aufgaben vorgesehen, die die Leistungsfähigkeit der Parserfunktionen #time und #timel übersteigen.

Alle zweifelsfreien Datumsformate für den deutsch- und englischsprachigen Raum werden bei der Eingabe unterstützt.

Funktionen für Vorlagen

format

Formatiere eine Datums-/Zeitangabe.

Parameter (alle optional; umgebender Whitespace wird ignoriert):

1

Angabe von Datum oder Uhrzeit

now – jetzt (Vorgabe)

Interpretierbares Format; Beispiele siehe Testseite.

Führendes # gibt die Anzahl der Sekunden seit 1. Januar 1970 (UTC) an (Unix-Zeit).

  usw. werden als Leerzeichen behandelt.

2

Formatspezifikation

wie für #time
gemäß besonderer Vereinbarung

lang

Besondere Sprachbezeichnung (Kürzel gemäß ISO 639)

Mögliche Werte: de (Vorgabe); de-AT sowie wohl alle Sprachen, in denen eine Wikipedia existiert. Bei unbekannter Sprachvariante wird auf die Basissprache zurückgefallen. Groß- und Kleinschreibung wird ignoriert.

shift

Verschiebung

wie für #time (2. Parameter)

Mögliche Werte: 1 day oder 2 years ago sowie -5 months usw.
Die Angaben tomorrow oder yesterday wie auch next Friday sind nur möglich, wenn sich 1 auf now bezieht.
Anders als bei #time ist ansonsten auch die Angabe eines Basiszeitpunkts möglich.
Eine einzelne Zahl ohne Maßeinheit wird als Anzahl von Sekunden interpretiert, positiv/negativ, muss nicht ganzzahlig sein (Dezimalpunkt).
Wie bei #time kann es bei Überschreitung von Monats- oder Jahresgrenzen durch andere als glatte Intervalle zu unvorhergesehenen Ergebnissen kommen; was der 31. Mai plus 1 Monat sein soll, bleibt ohnehin unklar.

noerror

Fehlermeldung unterdrücken

Mögliche Werte: nichts oder 0 (Vorgabe); 1 sonst
Standardmäßig wird eine mit class="error" markierte Meldung gezeigt.
Wenn sich bei noerror=1 ein leerer Wert ergibt, war der Eingabewert ungültig.

Ergebnis: Formatierte Angabe.

Anders als bei der Parserfunktion führen fehlende Angaben in der Eingabe jedoch nicht dazu, dass es zu Fehlern oder unerwünschten Ergänzungen kommt; sondern der Ausgabewert wird möglichst auf die Elemente beschränkt, die auch angegeben wurden.

errCat: Ein oder mehrere Titel von Wartungskategorien.; Die Titel sind durch Pipe-Symbol (per {{!}}) zu trennen.; Beispiel: errCat=Wikipedia:Vorlagenfehler/Parameter:Datum

Standardformate

Zusätzliche Formatspezifikationen über `#time` hinaus (nur deutschsprachig)
Bezeichner	Beispielausgabe	geschütztes Leerzeichen zwischen		Monatsname bis 4 Buchstaben nicht abkürzen
Bezeichner	Beispielausgabe	Punkt und Monatsname	Monatsname und Jahreszahl
keine Angabe	→ISO-T
`ISO`	`2024-10-26 13:07:53+02:00`
`ISO-T`	`2024-10-26T13:07:53+02:00`
`timestamp`	`20241026010753`
`T._Monat JJJJ hh:mm:ss Zone`	`26. Oktober 2024 13:07:53 (MESZ)`	×
`dewiki`	`13:07, 26. Okt. 2024`
`T._Monat JJJJ`	`26. Oktober 2024`
`T._Mon JJJJ`	`26. Okt. 2024`
`T._Mon_JJJJ`	`26. Okt. 2024`		×
`T._Mon4 JJJJ`	`26. Okt. 2024`			×
`T._Mon4_JJJJ`	`26. Okt. 2024`		×
`T._Mon4 JJJJ hh:mm:ss`	`26. Okt. 2024 13:07:53`
`T._Mon4 JJJJ hh:mm:ss Zone`	`26. Okt. 2024 13:07:53 (MESZ)`
`T. Mon JJJJ`	`26. Okt. 2024`
`TT.MM.JJJJ`	`26.10.2024`
`T.M.JJJJ`	`26.10.2024`
$JulianDate$	`2460610.0466088`
$JulianDate,$	`2.460.610,0466088`
$"$ Text	`Text`

Mehrere Darstellungsformate

Es ist möglich, denselben Zeitpunkt mehrfach in unterschiedlichen Formaten und somit ggf. anderen Zeitrechnungen, Kalendern, Zeitzonen darzustellen.

Dazu müssen die Formatangaben durch ||| voneinander getrennt werden.
In der Vorlagenprogrammierung wird das durch {{!}}{{!}}{{!}} erreicht.
Die Komponenten werden nahtlos aneinandergefügt.
Mit dem Sonderformat $"$ können Textblöcke eingestreut werden, damit Schlüsselwörter als Formate nutzbar sind. Gleichzeitig lässt sich die Darstellung entsprechend gliedern und beschriften.
Die Verwendung ist etwas komplizierter und zielt auf entsprechende Vorlagenprogrammierungen ab.

lt le eq ne ge gt

Diese Funktionen vergleichen den ersten und zweiten Parameter miteinander; als Datum/Zeit in beliebigem Format (oder „jetzt“ wenn nicht angegeben).

Funktionswert ist 1, wenn die Bedingung erfüllt ist, sonst „nichts“.

Die Funktionen sind im Einzelnen:

lt – kleiner
le – kleiner oder gleich
eq – gleich
ne – ungleich
ge – größer oder gleich
gt – größer

failsafe

Diese Funktion gibt die Versionsbezeichnung des Moduls aus.

{{#invoke:DateTime|failsafe}} ergibt 2023-10-03

Mit Angabe eines Parameters als Datum im ISO-Format wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt.

{{#invoke:DateTime|failsafe|2001-01-01}} ergibt: »2023-10-03«
{{#invoke:DateTime|failsafe|2099-01-01}} ergibt: »« – leer, falls Mindestversionsbezeichnung nicht erfüllt

Ist dieser Zusatzparameter das Schlüsselwort wikidata, so ist der Wert die auf Wikidata registrierte Versionsbezeichnung (2023-10-03) oder lokal, falls dort keine gefunden.

Ist der Zusatzparameter das Zeichen ~, so ist das Ergebnis leer, falls Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung besteht (2023-10-03).

Beispiele (Testseiten)

Testseiten illustrieren praktische Beispiele.

Allgemeine Hinweise zur Einbindung von Modulen

Eine Einbindung erfolgt jeweils im Format

{{#invoke: DateTime | Funktionsname | Wert1 | Wert2 | NameX=Wert … }}

Die Parameter können wie bei Vorlagen benannt oder unbenannt sein; deren Regeln gelten analog.

Wenn unbekannte Zeichenketten von außen kommen (als Vorlagenparameter), sollte immer mit der Form 1=Wert gearbeitet werden.

Zu allgemeinen Problemen beachte die Abhilfen wie bei Vorlagen.

Wenn in einer Vorlage ein Modul verwendet wird, sollte auch immer die Vorlage:Dokumentation/Lua in der Dokumentationsseite eingebunden werden.

Das gibt einem Programmierer Aufschluss, dass ein Lua-Modul benutzt wird, welche/s und ggf. welche Einzelfunktion daraus, und verlinkt auf die Dokumentation.
Die Modul-Dokumentationen bekommen ein Link, in welchen Vorlagen sie eingesetzt werden, und wo bei eventuellen Funktionsänderungen Anpassungen erforderlich werden.
Die Vorlage wird zur Übersicht kategorisiert in Kategorie:Vorlage:mit Lua-Programmierung.

Zu weiteren Informationen siehe Hilfe:Lua.

Bei Problemen wende dich bitte an die Vorlagen-Werkstatt, in schweren Fällen hilft auch die Lua-Werkstatt.