提取函数 (EXTRACT)

功能描述

提取函数

EXTRACT(field FROM source)

用于从给定的

source

中提取指定的

field

值。该函数可以处理不同类型的日期时间表达式，包括字符串、时间戳等。

参数说明

• field

  field
  (关键词)：需要提取的日期时间字段，具体选项如下：

  • YEAR

    YEAR
    ,

    (Y, YEARS, YR, YRS)

    (Y, YEARS, YR, YRS)
    - 年份

  • QUARTER

    QUARTER
    ,

    (QTR)

    (QTR)
    - 季度 (1 - 4)

  • MONTH

    MONTH
    ,

    (MON, MONS, MONTHS)

    (MON, MONS, MONTHS)
    - 月份 (1 - 12)

  • WEEK

    WEEK
    ,

    (W, WEEKS)

    (W, WEEKS)
    - 表示一年中的第几个星期。需要注意的是，星期的计算是以星期一为开始，每年的第一个星期是该年第一个包含四天或以上的星期。在 ISO 星期的计算体系中，1 月份的最初几天可能属于前一年的第 52 或 53 周；同理，12 月份的最后几天可能属于下一年的第 1 周。例如，2005-01-02 属于 2004 年的第 53 周，2012-12-31 属于 2013 年的第 1 周。

  • DAY

    DAY
    ,

    (D, DAYS)

    (D, DAYS)
    - 所属月份的第几天 (1 - 31)

  • DAYOFWEEK

    DAYOFWEEK
    ,

    (DOW)

    (DOW)
    - 所属星期的第几天，1 对应星期日，7 对应星期六

  • DAYOFWEEK_ISO

    DAYOFWEEK_ISO
    ,

    (DOW_ISO)

    (DOW_ISO)
    - 所属星期的第几天，基于ISO 8601标准，1 对应星期一，7 对应星期日

  • DAYOFYEAR

    DAYOFYEAR
    ,

    (DOY)

    (DOY)
    - 在所属年份的第几天 (1 - 365/366)

  • HOUR

    HOUR
    ,

    (H, HOURS, HR, HRS)

    (H, HOURS, HR, HRS)
    - 小时 (0 - 23)

  • MINUTE

    MINUTE
    ,

    (M, MIN, MINS, MINUTES)

    (M, MIN, MINS, MINUTES)
    - 分钟 (0 - 59)

  • SECOND

    SECOND
    ,

    (S, SEC, SECONDS, SECS)

    (S, SEC, SECONDS, SECS)
    - 秒 (0 - 59)

• source

  source
  (日期/时间戳)：输入的日期时间表达式，可以是字符串、时间戳等。

返回结果

返回结果为整数（int）。

使用示例

以下为

EXTRACT

函数的使用示例：

-- 从字符串类型的时间戳中提取年份 SELECT EXTRACT(YEAR FROM TIMESTAMP '2019-08-12 01:00:00.123456'); -- 结果：2019 -- 从字符串类型的时间戳中提取一年中的第几个星期 SELECT EXTRACT(WEEK FROM TIMESTAMP '2019-08-12 01:00:00.123456'); -- 结果：33 -- 从字符串类型的日期中提取所属月份的第几天 SELECT EXTRACT(DAY FROM DATE '2019-08-12'); -- 结果：12 -- 从当前时间戳中提取季度 SELECT EXTRACT(QUARTER FROM CURRENT_TIMESTAMP()); -- 结果：取决于当前日期 -- 从字符串类型的日期中提取所属星期的第几天（基于ISO 8601标准） SELECT EXTRACT(DAYOFWEEK_ISO FROM DATE '2019-08-12'); -- 结果： 1

通过以上示例，可以看到

EXTRACT

函数在不同场景下的应用。该函数可以方便地从各种输入格式中提取所需的日期时间字段，便于进行进一步的数据分析和处理。