GBase 8c V3.0.0数据类型——EXTRACT

l EXTRACT(field FROM source)

extract函数从日期或时间的数值里抽取子域，比如年、小时等。source必须是一个timestamp、time或interval类型的值表达式（类型为date的表达式转换为timestamp，因此也可以用）。field是一个标识符或者字符串，它指定从源数据中抽取的域。extract函数返回类型为double precision的数值。field的取值范围如下所示。

l century 

世纪。第一个世纪从0001-01-01 00:00:00 AD开始。这个定义适用于所有使用阳历的国家。没有0世纪，直接从公元前1世纪到公元1世纪。

示例：

gbase=# SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13');

date_part

-----------

20

(1 row)

l day

n 如果source为timestamp，表示月份里的日期（1-31）。

gbase=# SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40');

 date_part

-----------

16

(1 row)

n 如果source为interval，表示天数。

gbase=# SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute');

 date_part

-----------

40

(1 row)

l decade

年份除以10。

gbase=# SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

200

(1 row)

l dow

每周的星期几，星期天（0）到星期六（6）。

gbase=# SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

5

(1 row)

l doy

一年的第几天。取值范围为1~365/366。

gbase=# SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

47

(1 row)

l epoch

如果source为timestamp with time zone，表示自1970-01-01 00:00:00-00 UTC以来的秒数（结果可能是负数）；

如果source为date和timestamp，表示自1970-01-01 00:00:00-00当地时间以来的秒数；

如果source为interval，表示时间间隔的总秒数。

gbase=# SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08');

date_part

--------------

 982384720.12

(1 row)

gbase=# SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours');

date_part

-----------

 442800

(1 row)

将epoch值转换为时间戳的方法。

gbase=# SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second' AS RESULT;

result

---------------------------

2001-02-17 12:38:40.12+08

(1 row)

l hour

小时域，取值范围为0-23。

gbase=# SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

20

(1 row)

l isodow

一周的第几天，取值范围为1-7。1表示星期一，7表示星期天。

除了星期天外，都与dow相同。

gbase=# SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40');

date_part

-----------

7

(1 row)

l isoyear

日期中的ISO 8601标准年（不适用于间隔）。

每个带有星期一开始的周中包含1月4日的ISO年，所以在年初的1月或12月下旬的

ISO年可能会不同于阳历的年。详细信息请参见后续的week描述。

gbase=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01');

date_part

-----------

2005

(1 row)

gbase=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02');

date_part

-----------

2006

(1 row)

l microseconds

秒域（百万级别），可包含小数。

gbase=# SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5');

date_part

-----------

28500000

(1 row)

l millennium

第n个千年。

20世纪年份在第二个千年里。第三个千年从2001年1月1日零时开始算起，至今。

gbase=# SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

3

(1 row)

l milliseconds

秒域（千秒级别），可包含小数。

gbase=# SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5');

date_part

-----------

28500

(1 row)

l minute

分钟域。取值范围为0-59。

gbase=# SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

38

(1 row)

l month

如果source为timestamp，表示一年里的月份数（1-12）。

gbase=# SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

2

(1 row)

如果source为interval，表示月的数目，然后对12取模（0-11）。

gbase=# SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months');

date_part

-----------

1

(1 row)

l quarter

该天所在的该年的季度。取值范围为1-4。

gbase=# SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

1

(1 row)

l second

秒域，可包含小数。取值范围为0-59。

gbase=# SELECT EXTRACT(SECOND FROM TIME '17:12:28.5');

date_part

-----------

28.5

(1 row)

l timezone

与UTC的时区偏移量，单位为秒。正数对应UTC东边的时区，负数对应UTC西边的时区。

l timezone_hour

时区偏移量的小时部分。

l timezone_minute

时区偏移量的分钟部分。

l week

该天在所在的年份里是第几周。

ISO 8601定义一年的第一周包含该年的一月四日（ISO-8601的周从星期一开始）。换句话说，一年的第一个星期四在第一周。在ISO定义里，一月的头几天可能是前一年的第52或者第53周，十二月的后几天可能是下一年第一周。比如，2005-01-01是2004年的第53周，而2006-01-01是2005年的第52周，2012-12-31是2013年的第一周。建议isoyear字段和week一起  使用以得到一致的结果。

gbase=# SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40');

date_part 

-----------

7

(1 row)

l year

年份域

gbase=# SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40');

date_part

-----------

2001

(1 row)