Datumsmodifikatoren

Überblick

Auf die Datums- oder Zeitwerte der Datetime-Funktionen in StackQL können 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 Modifikator 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';

Datetime in UTC umwandeln

SELECT name, timeCreated,
datetime('now', 'utc') as now_utc
FROM google.storage.buckets WHERE project = 'stackql';

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';

tipp

Zum Umwandeln eines Datetime-Werts in einen Unix-Epoch-Zeitstempel siehe STRFTIME. Zum Berechnen von Differenzen zwischen zwei Datetime-Objekten siehe STRFTIME oder JULIANDAY.