DATETIMEFROMPARTS - Cosmos DB 中的查询语言

该 DATETIMEFROMPARTS 函数返回从各种日期和时间部分的输入数值构造的日期和时间字符串值。

Syntax

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

Arguments

Description
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。

返回类型

返回日期和时间字符串值。

例子

本部分包含有关如何使用此查询语言构造的示例。

根据各部分构造日期和时间

在此示例中，函数 DATETIMEFROMPARTS 用于从各种参数构造日期和时间值。

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。
  • Last updated on