

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 日期或时间戳函数的日期部分
<a name="Dateparts_for_datetime_functions"></a>

下表标识了作为以下函数参数接受的日期部分和时间部分的名称和缩写：
+ DATE\_ADD 
+ DATE\_DIFF 
+ DATE\_PART 
+ EXTRACT 


| 日期部分或时间部分  | 缩写  | 
| --- | --- | 
| millennium、millennia  | mil、mils  | 
| century、centuries  | c、cent、cents  | 
| decade、decades  | dec、decs  | 
| 纪元  | epoch（由 [EXTRACT](EXTRACT_function.md) 提供支持） | 
| year、years  | y、yr、yrs  | 
| quarter、quarters  | qtr、qtrs  | 
| month、months  | mon,、mons  | 
| week、weeks  | w  | 
| 星期几  | dayofweek、dow、dw、weekday（由 [DATE\_PART](DATE_PART_function.md) 和 [EXTRACT 函数](EXTRACT_function.md) 提供支持）<br />返回 0–6 的整数（星期日是第一个数）。 DOW 日期部分的运行方式与用于日期时间格式字符串的星期 (D) 日期部分不同。D 是基于 1–7 的整数，其中星期日是 1。有关更多信息，请参阅 [日期时间格式字符串](FORMAT_strings.md)。  | 
| 一年中的日期  | dayofyear、doy、dy、yearday（由 [EXTRACT](EXTRACT_function.md)提供支持） | 
| day、days  | d  | 
| hour、hours  | h、hr、hrs  | 
| minute、minutes  | m、min、mins  | 
| second、seconds  | s、sec、secs  | 
| millisecond、milliseconds  | ms、msec、msecs、msecond、mseconds、millisec、millisecs、millisecon  | 
| microsecond、microseconds  | microsec、microsecs、microsecond、usecond、useconds、us、usec、usecs  | 
| timezone、timezone\_hour、timezone\_minute  | 由 [EXTRACT](EXTRACT_function.md) 支持，仅用于带有时区的时间戳 (TIMESTAMPTZ)。 | 

## 秒、毫秒和微秒导致的结果差异
<a name="Dateparts_for_datetime_functions-variations-in-results"></a>

当不同的日期函数指定秒、毫秒或微秒作为日期部分时，查询结果会出现细微差异：
+ EXTRACT 函数仅返回指定日期部分的整数，忽略较高级别和较低级别的日期部分。如果指定的日期部分为秒，则结果中不包括毫秒和微秒。如果指定的日期部分为毫秒，则不包括秒和微秒。如果指定的日期部分为微秒，则不包括秒和毫秒。
+ DATE\_PART 函数返回时间戳的完整秒部分，无论指定的日期部分是什么，从而根据需要返回十进制值或整数。

## CENTURY、EPOCH、DECADE 和 MIL 说明
<a name="Dateparts_for_datetime_functions-century"></a>

CENTURY 或 CENTURIES   
AWS Clean Rooms 将世纪解释为从年份 *\#\# \#1* 开始并以年份结尾：`###0`  

```
select extract (century from timestamp '2000-12-16 12:21:13');
date_part
-----------
20
(1 row)

select extract (century from timestamp '2001-12-16 12:21:13');
date_part
-----------
21
(1 row)
```

EPOCH   
EPOCH 的 AWS Clean Rooms 实现与 1970-01-01 00:00:00.00.000 无关，与集群所在的时区无关。根据集群所在的时区，您可能需要按小时差来抵消结果。

DECADE 或 DECADES   
AWS Clean Rooms 根据通用日历解释 “十年” 或 “十年” 的日期部分。例如，由于公历从第一年开始，因此第一个十年（第 1 个十年）是 0001-01-01 到 0009-12-31，而第二个十年（第 2 个十年）是 0010-01-01 到 0019-12-31。例如，十年 201 为 2000-01-01 - 2009-12-31：  

```
select extract(decade from timestamp '1999-02-16 20:38:40');
date_part
-----------
200
(1 row)

select extract(decade from timestamp '2000-02-16 20:38:40');
date_part
-----------
201
(1 row)

select extract(decade from timestamp '2010-02-16 20:38:40');
date_part
-----------
202
(1 row)
```

MIL 或 MILS   
AWS Clean Rooms 将 MIL 解释为从年 *\#001* 的第一天开始，到一年的最后一天结束：`#000`  

```
select extract (mil from timestamp '2000-12-16 12:21:13');
date_part
-----------
2
(1 row)

select extract (mil from timestamp '2001-12-16 12:21:13');
date_part
-----------
3
(1 row)
```