make_timestamp_ltz 函数

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

通过日期和时间字段创建带有本地时区的时间戳。

Syntax

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

make_timestamp_ltz(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 表达式,提供小时、分钟和秒字段。
  • timezone:一个 STRING 可选表达式,可评估到有效的时区,如 CETUTC或 。

Returns

TIMESTAMP_LTZ。

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

如果参数超出边界,函数会提高 DATETIME_FIELD_OUT_OF_BOUNDS。 用 try_make_timestamp_ltz 来返回 NULL 。

常见错误条件

示例

> SELECT make_timestamp_ltz(2014, 12, 28, 6, 30, 45.887, 'CET');
  2014-12-27 21:30:45.887

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