共用方式為

DateTimePart （NoSQL 查詢）

  • 發行項

適用於：NoSQL

傳回所提供日期和時間之指定日期和時間部分的值。

語法

DateTimePart(<date_time_part> , <date_time>)

引數

描述
date_time ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ的國際標準時間 （UTC） 日期和時間字串。
date_time_part 字串，表示 ISO 8601 日期格式規格的一部分。 此部分用來指出要擷取和傳回之日期的哪個層面。

注意

如需 ISO 8601 格式的詳細資訊，請參閱 ISO 8601。

傳回類型

傳回正整數的數值。

範例

下列範例會傳回日期和時間 2016 年 5 月 29 日 08：30 UTC 的各種部分。

SELECT VALUE {
    getYear: DateTimePart("yyyy", "2016-05-29T08:30:00.1301617"),
    getMonth: DateTimePart("mm", "2016-05-29T08:30:00.1301617"),
    getDay: DateTimePart("dd", "2016-05-29T08:30:00.1301617"),
    getHour: DateTimePart("hh", "2016-05-29T08:30:00.1301617"),
    getMinute: DateTimePart("mi", "2016-05-29T08:30:00.1301617"),
    getSecond: DateTimePart("ss", "2016-05-29T08:30:00.1301617"),
    getMillisecond: DateTimePart("ms", "2016-05-29T08:30:00.1301617"),
    getMicrosecond: DateTimePart("mcs", "2016-05-29T08:30:00.1301617"),
    getNanosecond: DateTimePart("ns", "2016-05-29T08:30:00.1301617")
}

[
  {
    "getYear": 2016,
    "getMonth": 5,
    "getDay": 29,
    "getHour": 8,
    "getMinute": 30,
    "getSecond": 0,
    "getMillisecond": 130,
    "getMicrosecond": 130161,
    "getNanosecond": 130161700
  }
]

備註

  • 此函式會基於下列原因傳回 undefined ：
    • 指定的日期和時間部分無效。
    • 日期和時間不是有效的 ISO 8601 日期和時間字串。
  • ISO 8601 日期格式會指定要搭配此函式使用的有效日期和時間部分： | |格式 | |--- |--- | | Year | year、 yyyy、 yy | | Month | month、 mm、 m | | Day | day、 dd、 d | | Hour | hour、 hh | | Minute | minute、 mi、 n | | 第二 | second個、 ss、 s | | 毫秒 | millisecond、 ms | | Microsecond | microsecond、 mcs | | Nanosecond | nanosecond， ns |
  • 此函式不會使用索引。

相關內容