次の方法で共有

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

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

DATETIMEBIN関数は、指定された日付と時刻の文字列の一部をビン分割 (または丸め) した結果である日付と時刻の文字列値を返します。

構文

DATETIMEBIN(<date_time>, <date_time_part> [, <bin_size>] [, <bin_start_date_time>])

論争

Description
date_time ISO 8601 形式の協定世界時 (UTC) の日付と時刻の文字列 YYYY-MM-DDThh:mm:ss.fffffffZ。
date_time_part ISO 8601 日付形式仕様の一部を表す文字列。 この部分は、ビン分割する日付の側面を示すために使用されます。
bin_size ビンのサイズを指定する省略可能な数値。 指定しない場合は、既定値の 1 が使用されます。
bin_start_date_time ISO 8601 形式の省略可能な UTC 日付と時刻の文字列。 指定しない場合、既定値は Unix エポック 1970-01-01T00:00:00.000000Zです。

戻り値の型

日付と時刻の文字列値を返します。

例示

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

Bin の日付と時刻の値

この例では、 DATETIMEBIN 関数を使用して、日付と時刻を日、時、秒、およびカスタムのビン サイズと開始日でビン分割します。

SELECT VALUE {
  binDay: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd"),
  binHour: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh"),
  binSecond: DATETIMEBIN("2021-01-08T18:35:00.0000000", "ss"),
  binFiveHours: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh", 5),
  binSevenDaysUnixEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7),
  binSevenDaysWindowsEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7, "1601-01-01T00:00:00.0000000")
}

[
  {
    "binDay": "2021-01-08T00:00:00.0000000Z",
    "binHour": "2021-01-08T18:00:00.0000000Z",
    "binSecond": "2021-01-08T18:35:00.0000000Z",
    "binFiveHours": "2021-01-08T15:00:00.0000000Z",
    "binSevenDaysUnixEpoch": "2021-01-07T00:00:00.0000000Z",
    "binSevenDaysWindowsEpoch": "2021-01-04T00:00:00.0000000Z"
  }
]

注釈

  • この関数は、次の理由から undefined を返します。
  • 指定された日付と時刻の部分が無効です。
  • bin サイズの値が有効な整数ではないか、0 であるか、負の値です。
  • どちらの引数の日付と時刻も、有効な ISO 8601 の日付と時刻の文字列ではありません。
  • ビンの開始日時は、Windows エポックである年 '1601' より前です。
  • 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 |
  • Last updated on