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:
| Modificador | Descriçã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 month | Retroceder ao início do mês |
| start of year | Retroceder ao início do ano |
| start of day | Retroceder ao início do dia |
| weekday N | Avançar uma data até a próxima data cujo número do dia da semana seja N |
| localtime | Retornar a hora local |
| utc | Retornar a hora UTC |
| unixepoch | Tempo 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';