共用方式為

DateTimeFromParts （NoSQL 查詢）

  • 發行項

適用於：NoSQL

傳回從各種日期和時間部分輸入數值所建構的日期和時間字串值。

語法

DateTimeFromParts(<numeric_year>, <numeric_month>, <numeric_day> [, <numeric_hour>]  [, <numeric_minute>]  [, <numeric_second>] [, <numeric_second_fraction>])

引數

描述
numeric_year 年份的正數值整數值。 這個自變數格式為 ISO 8601 yyyy。
numeric_month 月份的正數值整數值。 這個自變數格式為 ISO 8601 mm。
numeric_day 當天的正數值整數值。 這個自變數格式為 ISO 8601 dd。
numeric_hour(選擇性) 小時選擇性的正數值整數值。 這個自變數格式為 ISO 8601 hh。 若未指定，則預設值為 0。
numeric_minute(選擇性) 分鐘選擇性的正數值整數值。 這個自變數格式為 ISO 8601 mm。 若未指定，則預設值為 0。
numeric_second(選擇性) 第二個選擇性的正數值整數值。 這個自變數格式為 ISO 8601 ss。 若未指定，則預設值為 0。
numeric_second_fraction(選擇性) 秒小數的選擇性正數值整數值。 這個自變數格式為 ISO 8601 fffffffZ。 若未指定，則預設值為 0。

注意

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

傳回類型

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

範例

下列範例會使用各種自變數組合來建立日期和時間字串。 此範例使用日期和時間 2017 年 4 月 20 日 13：15 UTC。

SELECT VALUE {
    constructMinArguments: DateTimeFromParts(2017, 4, 20),
    constructMinEquivalent: DateTimeFromParts(2017, 4, 20, 0, 0, 0, 0),
    constructAllArguments: DateTimeFromParts(2017, 4, 20, 13, 15, 20, 3456789),
    constructPartialArguments: DateTimeFromParts(2017, 4, 20, 13, 15),
    constructInvalidArguments: DateTimeFromParts(-2000, -1, -1)
}

[
  {
    "constructMinArguments": "2017-04-20T00:00:00.0000000Z",
    "constructMinEquivalent": "2017-04-20T00:00:00.0000000Z",
    "constructAllArguments": "2017-04-20T13:15:20.3456789Z",
    "constructPartialArguments": "2017-04-20T13:15:00.0000000Z"
  }
]

備註

  • 如果指定的整數會建立無效的日期和時間，函式會傳 undefined回 。

相關內容