共用方式為

DateTimeBin （NoSQL 查詢）

  • 發行項

適用於：NoSQL

傳回日期和時間字串值，這個值是所提供日期和時間字串的量化（或四捨五入）部分的結果。

語法

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

引數

描述
date_time ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ的國際標準時間 （UTC） 日期和時間字串。
date_time_part 字串，表示 ISO 8601 日期格式規格的一部分。 此部分用來指出日期到 bin 的哪個層面。 具體而言，這個 part 自變數代表量化的粒度層級（或四捨五入）。 部分的最小粒度為 天 ，最大粒度為 nanoseconds。
bin_size(選擇性) 指定 bin 大小的選擇性數值。 若未指定，則預設值為 1。
bin_start_date_time(選擇性) ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ的選擇性國際標準時間 （UTC） 日期和時間字串。 這個日期和時間自變數會指定 bin 的開始日期。 如果未指定，預設值為 Unix epoch 1970-01-01T00:00:00.000000Z。

注意

如需 ISO 8601 格式的詳細資訊，請參閱 ISO 8601。 如需 Unix epoch 的詳細資訊，請參閱 Unix 時間。

傳回類型

傳回 ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ的 UTC 日期和時間字串。

範例

下列範例會以各種值將 2021 年 1 月 8 日 18：35 UTC 的日期量化。 此範例也會變更 bin 大小，以及 bin 開始日期和時間。

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 大小值不是有效的整數、為零或負數。
    • 任一自變數中的日期和時間不是有效的 ISO 8601 日期和時間字串。
    • Bin 開始的日期和時間在年份 1601之前，即 Windows epoch。
  • ISO 8601 日期格式會指定要搭配此函式使用的有效日期和時間部分： | |格式 | |--- |--- | | Day | day、 dd、 d | | Hour | hour、 hh | | Minute | minute、 mi、 n | | 第二 | second個、 ss、 s | | 毫秒 | millisecond、 ms | | Microsecond | microsecond、 mcs | | Nanosecond | nanosecond， ns |

相關內容