Categorias:

Funções de dados semiestruturados e estruturados (Conversão)

AS_DATE

Converte um valor de VARIANT em um valor DATE. Essa função não converte valores de outros tipos de dados, inclusive carimbos de data/hora, em valores DATE.

Consulte também:

AS_<tipo_de_objeto>

Sintaxe

AS_DATE( <variant_expr> )
Copy

Argumentos

variant_expr

Uma expressão que avalia como um valor do tipo VARIANT.

Retornos

A função retorna um valor do tipo DATE ou NULL:

  • Se o tipo do valor no argumento variant_expr for DATE, a função retornará um valor do tipo DATE.

  • Se o tipo do valor no argumento variant_expr não corresponder ao tipo do valor de saída, a função retornará NULL.

  • Se o argumento variant_expr for NULL, a função retornará NULL.

Exemplos

Criar uma tabela e carregar dados nela:

CREATE OR REPLACE TABLE as_date_example (date1 VARIANT);

INSERT INTO as_date_example (date1)
 SELECT TO_VARIANT(TO_DATE('2024-10-10'));
Copy

Use a função AS_DATE em uma consulta para converter um valor VARIANT em um valor DATE:

SELECT AS_DATE(date1) date_value
  FROM as_date_example;
Copy
+------------+
| DATE_VALUE |
|------------|
| 2024-10-10 |
+------------+