Функция to_timestamp

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

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

Синтаксис

to_timestamp(expr [, fmt] )

Аргументы

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

Возвраты

Значение TIMESTAMP.

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

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

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

Чтобы возвратить NULL вместо ошибки в случае неправильного формата expr, используйте try_to_timestamp.

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

• CAST_INVALID_INPUT
• CANNOT_PARSE_TIMESTAMP

Примечание.

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

Примеры

> SELECT to_timestamp('2016-12-31 00:12:00');
 2016-12-31 00:12:00

> SELECT to_timestamp('2016-12-31', 'yyyy-MM-dd');
 2016-12-31 00:00:00

> SELECT to_timestamp('not-a-timestamp');
  Error: CAST_INVALID_INPUT

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

• cast функция
• timestamp функция
• try_to_timestamp функция
• to_date функция
• Шаблоны datetime