适用于:
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