DateTimePart(NoSQL 查询)
适用范围: NoSQL
返回所提供的日期和时间的指定日期和时间部分的值。
语法
DateTimePart(<date_time> , <date_time_part>)
参数
描述 | |
---|---|
date_time |
采用 ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ 的协调世界时 (UTC) 日期和时间字符串。 |
date_time_part |
一个字符串,它表示 ISO 8601 日期格式规范的一部分。 此部分用于指示要提取和返回日期的哪些方面。 |
返回类型
返回一个数值,该值是一个正整数。
示例
以下示例返回“2016 年 3 月 29 日 08:30 UTC”这一日期和时间的各个部分。
SELECT VALUE {
getYear: DateTimePart("yyyy", "2016-05-29T08:30:00.1301617"),
getMonth: DateTimePart("mm", "2016-05-29T08:30:00.1301617"),
getDay: DateTimePart("dd", "2016-05-29T08:30:00.1301617"),
getHour: DateTimePart("hh", "2016-05-29T08:30:00.1301617"),
getMinute: DateTimePart("mi", "2016-05-29T08:30:00.1301617"),
getSecond: DateTimePart("ss", "2016-05-29T08:30:00.1301617"),
getMillisecond: DateTimePart("ms", "2016-05-29T08:30:00.1301617"),
getMicrosecond: DateTimePart("mcs", "2016-05-29T08:30:00.1301617"),
getNanosecond: DateTimePart("ns", "2016-05-29T08:30:00.1301617")
}
[
{
"getYear": 2016,
"getMonth": 5,
"getDay": 29,
"getHour": 8,
"getMinute": 30,
"getSecond": 0,
"getMillisecond": 130,
"getMicrosecond": 130161,
"getNanosecond": 130161700
}
]
注解
- 此函数出于以下原因返回
undefined
:- 指定的日期和时间部分无效。
- 日期和时间不是有效的 ISO 8601 日期和时间字符串。
- ISO 8601 日期格式指定用于此函数的有效日期和时间部分:| | 格式 | | --- | --- | | 年 |
year
、yyyy
、yy
| | 月 |month
、mm
、m
| | 日 |day
、dd
、d
| | 小时 |hour
、hh
| | 分 |minute
、mi
、n
| | 秒 |second
、ss
、s
| | 毫秒 |millisecond
、ms
| | 微秒 |microsecond
、mcs
| | 纳秒 |nanosecond
、ns
| - 此函数不使用索引。