YEAR (NoSQL 查詢)

傳回所提供日期和時間的年份值。

語法

YEAR(<date_time>)  

Arguments

Description
date_time ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ的協調世界時 (UTC) 日期和時間字串。

傳回類型

傳回正整數的數值。

範例

下列範例顯示在不同日期值上使用此函數的結果。

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 函式相同。
  • 此功能受益於 範圍索引的使用。