EXTRACT¶

Sintaxe¶

EXTRACT( <date_or_time_part> FROM <date_time_or_timestamp_expr> ) 

EXTRACT( <date_or_time_part> , <date_time_or_timestamp_expr> ) 

Argumentos¶

date_or_time_part

A unidade de tempo. Deve ser um dos valores listados em Partes de data e hora com suporte (por exemplo, month). O valor pode ser uma cadeia de caracteres literal ou pode estar sem aspas (por exemplo, 'month' ou month).

• Quando date_or_time_part é week (ou qualquer uma de suas variações), a saída é controlada pelo parâmetro de sessão WEEK_START.

• Quando date_or_time_part for dayofweek ou yearofweek (ou qualquer uma de suas variações), a saída será controlada pelos parâmetros de sessão WEEK_OF_YEAR_POLICY e WEEK_START.

Para obter mais informações, incluindo exemplos, consulte Semanas do ano e dias úteis.

date_time_or_timestamp_expr

Uma data, uma hora ou um carimbo de data/hora, ou uma expressão que pode ser avaliada como uma data, uma hora ou um carimbo de data/hora.

Retornos¶

Retorna um valor de tipo de dados NUMBER.

Notas de uso¶

Atualmente, quando date_or_timestamp_expr é um valor DATE, os seguintes valores date_or_time_part não são compatíveis:

• epoch_millisecond

• epoch_microsecond

• epoch_nanosecond

Outras partes de data e hora (incluindo epoch_second) são compatíveis.

Exemplos¶

Especifique a parte year para extrair o ano de um carimbo de data/hora:

SELECT EXTRACT(year FROM TO_TIMESTAMP('2024-04-10T23:39:20.123-07:00')) AS YEAR; 

+------+ | YEAR | |------| | 2024 | +------+ 

Use EXTRACT com a função DECODE e a parte dayofweek para retornar o nome completo do dia atual da semana:

SELECT DECODE(EXTRACT(dayofweek FROM SYSTIMESTAMP()), 1, 'Monday', 2, 'Tuesday', 3, 'Wednesday', 4, 'Thursday', 5, 'Friday', 6, 'Saturday', 7, 'Sunday') AS DAYOFWEEK; 

+-----------+ | DAYOFWEEK | |-----------| | Thursday | +-----------+