Diese Seite wurde mit KI-Unterstützung aus dem Englischen übersetzt. Bei Abweichungen ist die englische Version maßgeblich.
Datumsmodifikatoren
Überblick
In den Datetime-Funktionen von StackQL können auf einen Datums- oder Zeitwert null oder mehr Modifikatoren folgen, die das Datum und/oder die Uhrzeit verändern. Jeder Modifikator ist eine Transformation, die auf den Zeitwert links von ihm angewendet wird. Modifikatoren werden der Reihe nach von links nach rechts angewendet. Die verfügbaren Modifikatoren sind:
| Modifikator | Beschreibung |
|---|---|
| NNN day(s) | Addiert ±NNN Tage zu Datum und Uhrzeit |
| NNN hour(s) | Addiert ±NNN Stunden zu Datum und Uhrzeit |
| NNN minute(s) | Addiert ±NNN Minuten zu Datum und Uhrzeit |
| NNN[.NNNN] second(s) | Addiert ±NNN Sekunden zu Datum und Uhrzeit bzw. zieht sie ab |
| NNN month(s) | Addiert ±NNN Monate zu Datum und Uhrzeit |
| NNN year(s) | Addiert ±NNN Jahre zu Datum und Uhrzeit |
| start of month | Zurück zum Beginn des Monats |
| start of year | Zurück zum Beginn des Jahres |
| start of day | Zurück zum Beginn des Tages |
| weekday N | Verschiebt ein Datum vorwärts auf das nächste Datum, dessen Wochentagsnummer N ist |
| localtime | Gibt die lokale Zeit zurück |
| utc | Gibt die UTC-Zeit zurück |
| unixepoch | Unix-Zeit |
Beispiele
Das aktuelle Datum und die aktuelle Uhrzeit mit dem Zeitwert now zurückgeben
SELECT name, date('now') as date, time('now') as time
FROM google.storage.buckets WHERE project = 'stackql';
UTC mit dem Modifikator localtime in lokale Zeit umwandeln
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
Eine lokale Zeit in UTC umwandeln
Der Modifikator utc behandelt seine Eingabe als lokale Zeit auf dem Rechner, auf dem StackQL läuft, und wandelt sie in UTC um. Ein Wert, der bereits in UTC vorliegt, etwa 'now' oder ein Zeitstempel mit dem Suffix Z, wird unverändert zurückgegeben.
SELECT datetime('2026-11-20 17:59:24', 'utc') as utc_time;
Auf einem Rechner mit der Zeitzone UTC+11 gibt diese Abfrage 2026-11-20 06:59:24 zurück.
Ein Datum relativ zu einem anderen Datum berechnen
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
Den nächsten angegebenen Wochentag nach einem bestimmten Datum ermitteln
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
Den Monatsbeginn für ein bestimmtes Datum ermitteln
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
Einen Unix-Zeitstempel in einen Datetime-Wert umwandeln
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';