Функция to_date

Область применения: Databricks SQL Databricks Runtime

Возвращает значение expr, приведенное к дате, с применением необязательного форматирования.

Синтаксис

to_date(expr [, fmt] )

Аргументы

• expr: строковое (STRING) выражение, представляющее дату.
• fmt: необязательное выражение типа STRING для форматирования.

Возвраты

Значение DATE.

Если указан аргумент fmt, он должен соответствовать шаблонам даты и времени.

Если fmt не указан, эта функция является синонимом cast(expr AS DATE).

Если fmt неправильно сформирован или его приложение не приводит к правильно сформированной дате, Azure Databricks вызывает ошибку.

Распространенные условия ошибки

• CAST_INVALID_INPUT
• CANNOT_PARSE_TIMESTAMP

Примечание.

В Databricks Runtime, если , функция возвращается false вместо ошибки для неправильных дат.

Примеры

> SELECT to_date('2009-07-30 04:17:52');
 2009-07-30
> SELECT to_date('2016-12-31', 'yyyy-MM-dd');
 2016-12-31

> SELECT to_date('not-a-date');
  Error: CAST_INVALID_INPUT

Связанные функции

• cast функция
• date функция
• to_timestamp функция
• Шаблоны datetime