try_make_timestamp 函数

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime

通过日期和时间字段 NULL 创建时间戳,若无法创建时间戳则返回。

Syntax

try_make_timestamp(year, month, day, hour, min, sec [, timezone] )

try_make_timestamp(date [, time [, timezone]] )

Important

该 time 参数使用的数据 TIME 类型,该类型处于Beta阶段。

Arguments

  • year: INTEGER 通过 19999的表达式。
  • month:一个 INTEGER 表达式,从 1 (1月)到 12 (12月)。
  • day: INTEGER 通过 131的表达式。
  • hour: INTEGER 通过 023的表达式。
  • min: INTEGER 通过 059的表达式。
  • sec:从 0 中到 60的数值表达式。
  • date:一个 DATE 表达式,提供年份、月份和日字段。
  • time: 一个 TIME 可选表达式,提供小时、分钟和秒字段。 默认值为 00:00:00。
  • timezone:一个 STRING 可选表达式,可评估到有效的时区,如 CETUTC或 。

Returns

TIMESTAMPA ,或者NULL当参数超出界限或时间戳无法创建时。

如果 sec 是 60,函数将其解释为 0 ,并对结果加一分钟。

示例

> SELECT try_make_timestamp(2014, 12, 28, 6, 30, 45.887);
  2014-12-28 06:30:45.887

> SELECT try_make_timestamp(2014, 13, 28, 6, 30, 45.887);
  NULL

> SELECT try_make_timestamp(DATE'2014-12-28', TIME'06:30:45.887');
  2014-12-28 06:30:45.887