通过

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