EXTRACT¶

Sintaxe¶

EXTRACT( <date_or_time_part> FROM <date_interval_time_or_timestamp_expr> )

EXTRACT( <date_or_time_part> , <date_interval_time_or_timestamp_expr> )

Argumentos¶

date_or_time_part

The unit of time. Must be one of the values listed in Partes de data e hora com suporte (for example, month). The value can be a string literal or can be unquoted (for example, 'month' or 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_interval_time_or_timestamp_expr

A date, an interval, a time, or a timestamp, or an expression that can be evaluated to one of those data types.

Retornos¶

Retorna um valor de tipo de dados NUMBER.

Notas de uso¶

• When date_interval_time_or_timestamp_expr is a year-month interval value, the supported date_or_time_part values are year and month.

• When date_interval_time_or_timestamp_expr is a day-time interval value, the supported date_or_time_part values are day, hour, minute, second, and nanosecond.

• Currently, when date_interval_time_or_timestamp_expr is a DATE value, the following date_or_time_part values aren’t supported:

  • 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  |
+-----------+