Categorias:: Funções de data e hora

TRUNC¶

Trunca uma data, hora ou carimbo de data/hora para a parte especificada. Por exemplo, truncar o carimbo de data/hora até o trimestre retorna o carimbo de data/hora correspondente à meia-noite do primeiro dia do trimestre original do carimbo de data/hora.

Fornece uma sintaxe alternativa para DATE_TRUNC (inverte os dois argumentos).

Nota

Esta função é sobrecarregada; também pode ser usada como uma função numérica para arredondar expressões numéricas para menos.

Sintaxe¶

TRUNC( <date_or_time_expr>, <date_or_time_part> )

Copy

Argumentos¶

date_or_time_expr Esta deve ser uma expressão que avalia como um DATE ou um TIMESTAMP.
date_or_time_part Este deve ser um dos valores listados em Partes de data e hora com suporte.

Retornos¶

A função sempre retorna DATE.

A data está completa (ano, mês e dia). O truncamento não remove o mês e o dia; em vez disso, ele os define para a data mais próxima no período especificado. Por exemplo, TRUNC(TO_DATE('2013-08-05'), 'QUARTER') retorna a primeira data no terceiro trimestre do ano de 2013, que é 1º de julho de 2013.

Notas de uso¶

Para notas de uso adicionais, consulte Notas de uso para DATE_TRUNC.

Exemplos¶

Os exemplos abaixo mostram o truncamento da data. Observe que em todos os casos o resultado é uma data completa, incluindo mês e dia, mas é a primeira data no período especificado por date_or_time_expr e date_or_time_part.

select trunc(to_date('2013-05-08'), 'MONTH');
+---------------------------------------+
| TRUNC(TO_DATE('2013-05-08'), 'MONTH') |
|---------------------------------------|
| 2013-05-01                            |
+---------------------------------------+

Copy

select trunc(to_date('2013-05-08'), 'QUARTER');
+-----------------------------------------+
| TRUNC(TO_DATE('2013-05-08'), 'QUARTER') |
|-----------------------------------------|
| 2013-04-01                              |
+-----------------------------------------+

Copy

select trunc(to_date('2013-05-08'), 'YEAR');
+--------------------------------------+
| TRUNC(TO_DATE('2013-05-08'), 'YEAR') |
|--------------------------------------|
| 2013-01-01                           |
+--------------------------------------+

Copy