定义
$isoWeekYear以 ISO 8601 格式返回年份号。 年从第一周的星期一开始,到最后一周的星期日结束。
$isoWeekYear表达式采用以下操作符表达式语法:{ $isoWeekYear: <dateExpression> }参数可以是:
具有此格式的文档:
{ date: <dateExpression>, timezone: <tzExpression> }字段说明datetimezone可选。操作结果的时区。
<tzExpression>必须是有效表达式,可解析为格式为Olson 时区标识符或UTC 偏移量的字符串。如果未提供timezone,则结果采用 UTC 格式。Olson Timezone Identifier:"America/New_York""Europe/London""GMT"UTC Offset:+/-[hh]:[mm], e.g. "+04:45"+/-[hh][mm], e.g. "-0530"+/-[hh], e.g. "+03"
行为
例子 | 结果 |
|---|---|
| 2015 年 |
| 2003 |
| 2017 |
| 2016 |
| 2024 |
|
|
|
|
|
|
注意
$isoWeekYear 不能将字符串作为参数。
例子
名为 anniversaries 的集合包含以下文档:
{ "_id" : 1, "date" : ISODate("2016-01-01T00:00:00Z") }{ "_id" : 2, "date" : ISODate("2016-01-04T00:00:00Z") }{ "_id" : 3, "date" : ISODate("2015-01-01T00:00:00Z") }{ "_id" : 4, "date" : ISODate("2014-04-21T00:00:00Z") }以下操作返回每个date字段的 ISO 8601 格式的年份号。
db.anniversaries.aggregate( [ { $project: { yearNumber: { $isoWeekYear: "$date" } } }] )操作返回以下结果:
{ "_id" : 1, "yearNumber" : 2015 }{ "_id" : 2, "yearNumber" : 2016 }{ "_id" : 3, "yearNumber" : 2015 }{ "_id" : 4, "yearNumber" : 2014 }