make_timestamp 函数

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

从 year、month、day、hour、min、sec 和 timezone 字段创建时间戳。

语法

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

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

Important

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

参数

  • year:一个 INTEGER 取值从1到9999的表达式。
  • month:一个 INTEGER 计算值从1(1月)到12月(12月)的表达式。
  • day:一个 INTEGER 取值从1到31的表达式。
  • hour:一个 INTEGER 取值介于0到23之间的表达式。
  • min:一个 INTEGER 值介于0到59之间的表达式。
  • sec:数值表达式,其计算结果为 0 到 60 之间的值。
  • date:一个 DATE 表示年份、月份和日字段的表达式。
  • time:一个 TIME 可选表达式,提供小时、分钟和秒字段。 如果省略,则默认为 />。
  • timezone:一个STRING可选表达式,用于有效时区,例如CETUTC或。

返回

TIMESTAMP。

如果参数超出边界,函数会提高 DATETIME_FIELD_OUT_OF_BOUNDS。 用 try_make_timestamp 来回去 NULL 吧。

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

如果 sec 的分数值不能以微秒精度表示,Azure Databricks将引发 INVALID_FRACTION_OF_SECOND。

常见错误条件

示例

> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887);
 2014-12-28 06:30:45.887
> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887, 'CET');
 2014-12-27 21:30:45.887
> SELECT make_timestamp(2019, 6, 30, 23, 59, 60);
 2019-07-01 00:00:00
> SELECT make_timestamp(NULL, 7, 22, 15, 30, 0);
 NULL

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

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887', 'CET');
 2014-12-27 21:30:45.887

> SELECT make_timestamp(DATE'2014-12-28');
 2014-12-28 00:00:00

> SELECT make_timestamp(2024, 13, 1, 0, 0, 0);
  Error: DATETIME_FIELD_OUT_OF_BOUNDS