Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.
DATETIME
Retorna um valor de data e hora calculado a partir de um valor de data e hora de entrada e de zero ou mais modificadores.
Veja também:
[SELECT] [ Modificadores de data ]
Sintaxe
SELECT DATETIME(datetime_expression [, modifier, ...]) FROM <multipartIdentifier>;
Argumentos
datetime_expression
O valor de data e hora.
modifier
Zero ou mais modificadores a serem aplicados à datetime_expression. Para obter mais informações sobre modificadores, consulte Modificadores de data
Valor(es) retornado(s)
Retorna uma string que representa o valor de data e hora da datetime_expression de entrada com o modifier aplicado.
Exemplos
Converter UTC em hora local com o modificador localtime
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
Converter uma hora local em UTC
O modificador utc trata a entrada como uma hora local na máquina que executa o StackQL e a converte em UTC. Um valor que já está em UTC, como 'now' ou um carimbo de data/hora com o sufixo Z, é retornado sem alterações.
SELECT datetime('2026-11-20 17:59:24', 'utc') as utc_time;
Em uma máquina cujo fuso horário é UTC+11, esta consulta retorna 2026-11-20 06:59:24.
Calcular uma data relativa a outra data
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
Obter o próximo dia da semana especificado após uma data
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
Obter o início do mês de uma data
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
Converter um carimbo de data/hora Unix em um valor de data e hora
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';
Para obter mais informações, consulte https://www.sqlite.org/lang_datefunc.html