跳转至

Extract date part(提取日期部分(Extract date part))

Supported in: Batch, Faster, Streaming

Extracts a part of a date like year or day of week.

Expression categories: Datetime

Declared arguments

  • Expression: Date to extract from.
    Expression\
  • Part: Part of date to extract.
    Enum\

Output type: Integer

Examples

Example 1: Base case

Argument values:

  • Expression: 2022-02-10T10:00:00Z
  • Part: DAY_OF_MONTH

Output: 10


Example 2: Base case

Argument values:

  • Expression: 2022-02-10T10:00:00Z
  • Part: DAY_OF_WEEK

Output: 4


Example 3: Base case

Argument values:

  • Expression: 2022-02-10T10:00:00Z
  • Part: DAY_OF_YEAR

Output: 41


Example 4: Base case

Argument values:

  • Expression: 2022-02-10
  • Part: MONTH

Output: 2


Example 5: Base case

Argument values:

  • Expression: 2022-02-10
  • Part: QUARTER

Output: 1


Example 6: Base case

Description: Weeks of year start on Monday and end on Sunday

Argument values:

  • Expression: 2024-01-14T10:00:00Z
  • Part: WEEK_OF_YEAR

Output: 2


Example 7: Base case

Description: Weeks of year respect leap weeks as defined by ISO 8601

Argument values:

  • Expression: 2027-01-01T10:00:00Z
  • Part: WEEK_OF_YEAR

Output: 53


Example 8: Base case

Argument values:

  • Expression: 2022-02-10
  • Part: YEAR

Output: 2022


Example 9: Null case

Argument values:

  • Expression: date
  • Part: YEAR
date Output
null null


中文翻译


提取日期部分(Extract date part)

支持:批处理(Batch)、快速处理(Faster)、流处理(Streaming)

从日期中提取特定部分,例如年份或星期几。

表达式类别: 日期时间(Datetime)

声明的参数

  • 表达式(Expression): 待提取的日期。
    表达式\<日期 | 时间戳>
  • 部分(Part): 待提取的日期部分。
    枚举\<月中的日(Day of month)、周中的日(Day of week)、年中的日(Day of year)、月(Month)、季度(Quarter)、年中的周(Week of year)、年(Year)>

输出类型: 整数(Integer)

示例

示例 1:基础情况

参数值:

  • 表达式: 2022-02-10T10:00:00Z
  • 部分: DAY_OF_MONTH

输出: 10


示例 2:基础情况

参数值:

  • 表达式: 2022-02-10T10:00:00Z
  • 部分: DAY_OF_WEEK

输出: 4


示例 3:基础情况

参数值:

  • 表达式: 2022-02-10T10:00:00Z
  • 部分: DAY_OF_YEAR

输出: 41


示例 4:基础情况

参数值:

  • 表达式: 2022-02-10
  • 部分: MONTH

输出: 2


示例 5:基础情况

参数值:

  • 表达式: 2022-02-10
  • 部分: QUARTER

输出: 1


示例 6:基础情况

描述: 年中的周从周一开始,周日结束

参数值:

  • 表达式: 2024-01-14T10:00:00Z
  • 部分: WEEK_OF_YEAR

输出: 2


示例 7:基础情况

描述: 年中的周遵循 ISO 8601 定义的闰周规则

参数值:

  • 表达式: 2027-01-01T10:00:00Z
  • 部分: WEEK_OF_YEAR

输出: 53


示例 8:基础情况

参数值:

  • 表达式: 2022-02-10
  • 部分: YEAR

输出: 2022


示例 9:空值情况

参数值:

  • 表达式: date
  • 部分: YEAR
date 输出
null null