
# date_part
#### date_part('field', source)
描述：date_part函数基于传统的Ingres函数实现（该函数等效于SQL标准函数extract）。
参数：field参数是一个字符串，而不是一个名称。有效的field与extract一致，详细信息请参见[EXTRACT](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-2622.html#ZH-CN_TOPIC_0000002559105801)。
示例：
```
gaussdb=# SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        16
(1 row)
```
```
gaussdb=# SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
 date_part 
-----------
         4
(1 row)
```
[表1 用于日期/时间格式化的格式]显示了可以用于格式化日期和时间值的格式。
 表1用于日期/时间格式化的格式 
| 类别   | 格式                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 描述                                        |
|:---|:---|:---|
| 小时   | HH                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 一天的小时数（01-12）                             |
| 小时   | HH12                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 一天的小时数（01-12）                             |
| 小时   | HH24                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 一天的小时数（00-23）                             |
| 分钟   | MI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 分钟（00-59）                                 |
| 秒    | SS                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 秒（00-59）                                  |
| 秒    | FF                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 微秒（000000-999999）                         |
| 秒    | FF1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 微秒（0-9）                                   |
| 秒    | FF2                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 微秒（00-99）                                 |
| 秒    | FF3                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 微秒（000-999）                               |
| 秒    | FF4                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 微秒（0000-9999）                             |
| 秒    | FF5                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 微秒（00000-99999）                           |
| 秒    | FF6                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 微秒（000000-999999）                         |
| 秒    | SSSSS                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 午夜后的秒（0-86399）                            |
| 上、下午 | AM或A.M.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 上午标识                                      |
| 上、下午 | PM或P.M.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 下午标识                                      |
| 年    | Y,YYY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 带逗号的年（4和更多位）                              |
| 年    | SYYYY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 公元前四位年                                    |
| 年    | YYYY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 年（4和更多位）                                  |
| 年    | YYY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 年的后三位                                     |
| 年    | YY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 年的后两位                                     |
| 年    | Y                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 年的最后一位                                    |
| 年    | IYYY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ISO年（4位或更多位）                              |
| 年    | IYY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | ISO年的最后三位                                 |
| 年    | IY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | ISO年的最后两位                                 |
| 年    | I                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | ISO年的最后一位                                 |
| 年    | RR                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 年的后两位（可在21世纪存储20世纪的年份）                    |
| 年    | RRRR                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 可接收4位年或两位年。若是两位，则和RR的返回值相同，若是四位，则和YYYY相同。 |
| 年    | - BC或B.C.  - AD或A.D.   | 纪元标识。BC（公元前），AD（公元后）。                     |
| 月    | MONTH                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 全长大写月份名（空白填充为9字符）                         |
| 月    | MON                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 大写缩写月份名（3字符）                              |
| 月    | MM                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 月份数（01-12）                                |
| 月    | RM                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 罗马数字的月份（I-XII ；I=JAN）（大写）                 |
| 天    | DAY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 全长大写日期名（空白填充为9字符）                         |
| 天    | DY                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 缩写大写日期名（3字符）                              |
| 天    | DDD                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 一年里的日（001-366）                            |
| 天    | DD                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 一个月里的日（01-31）                             |
| 天    | D                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 一周里的日（1-7 ；周日是 1）                         |
| 周    | W                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 一个月里的周数（1-5）（第一周从该月第一天开始）                 |
| 周    | WW                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 一年里的周数（1-53）（第一周从该年的第一天开始）                |
| 周    | IW                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | ISO一年里的周数（第一个星期四在第一周里）                    |
| 世纪   | CC                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 世纪（2位）（21 世纪从 2001-01-01 开始）              |
| 儒略日  | J                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 儒略日（自公元前 4712 年 1 月 1 日来的天数）              |
| 季度   | Q                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 季度                                        |
   
在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下新增用于格式化日期和时间值的模式：
表2新增用于格式化日期和时间值的模式 
| 类别   | 模式    | 描述                      |
|:---|:---|:---|
| 世纪   | SCC   | 世纪标识，公元前会显示-            |
| 年    | SYYYY | 返回数字型年，公元前会显示-          |
| 年    | RR    | 返回日期的2位年份               |
| 年    | RRRR  | 返回日期的4位年份               |
| 年    | YEAR  | 返回字符型年                  |
| 年    | SYEAR | 返回字符型年，公元前会显示-          |
| 日期格式 | DL    | 返回指定长日期形式               |
| 日期格式 | DS    | 返回指定短日期                 |
| 日期格式 | TS    | 返回指定时间格式                |
| 秒    | FF7   | 微秒（0000000-9999990）     |
| 秒    | FF8   | 微秒（00000000-99999900）   |
| 秒    | FF9   | 微秒（000000000-999999000） |
   
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 此函数在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下：
  - to_date, to_timestamp函数支持FX模式（输入和模式严格对应），支持X模式（小数点）。
  
  - 输入模式不能出现超过一次，表示相同信息的模式不能同时出现。如SYYYY和BC不能同时出现。
  
  - 模式大小写不敏感。
  
  - 建议输入和模式之间使用分隔符，否则不保证行为与O完全一致。
   
- 上表中RR计算年的规则如下：
  - 输入的两位年份在00\~49之间： 当前年份的后两位在00\~49之间，返回值年份的前两位和当前年份的前两位相同。
    当前年份的后两位在50\~99之间，返回值年份的前两位是当前年份的前两位加1。
    
  
  - 输入的两位年份在50\~99之间： 当前年份的后两位在00\~49之间，返回值年份的前两位是当前年份的前两位减1。
    当前年份的后两位在50\~99之间，返回值年份的前两位和当前年份的前两位相同。
    
   
 
