你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

DateTimePart（NoSQL 查询）

  • 项目

适用范围： NoSQL

返回所提供的日期和时间的指定日期和时间部分的值。

语法

DateTimePart(<date_time> , <date_time_part>)

参数

描述
date_time 采用 ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ 的协调世界时 (UTC) 日期和时间字符串。
date_time_part 一个字符串，它表示 ISO 8601 日期格式规范的一部分。 此部分用于指示要提取和返回日期的哪些方面。

注意

有关 ISO 8601 格式的详细信息，请参阅 ISO 8601。

返回类型

返回一个数值，该值是一个正整数。

示例

以下示例返回“2016 年 3 月 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、yyyy、yy | | 月 | month、mm、m | | 日 | day、dd、d | | 小时 | hour、hh | | 分 | minute、mi、n | | 秒 | second、ss、s | | 毫秒 | millisecond、ms | | 微秒 | microsecond、mcs | | 纳秒 | nanosecond、ns |
  • 此函数不使用索引。

相关内容