Categorias:

Funções de conversão , Funções de data e hora

TO_DATE , DATE

Converte uma expressão de entrada em uma data:

  • Para uma expressão VARCHAR, o resultado da conversão da cadeia de caracteres em uma data.

  • Para uma expressão TIMESTAMP, a data do carimbo de data/hora.

  • Para uma expressão VARIANT:

    • Se VARIANT contiver uma cadeia de caracteres, é realizada uma conversão da cadeia de caracteres.

    • Se VARIANT contiver uma data, o valor da data é preservado como está.

    • Se VARIANT contiver um valor nulo JSON, a saída será NULL.

  • Para a entrada NULL, a saída será NULL.

Para todos os outros valores, é gerado um erro de conversão.

Consulte também:

TRY_TO_DATE

Sintaxe

TO_DATE( <string_expr> [, <format> ] ) TO_DATE( <timestamp_expr> ) TO_DATE( '<integer>' ) TO_DATE( <variant_expr> ) DATE( <string_expr> [, <format> ] ) DATE( <timestamp_expr> ) DATE( '<integer>' ) DATE( <variant_expr> )
Copy

Argumentos

Obrigatório:

Uma das opções:

string_expr

Cadeia de caracteres da qual se pode extrair uma data. Por exemplo: '2024-01-31'.

timestamp_expr

Uma expressão TIMESTAMP. A parte de DATE do valor TIMESTAMP é extraída.

'integer'

Uma expressão que avalia como uma cadeia de caracteres contendo um número inteiro. Por exemplo: '15000000'. Dependendo da magnitude da cadeia de caracteres, ela pode ser interpretada como segundos, milissegundos, microssegundos ou nanossegundos. Para obter mais detalhes, consulte as notas de uso desta função.

variant_expr

Uma expressão do tipo VARIANT.

O VARIANT deve conter um dos seguintes:

  • Uma cadeia de caracteres da qual se pode extrair uma data.

  • Uma data.

  • Uma cadeia de caracteres contendo um número inteiro que representa o número de segundos ou milissegundos.

Embora TO_DATE aceite um valor TIMESTAMP, não aceita um valor TIMESTAMP dentro de um VARIANT.

Opcional:

format

Especificador do formato de data para string_expr ou AUTO, que especifica que o Snowflake detecta automaticamente o formato a ser utilizado. Para obter mais informações, consulte Formatos de data e hora em funções de conversão.

O valor padrão é o valor atual do parâmetro de sessão DATE_INPUT_FORMAT (padrão AUTO).

Retornos

O tipo de dados do valor retornado é DATE. Se a entrada for NULL, retorna NULL.

Notas de uso

  • O formato de exibição das datas na saída é determinado pelo parâmetro de sessão DATE_OUTPUT_FORMAT (padrão YYYY-MM-DD).

  • Se o formato do parâmetro de entrada for uma cadeia de caracteres que contenha um número inteiro:

    • Depois que a cadeia de caracteres é convertida em um inteiro, o inteiro é tratado como um número de segundos, milissegundos, microssegundos ou nanossegundos após o início da época Unix (1970-01-01 00:00:00.000000000 UTC).

      • Se o número inteiro for inferior a 31536000000 (o número de milissegundos em um ano), então o valor é tratado como um número de segundos.

      • Se o valor for maior ou igual a 31536000000 e menor que 31536000000000, então o valor é tratado como milissegundos.

      • Se o valor for maior ou igual a 31536000000000 e menor que 31536000000000000, então o valor é tratado como microssegundos.

      • Se o valor for maior ou igual a 31536000000000000, então o valor é tratado como nanossegundos.

    • Se mais de uma linha for avaliada (por exemplo, se a entrada for o nome da coluna de uma tabela que contém mais de uma linha), cada valor será examinado independentemente para determinar se o valor representa segundos, milissegundos, microssegundos ou nanossegundos.

Exemplos

Os exemplos a seguir usam as funções TO_DATE e DATE.

Exemplo básico

SELECT TO_DATE('2024-05-10'), DATE('2024-05-10');
Copy
+-----------------------+--------------------+ | TO_DATE('2024-05-10') | DATE('2024-05-10') | |-----------------------+--------------------| | 2024-05-10 | 2024-05-10 | +-----------------------+--------------------+

Exemplo que extrai a data de um carimbo de data/hora

A função TO_DATE aceita valores TIMESTAMP e cadeias de caracteres no formato TIMESTAMP, mas descarta as informações de horário (horas, minutos e assim por diante).

Criar e carregar a tabela:

CREATE OR REPLACE TABLE date_from_timestamp(ts TIMESTAMP); INSERT INTO date_from_timestamp(ts) VALUES (TO_TIMESTAMP('2024.10.02 04:00:00', 'YYYY.MM.DD HH:MI:SS'));
Copy

Consulte o valor de TIMESTAMP na tabela:

