本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 日期时间类型
日期时间数据类型包括日期、时间、TIMESTAMP\$1LTZ 和 TIMESTAMP\$1NTZ。
**Topics**
+ [DATE](Datetime_types-date.md)
+ [TIMESTAMP\$1LTZ](Datetime_types-timestamp_LTZ.md)
+ [TIMESTAMP\$1NTZ](Datetime_types-TIMESTAMP_NTZ.md)
+ [日期时间类型的示例](Examples_with_datetime_types.md)
+ [日期、时间和时间戳文本](Date_and_time_literals.md)
+ [间隔文本](Interval_literals.md)
+ [间隔数据类型和文字](interval_data_types_spark.md)
# DATE
使用 DATE 数据类型存储没有时间戳的简单日历日期。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/sql-reference/Datetime_types-date.html)
# TIMESTAMP\$1LTZ
使用 TIMESTAMP\$1LTZ 数据类型存储完整的时间戳值，包括日期、一天中的时间和本地时区。
TIMESTAMP 表示包含字段`year`、`month`、、`day``hour``minute``second`、和的值以及会话本地时区的值。该`timestamp`值表示绝对的时间点。
Spark 中的 TIMESTAMP 是用户指定的别名，与 TIMESTAMP\$1LTZ 和 TIMESTAMP\$1NTZ 变体之一相关联。您可以通过配置将默认时间戳类型设置为 TIMESTAMP\$1LTZ（默认值）或 TIMESTAMP\$1NTZ。`spark.sql.timestampType`
# TIMESTAMP\$1NTZ
使用 TIMESTAMP\$1NTZ 数据类型存储完整的时间戳值，包括日期、一天中的时间，不包括本地时区。
TIMESTAMP 表示包含字段`year`、、`month`、`day``hour``minute`、和`second`值的值。所有操作都是在不考虑任何时区的情况下执行的。
Spark 中的 TIMESTAMP 是用户指定的别名，与 TIMESTAMP\$1LTZ 和 TIMESTAMP\$1NTZ 变体之一相关联。您可以通过配置将默认时间戳类型设置为 TIMESTAMP\$1LTZ（默认值）或 TIMESTAMP\$1NTZ。`spark.sql.timestampType`
# 日期时间类型的示例
以下示例向您展示如何处理 AWS Clean Rooms支持的日期时间类型。
## 日期示例
以下示例插入具有不同格式的日期并显示输出。
```
select * from datetable order by 1;
start_date | end_date
-----------------------
2008-06-01 | 2008-12-31
2008-06-01 | 2008-12-31
```
如果您将时间戳值插入 DATE 列，时间部分会被忽略，只会加载日期。
## 时间示例
以下示例插入具有不同格式的 TIME 和 TIMETZ 值并显示输出。
```
select * from timetable order by 1;
start_time | end_time
------------------------
19:11:19 | 20:41:19+00
19:11:19 | 20:41:19+00
```
# 日期、时间和时间戳文本
以下是使用 AWS Clean Rooms Spark SQL 支持的日期、时间和时间戳文字的规则。
## 日期
下表显示了输入日期，这些日期是您可以加载到 AWS Clean Rooms 表中的文字日期值的有效示例。默认 `MDY DateStyle` 模式被认为是有效的。此模式意味着在字符串中，月份值将位于日期值之前，如 `1999-01-08` 和 `01/02/00`。
**注意**
当您将日期或时间戳文本加载到表中时，这些文本必须用引号括起来。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/sql-reference/Date_and_time_literals.html)
## Times
下表显示了输入时间，这些时间是您可以加载到 AWS Clean Rooms 表中的文字时间值的有效示例。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/sql-reference/Date_and_time_literals.html)
## 特殊日期时间值
下列显示可用作日期时间文本和日期函数参数的特殊值。它们需要单引号，并在查询处理期间转换为常规时间戳值。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/sql-reference/Date_and_time_literals.html)
以下示例说明了如何`now`使用 DATE\$1ADD 函数。`today`
```
select date_add('today', 1);
date_add
---------------------
2009-11-17 00:00:00
(1 row)
select date_add('now', 1);
date_add
----------------------------
2009-11-17 10:45:32.021394
(1 row)
```
# 间隔文本
以下是使用 AWS Clean Rooms Spark SQL 支持的区间文字的规则。
使用间隔文本标识特定时间段（如 `12 hours` 或 `6 weeks`）。您可在涉及日期时间表达式的条件和计算中使用这些间隔文本。
**注意**
不能对 AWS Clean Rooms 表中的列使用 INTERVAL 数据类型。
间隔用 INTERVAL 关键字与数量和支持的日期部分的组合表示；例如 `INTERVAL '7 days'` 或 `INTERVAL '59 minutes'`。您可以将许多数量和单位连接在一起以形成更精确的间隔；例如：`INTERVAL '7 days, 3 hours, 59 minutes'`。还支持每个单位的缩写和复数；例如：`5 s`、`5 second` 和 `5 seconds` 是等效的间隔。
如果您未指定日期部分，则间隔值表示秒。您可指定数量值作为小数（例如：`0.5 days`）。
## 示例
以下示例显示了具有不同间隔值的一系列计算。
以下示例向指定日期添加 1 秒。
```
select caldate + interval '1 second' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 00:00:01
(1 row)
```
以下示例向指定日期添加 1 分钟。
```
select caldate + interval '1 minute' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 00:01:00
(1 row)
```
以下示例向指定日期添加 3 小时 35 分钟。
```
select caldate + interval '3 hours, 35 minutes' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 03:35:00
(1 row)
```
以下示例向指定日期添加 52 周。
```
select caldate + interval '52 weeks' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2009-12-30 00:00:00
(1 row)
```
以下示例向指定日期添加 1 周、1 小时、1 分钟和 1 秒。
```
select caldate + interval '1w, 1h, 1m, 1s' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2009-01-07 01:01:01
(1 row)
```
以下示例向指定日期添加 12 小时（半天）。
```
select caldate + interval '0.5 days' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 12:00:00
(1 row)
```
以下示例将从 2023 年 3 月 31 日减去 4 个月，结果为 2022 年 11 月 30 日。计算时会考虑一个月中的天数。
```
select date '2023-03-31' - interval '4 months';
?column?
---------------------
2022-11-30 00:00:00
```
# 间隔数据类型和文字
您可以使用间隔数据类型以 `seconds`、`minutes`、`hours`、`days`、`months`、和 `years` 等为单位存储时间段。间隔数据类型和文字可用于日期时间计算，例如在日期和时间戳中添加间隔、对间隔求和以及从日期或时间戳中减去间隔。间隔文字可用作表中间隔数据类型列的输入值。
## 间隔数据类型的语法
指定间隔数据类型以存储以年和月为单位的持续时间：
```
INTERVAL year_to_month_qualifier
```
指定间隔数据类型以存储以天、小时、分钟和秒为单位的持续时间：
```
INTERVAL day_to_second_qualifier [ (fractional_precision) ]
```
## 间隔文字的语法
指定间隔文字以定义以年和月为单位的持续时间：
```
INTERVAL quoted-string year_to_month_qualifier
```
指定间隔文字以定义以天、小时、分钟和秒为单位的持续时间：
```
INTERVAL quoted-string day_to_second_qualifier [ (fractional_precision) ]
```
## 参数
*引用字符串*
指定正数值或负数值，以指定数量和日期时间单位作为输入字符串。*如果带*引号的字符串仅包含数字，则从 y* ear\$1to\$1month\$1month\$1qualifier 或 day\$1to\$1secon *d\$1* qualifier 中 AWS Clean Rooms 确定单位。*例如，`'23' MONTH` 表示 `1 year 11 months`、`'-2' DAY` 表示 `-2 days 0 hours 0 minutes 0.0 seconds`，`'1-2' MONTH` 表示 `1 year 2 months`、`'13 day 1 hour 1 minute 1.123 seconds' SECOND` 表示 `13 days 1 hour 1 minute 1.123 seconds`。有关间隔输出格式的更多信息，请参阅[间隔样式](#interval_data_types-interval-styles)。
*year\$1to\$1month\$1qualifier*
指定间隔的范围。如果您使用限定符并创建时间单位小于限定符的时间间隔，则会 AWS Clean Rooms 截断并丢弃间隔中较小的部分。*year\$1to\$1month\$1qualifier* 的有效值为：
+ `YEAR`
+ `MONTH`
+ `YEAR TO MONTH`
*day\$1to\$1second\$1qualifier*
指定间隔的范围。如果您使用限定符并创建时间单位小于限定符的时间间隔，则会 AWS Clean Rooms 截断并丢弃间隔中较小的部分。*day\$1to\$1second\$1qualifier* 的有效值为：
+ `DAY`
+ `HOUR`
+ `MINUTE`
+ `SECOND`
+ `DAY TO HOUR`
+ `DAY TO MINUTE`
+ `DAY TO SECOND`
+ `HOUR TO MINUTE`
+ `HOUR TO SECOND`
+ `MINUTE TO SECOND`
INTERVAL 文字的输出会被截断为指定的最小 INTERVAL 分量。例如，使用 MINUTE 限定符时， AWS Clean Rooms 丢弃小于 MINUTE 的时间单位。
```
select INTERVAL '1 day 1 hour 1 minute 1.123 seconds' MINUTE
```
结果值被截断为 `'1 day 01:01:00'`。
*fractional\$1precision*
可选参数，用于指定间隔中允许的小数位数。仅在间隔包含 SECOND 时，才应指定 *fractional\$1precision* 参数。例如，`SECOND(3)` 创建的间隔仅允许三个小数位，例如 1.234 秒。最大小数位数为六位。
会话配置 `interval_forbid_composite_literals` 确定在同时指定 YEAR TO MONTH 和 DAY TO SECOND 部分的间隔时是否返回错误。
## 间隔算术
您可以将间隔值与其他日期时间值一起使用来执行算术运算。下表介绍了可用的运算以及每种运算产生的数据类型。
**注意**
能同时产生 `date` 和 `timestamp` 结果的运算是以等式中涉及的最小时间单位为基础的。例如，在将 `interval` 添加 `date` 时，如果是 YEAR TO MONTH 间隔，则结果为 `date`；如果是 DAY TO SECOND 间隔，则结果为时间戳。
第一操作数为 `interval` 的运算会对给定的第二操作数产生以下结果：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/sql-reference/interval_data_types_spark.html)
第一操作数为 `date` 的运算会对给定的第二操作数产生以下结果：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/sql-reference/interval_data_types_spark.html)
第一操作数为 `timestamp` 的运算会对给定的第二操作数产生以下结果：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/sql-reference/interval_data_types_spark.html)
## 间隔样式
+ `postgres` – 遵循 PostgreSQL 风格。这是默认值。
+ `postgres_verbose` – 遵循 PostgreSQL 的详细风格。
+ `sql_standard` – 遵循 SQL 标准间隔文字风格。
以下命令将间隔风格设置为 `sql_standard`。
```
SET IntervalStyle to 'sql_standard';
```
**postgres 输出格式**
以下是 `postgres` 间隔风格的输出格式。每个数值都可以是负数。
```
' [, ...]'
```
```
select INTERVAL '1-2' YEAR TO MONTH::text
varchar
---------------
1 year 2 mons
```
```
select INTERVAL '1 2:3:4.5678' DAY TO SECOND::text
varchar
------------------
1 day 02:03:04.5678
```
**postgres\$1verbose 输出格式**
postgres\$1verbose 语法与 postgres 类似，但是 postgres\$1verbose 输出还包含时间单位。
```
'[@] [, ...] [direction]'
```
```
select INTERVAL '1-2' YEAR TO MONTH::text
varchar
-----------------
@ 1 year 2 mons
```
```
select INTERVAL '1 2:3:4.5678' DAY TO SECOND::text
varchar
---------------------------
@ 1 day 2 hours 3 mins 4.56 secs
```
**sql\$1standard 输出格式**
年至月间隔值的格式如下所示。在间隔之前指定负数表示间隔为负值，适用于整个间隔。
```
'[-]yy-mm'
```
日至秒值间隔的格式如下所示。
```
'[-]dd hh:mm:ss.ffffff'
```
```
SELECT INTERVAL '1-2' YEAR TO MONTH::text
varchar
-------
1-2
```
```
select INTERVAL '1 2:3:4.5678' DAY TO SECOND::text
varchar
---------------
1 2:03:04.5678
```
## 间隔数据类型示例
以下示例演示如何将 INTERVAL 数据类型与表结合使用。
```
create table sample_intervals (y2m interval month, h2m interval hour to minute);
insert into sample_intervals values (interval '20' month, interval '2 days 1:1:1.123456' day to second);
select y2m::text, h2m::text from sample_intervals;
y2m | h2m
---------------+-----------------
1 year 8 mons | 2 days 01:01:00
```
```
update sample_intervals set y2m = interval '2' year where y2m = interval '1-8' year to month;
select * from sample_intervals;
y2m | h2m
---------+-----------------
2 years | 2 days 01:01:00
```
```
delete from sample_intervals where h2m = interval '2 1:1:0' day to second;
select * from sample_intervals;
y2m | h2m
-----+-----
```
## 间隔文字示例
以下示例在间隔风格设置为 `postgres` 的情况下运行。
以下示例演示如何创建间隔为 1 年的 INTERVAL 文字。
```
select INTERVAL '1' YEAR
intervaly2m
---------------
1 years 0 mons
```
如果您指定的*引用字符串*超过限定词，则剩余的时间单位将从间隔处截断。在以下示例中，13 个月的间隔变为 1 年零 1 个月，但由于使用 YEAR 限定词，剩余的 1 个月被排除在外。
```
select INTERVAL '13 months' YEAR
intervaly2m
---------------
1 years 0 mons
```
如果您使用的限定词小于间隔字符串，则会包括排除的单位。
```
select INTERVAL '13 months' MONTH
intervaly2m
---------------
1 years 1 mons
```
在间隔中指定精度会将小数位数截断为指定的精度。
```
select INTERVAL '1.234567' SECOND (3)
intervald2s
--------------------------------
0 days 0 hours 0 mins 1.235 secs
```
如果未指定精度，则 AWS Clean Rooms 使用最大精度 6。
```
select INTERVAL '1.23456789' SECOND
intervald2s
-----------------------------------
0 days 0 hours 0 mins 1.234567 secs
```
以下示例演示如何创建范围间隔。
```
select INTERVAL '2:2' MINUTE TO SECOND
intervald2s
------------------------------
0 days 0 hours 2 mins 2.0 secs
```
限定词决定了您要指定的单位。例如，尽管以下示例使用与前一个示例相同的带*引号的 '2:2' 字符串， AWS Clean Rooms 但由于限定符*的原因，它使用了不同的时间单位。
```
select INTERVAL '2:2' HOUR TO MINUTE
intervald2s
------------------------------
0 days 2 hours 2 mins 0.0 secs
```
还支持每个单位的缩写和复数。例如，`5s`、`5 second`、和 `5 seconds` 是等效间隔。支持的单位为年、月、小时、分钟和秒。
```
select INTERVAL '5s' SECOND
intervald2s
------------------------------
0 days 0 hours 0 mins 5.0 secs
```
```
select INTERVAL '5 HOURS' HOUR
intervald2s
------------------------------
0 days 5 hours 0 mins 0.0 secs
```
```
select INTERVAL '5 h' HOUR
intervald2s
------------------------------
0 days 5 hours 0 mins 0.0 secs
```
# 不带限定词语法的间隔文字示例
**注意**
以下示例演示如何使用不带 `YEAR TO MONTH` 或 `DAY TO SECOND` 限定词的间隔文字。有关将推荐的间隔文字与限定词一起使用的信息，请参阅[间隔数据类型和文字](interval_data_types_spark.md)。
使用间隔文本标识特定时间段（如 `12 hours` 或 `6 months`）。您可在涉及日期时间表达式的条件和计算中使用这些间隔文本。
间隔文字用 INTERVAL 关键字与数量和支持的日期部分的组合来表示；例如 `INTERVAL '7 days'` 或 `INTERVAL '59 minutes'`。您可以将许多数量和单位连接在一起以形成更精确的间隔；例如：`INTERVAL '7 days, 3 hours, 59 minutes'`。还支持每个单位的缩写和复数；例如：`5 s`、`5 second` 和 `5 seconds` 是等效的间隔。
如果您未指定日期部分，则间隔值表示秒。您可指定数量值作为小数（例如：`0.5 days`）。
以下示例显示了具有不同间隔值的一系列计算。
以下选项向指定日期添加 1 秒。
```
select caldate + interval '1 second' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 00:00:01
(1 row)
```
以下选项向指定日期添加 1 分钟。
```
select caldate + interval '1 minute' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 00:01:00
(1 row)
```
以下选项向指定日期添加 3 小时 35 分钟。
```
select caldate + interval '3 hours, 35 minutes' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 03:35:00
(1 row)
```
以下选项向指定日期添加 52 周。
```
select caldate + interval '52 weeks' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2009-12-30 00:00:00
(1 row)
```
以下选项向指定日期添加 1 周、1 小时、1 分钟和 1 秒：
```
select caldate + interval '1w, 1h, 1m, 1s' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2009-01-07 01:01:01
(1 row)
```
以下选项向指定日期添加 12 小时（半天）。
```
select caldate + interval '0.5 days' as dateplus from date
where caldate='12-31-2008';
dateplus
---------------------
2008-12-31 12:00:00
(1 row)
```
以下计算将从 2023 年 2 月 15 日减去 4 个月，结果为 2022 年 10 月 15 日。
```
select date '2023-02-15' - interval '4 months';
?column?
---------------------
2022-10-15 00:00:00
```
以下计算将从 2023 年 3 月 31 日减去 4 个月，结果为 2022 年 11 月 30 日。计算时会考虑一个月中的天数。
```
select date '2023-03-31' - interval '4 months';
?column?
---------------------
2022-11-30 00:00:00
```