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

DateTimePart (Azure Cosmos DB)

适用于: NoSQL

返回指定 DateTime 之间指定 DateTimePart 的值。

语法

DateTimePart (<DateTimePart> , <DateTime>)

参数

DateTimePart
DateTimePart 将为其返回值的日期部分。 此表列出了所有有效的 DateTimePart 参数:

DateTimePart 缩写
Year "year", "yyyy", "yy"
Month "month", "mm", "m"
日期 "day", "dd", "d"
Hour "hour", "hh"
Minute "minute", "mi", "n"
"second", "ss", "s"
Millisecond "millisecond", "ms"
Microsecond "microsecond", "mcs"
Nanosecond "nanosecond", "ns"

DateTime
YYYY-MM-DDThh:mm:ss.fffffffZ 格式的 UTC 日期和时间 ISO 8601 字符串值

返回类型

返回正整数值。

备注

由于以下原因,DateTimePart 返回 undefined

  • 指定的 DateTimePart 值无效
  • DateTime 不是有效的 ISO 8601 DateTime

此系统函数不会使用索引。

示例

下面是返回月份整数值的示例:

SELECT DateTimePart("m", "2020-01-02T03:04:05.6789123Z") AS MonthValue
[
    {
        "MonthValue": 1
    }
]

下面是返回微秒数的示例:

SELECT DateTimePart("mcs", "2020-01-02T03:04:05.6789123Z") AS MicrosecondsValue
[
    {
        "MicrosecondsValue": 678912
    }
]

后续步骤