Modificadores de fecha

Descripción general

Los valores de fecha u hora de las funciones de fecha y hora de StackQL pueden ir seguidos de cero o más modificadores que alteran la fecha, la hora o ambas. Cada modificador es una transformación que se aplica al valor de tiempo situado a su izquierda. Los modificadores se aplican en orden, de izquierda a derecha. Los modificadores disponibles son los siguientes:

Modificador	Descripción
NNN day(s)	Sumar ±NNN días a una fecha y hora
NNN hour(s)	Sumar ±NNN horas a una fecha y hora
NNN minute(s)	Sumar ±NNN minutos a una fecha y hora
NNN[.NNNN] second(s)	Sumar ±NNN segundos a una fecha y hora o restarlos de ella
NNN month(s)	Sumar ±NNN meses a una fecha y hora
NNN year(s)	Sumar ±NNN años a una fecha y hora
start of month	Retroceder al inicio del mes
start of year	Retroceder al inicio del año
start of day	Retroceder al inicio del día
weekday N	Avanzar una fecha hasta la siguiente fecha cuyo número de día de la semana sea N
localtime	Devolver la hora local
utc	Devolver la hora UTC
unixepoch	Tiempo Unix

Ejemplos

Devolver la fecha y hora actuales con el modificador now

SELECT name, date('now') as date, time('now') as time
FROM google.storage.buckets WHERE project = 'stackql';

Convertir UTC a hora local con el modificador localtime

SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';

Convertir una fecha y hora a UTC

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

Calcular una fecha relativa a otra fecha

SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';

Obtener el siguiente día de la semana especificado posterior a una fecha dada

SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';

Obtener el inicio del mes de una fecha dada

SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';

Convertir una marca de tiempo de Unix en un valor de fecha y hora

SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';

consejo

Para convertir un valor de fecha y hora en una marca de tiempo de época Unix, consulte STRFTIME. Para calcular diferencias entre dos objetos de fecha y hora, consulte STRFTIME o JULIANDAY.