通过

DATETIMEPART - Cosmos DB 中的查询语言（在 Azure 和 Fabric 中）

  • 适用于: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

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

Syntax

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

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

返回类型

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

例子

本部分包含有关如何使用此查询语言构造的示例。

提取日期和时间部分

在此示例中，该 DATETIMEPART 函数用于从日期中提取年份、月、日、小时、分钟、秒、毫秒、微秒和纳秒。

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
  }
]

注解

  • 此函数不使用索引。
  • ISO 8601 日期格式指定要用于此函数的有效日期和时间部分： | |格式 | |--- |--- | |Year | year、yyyy、 yy | |Month | month、mm、 m | |Day | day、、 ddd| |Hour | hour、 hh | |Minute | minute、mi、 n | |第二 | second个，ss， s | |毫秒 | millisecond， ms | |Microsecond | microsecond、 mcs | |Nanosecond | nanosecond、ns |
  • 此函数出于以下原因返回 undefined ：
    • 指定的日期和时间部分无效。
    • 日期和时间不是有效的 ISO 8601 日期和时间字符串。
  • Last updated on