次の方法で共有

DATETIMEPART - Cosmos DB のクエリ言語 (Azure と Fabric)

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

DATETIMEPART関数は、指定された日付と時刻の指定した日付と時刻の部分の値を返します。

構文

DATETIMEPART(<date_time_part>, <date_time>)

論争

Description
date_time_part ISO 8601 日付形式仕様の一部を表す文字列。 この部分は、抽出して返す日付の側面を示すために使用されます。
date_time ISO 8601 形式の協定世界時 (UTC) の日付と時刻の文字列 YYYY-MM-DDThh:mm:ss.fffffffZ。

戻り値の型

正の整数の数値を返します。

例示

このセクションでは、このクエリ言語コンストラクトを使用する方法の例を示します。

日付と時刻の部分を抽出する

この例では、 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 | month, mm, m | |日 | day、dd、d |時間 | hour、hh |分 | minute、mi、n |Second | second, ss, s | |ミリ秒 | millisecond、ms |マイクロ秒 | microsecond、mcs |Nanosecond | nanosecond,ns |
  • この関数は、次の理由から undefined を返します。
    • 指定された日付と時刻の部分が無効です。
    • 日付と時刻は、有効な ISO 8601 の日付と時刻の文字列ではありません。
  • Last updated on