Zum Hauptinhalt springen

DateTime()

Werkzeugklasse zur Durchführung von Datums- und Uhrzeitberechnungen

Signatur

Erstellt eine neue DateTime-Instanz, die das aktuelle Datum und die aktuelle Uhrzeit repräsentiert.

DateTime();

Erstellt eine neue DateTime-Instanz aus einem Zeitstempel in Millisekunden.

DateTime(timestamp: number)

Erstellt eine neue DateTime-Instanz durch das Parsen einer Datumszeichenkette.

DateTime(dateString: string)

Erstellt eine neue DateTime-Instanz für das angegebene Datum um Mitternacht (00:00:00).

DateTime(year: number, month: number, day: number)

Erstellt eine neue DateTime-Instanz für das angegebene Datum und die angegebene Uhrzeit.

DateTime(year: number, month: number, day: number, hour: number, minute: number, second: number)

Parameter

ParameterTypBeschreibung
timestampnumberZeitstempel in Millisekunden seit der Unix-Epoche
dateStringstringZeichenkettendarstellung des zu parsenden Datums
yearnumberJahreswert (z. B. 2024)
monthnumberMonatswert (1-12)
daynumberTag des Monats (1-31)
hournumberStunde des Tages (0-23)
minutenumberMinute der Stunde (0-59)
secondnumberSekunde der Minute (0-59)

Rückgabe

  • Typ: DateTime
  • Eine neue DateTime-Instanz.

Beispiele

-- DateTime-Objekt für das aktuelle Datum und die aktuelle Uhrzeit erstellen
local now = DateTime()
toast("Aktuelle DateTime: " .. now:format("yyyy-MM-dd HH:mm:ss"))

-- DateTime-Objekt aus einem Zeitstempel erstellen
local timestamp = 1678886400000 -- 15. März 2023 00:00:00 UTC
local dateFromTimestamp = DateTime(timestamp)
toast("DateTime aus Zeitstempel: " .. dateFromTimestamp:format("yyyy-MM-dd HH:mm:ss"))

-- DateTime-Objekt aus einer Datumszeichenkette erstellen
local dateFromString = DateTime("2023-03-15 10:30:00")
toast("DateTime aus Zeichenkette: " .. dateFromString:format("yyyy-MM-dd HH:mm:ss"))

-- DateTime-Objekt für ein bestimmtes Datum erstellen
local specificDate = DateTime(2023, 3, 15)
toast("Bestimmtes Datum: " .. specificDate:format("yyyy-MM-dd HH:mm:ss"))

-- DateTime-Objekt für ein bestimmtes Datum und eine bestimmte Uhrzeit erstellen
local specificDateTime = DateTime(2023, 3, 15, 14, 45, 30)
toast("Bestimmte DateTime: " .. specificDateTime:format("yyyy-MM-dd HH:mm:ss"))