다음을 통해 공유

YEAR (NoSQL 查询)

适用范围: NoSQL

返回提供的日期和时间的年份值。

Syntax

YEAR(<date_time>)  

Arguments

Description
date_time 日期/时间值。

返回类型

返回一个数值,该值为正整数。

例子

以下示例演示在不同日期值上使用此函数的结果。

SELECT VALUE {
    "case1": YEAR("2000-10-10"),
    "case2": YEAR("2024-01-10T14:15:20"),
    "case3": YEAR("1989-03-03T12:12:12.1234567Z")
}
[
    {
        "case1": 2000,
        "case2": 2024,
        "case3": 1989
    }
]

注解

  • 指定年份时,此函数的行为与 DateTimePart 函数相同。
  • 此函数受益于 范围索引的使用。