Pular para o conteúdo principal
Página traduzida

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.

Modificadores de data

Visão geral​

Nas funções de data e hora do StackQL, um valor de data ou hora pode ser seguido de zero ou mais modificadores que alteram a data, a hora ou ambas. Cada modificador é uma transformação aplicada ao valor de tempo à sua esquerda. Os modificadores são aplicados em ordem, da esquerda para a direita. Os modificadores disponíveis são os seguintes:

ModificadorDescrição
NNN day(s)Adicionar ±NNN dias a uma data e hora
NNN hour(s)Adicionar ±NNN horas a uma data e hora
NNN minute(s)Adicionar ±NNN minutos a uma data e hora
NNN[.NNNN] second(s)Adicionar ±NNN segundos a uma data e hora ou subtraí-los dela
NNN month(s)Adicionar ±NNN meses a uma data e hora
NNN year(s)Adicionar ±NNN anos a uma data e hora
start of monthRetroceder ao início do mês
start of yearRetroceder ao início do ano
start of dayRetroceder ao início do dia
weekday NAvançar uma data até a próxima data cujo número do dia da semana seja N
localtimeRetornar a hora local
utcRetornar a hora UTC
unixepochTempo Unix

Exemplos​

Retornar a data e a hora atuais com o valor de tempo now​

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

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 um valor de data e hora em UTC​

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

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

Para converter um valor de data e hora em um carimbo de data/hora de época Unix, consulte STRFTIME. Para calcular diferenças entre dois objetos de data e hora, consulte STRFTIME ou JULIANDAY.