# Modificadores de data

> Modificadores de data e hora no StackQL: deslocar resultados de DATE, TIME, DATETIME, JULIANDAY e STRFTIME em dias, meses ou anos, ao início de um período, a um dia da semana etc.

Source: https://stackql.io/pt-br/language-spec/functions/datetime/date_modifiers

## 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`

```sql
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`

```sql
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

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

### Calcular uma data relativa a outra data

```sql
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

```sql
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

```sql
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

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

:::tip 

Para converter um valor de data e hora em um carimbo de data/hora de época Unix, consulte [**STRFTIME**](/language-spec/functions/datetime/strftime).  Para calcular diferenças entre dois objetos de data e hora, consulte [**STRFTIME**](/language-spec/functions/datetime/strftime) ou [**JULIANDAY**](/language-spec/functions/datetime/julianday).

:::