SELECT ts FROM date_from_timestamp;
Copy
+-------------------------+ | TS | |-------------------------| | 2024-10-02 04:00:00.000 | +-------------------------+

Consulte o valor de TIMESTAMP na tabela usando a função TO_DATE:

SELECT TO_DATE(ts) FROM date_from_timestamp;
Copy
+-------------+ | TO_DATE(TS) | |-------------| | 2024-10-02 | +-------------+

Exemplos que usam diferentes formatos de entrada

Os exemplos a seguir usam as funções TO_DATE e DATE com diferentes especificações de formato de entrada. O formato da data na saída retornada é determinado pela configuração do parâmetro de sessão DATE_OUTPUT_FORMAT.

SELECT TO_DATE('2024.05.10', 'YYYY.MM.DD'), DATE('2024.05.10', 'YYYY.MM.DD');
Copy
+-------------------------------------+----------------------------------+ | TO_DATE('2024.05.10', 'YYYY.MM.DD') | DATE('2024.05.10', 'YYYY.MM.DD') | |-------------------------------------+----------------------------------| | 2024-05-10 | 2024-05-10 | +-------------------------------------+----------------------------------+ 
SELECT TO_DATE('2024-05-10', 'AUTO'), DATE('2024-05-10', 'AUTO');
Copy
+-------------------------------+----------------------------+ | TO_DATE('2024-05-10', 'AUTO') | DATE('2024-05-10', 'AUTO') | |-------------------------------+----------------------------| | 2024-05-10 | 2024-05-10 | +-------------------------------+----------------------------+ 
SELECT TO_DATE('05/10/2024', 'MM/DD/YYYY'), DATE('05/10/2024', 'MM/DD/YYYY');
Copy
+-------------------------------------+----------------------------------+ | TO_DATE('05/10/2024', 'MM/DD/YYYY') | DATE('05/20/2024', 'MM/DD/YYYY') | |-------------------------------------+----------------------------------| | 2024-05-10 | 2024-05-20 | +-------------------------------------+----------------------------------+

Exemplos que usam diferentes formatos de saída

Os exemplos a seguir mostram os resultados das consultas quando o parâmetro de sessão DATE_OUTPUT_FORMAT está definido como DD-MON-YYYY:

ALTER SESSION SET DATE_OUTPUT_FORMAT = 'DD-MON-YYYY';
Copy
SELECT TO_DATE('2024-05-10', 'YYYY-MM-DD'), DATE('2024-05-10', 'YYYY-MM-DD');
Copy
+-------------------------------------+----------------------------------+ | TO_DATE('2024-05-10', 'YYYY-MM-DD') | DATE('2024-05-10', 'YYYY-MM-DD') | |-------------------------------------+----------------------------------| | 10-May-2024 | 10-May-2024 | +-------------------------------------+----------------------------------+ 
SELECT TO_DATE('05/10/2024', 'MM/DD/YYYY'), DATE('05/10/2024', 'MM/DD/YYYY');
Copy
+-------------------------------------+----------------------------------+ | TO_DATE('05/10/2024', 'MM/DD/YYYY') | DATE('05/10/2024', 'MM/DD/YYYY') | |-------------------------------------+----------------------------------| | 10-May-2024 | 10-May-2024 | +-------------------------------------+----------------------------------+

Exemplos que usam uma cadeia de caracteres com um inteiro

Quando a entrada é uma cadeia de caracteres que contém um número inteiro, a magnitude desse número inteiro afeta se ele é interpretado como segundos, milissegundos etc. O exemplo a seguir mostra como a função escolhe as unidades a usar (segundos, milissegundos, microssegundos ou nanossegundos) com base na magnitude do valor.

Criar e carregar a tabela:

CREATE OR REPLACE TABLE demo1 ( description VARCHAR, value VARCHAR -- string rather than bigint ); INSERT INTO demo1 (description, value) VALUES ('Seconds', '31536000'), ('Milliseconds', '31536000000'), ('Microseconds', '31536000000000'), ('Nanoseconds', '31536000000000000');
Copy

Passe as cadeias de caracteres para a função:

SELECT description, value, TO_TIMESTAMP(value), TO_DATE(value) FROM demo1 ORDER BY value;
Copy
+--------------+-------------------+-------------------------+----------------+ | DESCRIPTION | VALUE | TO_TIMESTAMP(VALUE) | TO_DATE(VALUE) | |--------------+-------------------+-------------------------+----------------| | Seconds | 31536000 | 1971-01-01 00:00:00.000 | 1971-01-01 | | Milliseconds | 31536000000 | 1971-01-01 00:00:00.000 | 1971-01-01 | | Microseconds | 31536000000000 | 1971-01-01 00:00:00.000 | 1971-01-01 | | Nanoseconds | 31536000000000000 | 1971-01-01 00:00:00.000 | 1971-01-01 | +--------------+-------------------+-------------------------+----------------+
Linguagem: Português