$dateFromParts
¶3.6版的新功能。
给定日期的组成属性,构造并返回Date对象。
该$dateFromParts
表达式具有以下语法:
您还可以 使用以下语法以ISO周日期格式指定组成日期字段 :
该$dateFromParts
文件包含以下字段:
重要
构造$dateFromParts
输入文档时,不能将日历日期字段和ISO周日期字段组合使用。
领域 | 必需/可选 | 描述 |
---|---|---|
year |
如果不使用则为必需 isoWeekYear |
公历年。可以是任何计算结果为数字的表达式。 值范围: |
isoWeekYear |
如果不使用则为必需 year |
ISO周日期年份。可以是任何计算结果为数字的表达式。 值范围: |
month |
可选的。只能与一起使用year 。 |
月。可以是任何计算结果为数字的表达式。 默认为 值范围: 从MongoDB 4.0开始,如果指定的数字超出此范围,则会 |
isoWeek |
可选的。只能与一起使用isoWeekYear 。 |
一年中的一周。可以是任何计算结果为数字的表达式。 默认为 值范围: 从MongoDB 4.0开始,如果指定的数字超出此范围,则会 |
day |
可选的。只能与一起使用year 。 |
一个月中的某天。可以是任何计算结果为数字的表达式。 默认为 值范围: 从MongoDB 4.0开始,如果指定的数字超出此范围,则会 |
isoDayOfWeek |
可选的。只能与一起使用isoWeekYear 。 |
星期几(星期一 默认为 值范围: 从MongoDB 4.0开始,如果指定的数字超出此范围,则会 |
hour |
可选的 | 小时。可以是任何计算结果为数字的表达式。 默认为 值范围: 从MongoDB 4.0开始,如果指定的数字超出此范围,则会 |
minute |
可选的 | 分钟。可以是任何计算结果为数字的表达式。 默认为 值范围: |
second |
可选的 | 第二。可以是任何计算结果为数字的表达式。 默认为 值范围: 从MongoDB 4.0开始,如果指定的数字超出此范围,则会 |
millisecond |
可选的 | 毫秒。可以是任何计算结果为数字的表达式。 默认为 值范围: 从MongoDB 4.0开始,如果指定的数字超出此范围,则会 |
timezone |
可选的 |
有关表达式的更多信息,请参见 表达式。 |
在MongoDB中4.0开始,如果比其它字段中指定的值
year
,isoYear
和timezone
是在有效范围之外,
$dateFromParts
携带或减去从其它日期的差来计算的日期。