DATE 类型

适用于:check marked yes Databricks SQL check marked yes Databricks Runtime

表示由字段 year、month 和 day 的值构成的值,不包含时区。

语法

DATE

限制

受支持的日期范围是 June 23 -5877641 CEJuly 11 +5881580 CE

文本

DATE dateString

dateString
{ '[+|-]yyyy[...]' |
  '[+|-]yyyy[...]-[m]m' |
  '[+|-]yyyy[...]-[m]m-[d]d' |
  '[+|-]yyyy[...]-[m]m-[d]d[T]' }
  • +-:选项符号。 - 指示 BCE,+ 指示 CE(默认)。
  • yyyy[...]:表示年份的四位数字。
  • [m]m:介于 0112 之间的一位数或两位数月份。
  • [d]d:介于 0131 之间的一位数或两位数日期。

前缀 DATE 是不区分大小写的。

如果文本确实表示正确的日期,则 Azure Databricks 将引发错误。

示例

> SELECT DATE'0000';
  0000-01-01

> SELECT DATE'2020-12-31';
  2020-12-31

> SELECT DATE'2021-7-1T';
  2021-07-01

> SELECT cast('1908-03-15' AS DATE)
  1908-03-15

> SELECT DATE'-10000-01-01'
  -10000-01-01