共用方式為

DATETIMEPART - Cosmos DB 中的查詢語言 （在 Azure 和 Fabric 中）

  • 適用於: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

此 DATETIMEPART 函數會傳回所提供日期和時間的指定日期和時間部分的值。

語法

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， yyyy， | yy |月 | month， mm， | m |日 | day， dd， | d |小時 | hour， hh | |分鐘 | minute， mi， | n |第二 | second，ss，| s |毫秒 | millisecond， ms | |微秒 | microsecond， mcs | |納秒 | nanosecond，ns |
  • 此函式會傳回 undefined ，原因如下：
    • 指定的日期和時間部分無效。
    • 日期和時間不是有效的 ISO 8601 日期和時間字串。
  • Last updated on