Categories:

Semi-structured and structured data functions (Cast)

AS_DATE

Casts a VARIANT value to a DATE value. This function does not convert values of other data types, including timestamps, to DATE values.

See also:

AS_<object_type>

Syntax

AS_DATE( <variant_expr> ) 
Copy

Arguments

variant_expr

An expression that evaluates to a value of type VARIANT.

Returns

The function returns a value of type DATE or NULL:

  • If the type of the value in the variant_expr argument is DATE, the function returns a value of type DATE.

  • If the type of the value in the variant_expr argument doesn’t match the type of the output value, the function returns NULL.

  • If the variant_expr argument is NULL, the function returns NULL.

Examples

Create a table and load data into it:

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 the AS_DATE function in a query to cast a VARIANT value to a DATE value:

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