As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Funções de data e hora
<a name="sql-functions-date"></a>

 As funções de data e hora funcionam com datas e horas. Essas funções permitem a extração de componentes específicos de uma data, realizar cálculos e manipular valores de data.

Os identificadores permitidos nessas funções são:
+ YEAR
+ MONTH
+ DAY
+ HOUR
+ MINUTE
+ SECOND


|  **Função**  |  **Assinatura**  |  **Descrição**  | 
| --- | --- | --- | 
|  `NOW`  |   AGORA ()   |  Retorna o timestamp atual com precisão de milissegundos. Ele fornece a hora exata no momento em que é executado em uma consulta.  | 
|  `DATE_ADD`  |  DATE\$1ADD (identificador, intervalo\$1duração, coluna)  |  Retorna a soma de a date/time e um número de days/hours, or of a date/time and date/time intervalos.  | 
|  `DATE_SUB`  |  DATE\$1SUB (identificador, intervalo\$1duração, coluna)  |  Retorna a diferença entre um date/time e um número de days/hours, or between a date/time and date/time intervalos.  | 
|  `TIMESTAMP_ADD`  |  TIMESTAMP\$1ADD (identificador, intervalo\$1duração, coluna)  |  Adiciona um intervalo de tempo, nas unidades de tempo fornecidas, a uma expressão de data e hora.  | 
|  `TIMESTAMP_SUB`  |  TIMESTAMP\$1SUB (identificador, intervalo\$1duração, coluna)  |  Subtrai um intervalo de tempo, nas unidades de tempo fornecidas, de uma expressão de data e hora.  | 
|  `CAST`  |  CAST (expressão AS, padrão TIMESTAMP FORMAT)  |  Converte uma expressão de string em um timestamp usando o padrão de formato especificado. Os padrões comuns incluem `'yyyy-MM-dd HH:mm:ss'` o formato padrão de data e hora. Por exemplo, `SELECT CAST('2023-12-25 14:30:00' AS TIMESTAMP) AS converted_timestamp`.  | 

**Example de uma consulta SQL usando as funções listadas:**  

```
SELECT r.asset_id, r.int_value,
  date_add(DAY, 7, r.event_timestamp) AS date_in_future,
  date_sub(YEAR, 2, r.event_timestamp) AS date_in_past,
  timestamp_add(DAY, 2, r.event_timestamp) AS timestamp_in_future,
  timestamp_sub(DAY, 2, r.event_timestamp) AS timestamp_in_past,
  now() AS time_now
FROM raw_time_series AS r
```