Docs 菜单
Docs 主页
/
MongoDB Manual
/
聚合操作
/
参考
/
操作符

$isoWeekYear（聚合）

在此页面上

  • 定义
  • 行为
  • 例子

定义

$isoWeekYear

以 ISO 8601 格式返回年份号。 年从第一周的星期一开始，到最后一周的星期日结束。

$isoWeekYear 表达式采用以下 操作符表达式语法：

{ $isoWeekYear: <dateExpression> }

参数可以是：

  • 可解析为日期、时间戳或对象标识符的表达式。

  • 具有此格式的文档：

    { date: <dateExpression>, timezone: <tzExpression> }
    字段
    说明
    date
    应用操作符的日期。<dateExpression> 必须是解析为日期、时间戳或对象标识符的有效表达式。
    timezone

    可选。 操作结果的时区。 <tzExpression>string必须是有效表达式，可解析为格式为 Olson 时区标识符 或 UTC 偏移量的字符串。如果未提供 timezone，则结果采用 UTC 格式。

    format
    示例
    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"

行为

例子
结果
{ $isoWeekYear: new Date("2015-05-26") }
2015 年
{ $isoWeekYear: { date: new Date("Jan 7, 2003") } }
2003
{ $isoWeekYear: ISODate("2017-01-02T00:00:00Z") }
2017
{ $isoWeekYear: {
    date: ISODate("2017-01-02T00:00:00Z"),
    timezone: "-0500"
} }
2016
{ $isoWeekYear: {
    date: new Date("April 08, 2024"),
    timezone: "America/Chicago"
} }
2024
{ $isoWeekYear: "March 28, 1976" }
error
{ $isoWeekYear: Date("2016-01-01") }
error
{ $isoWeekYear: "2009-04-09" }
error

注意

$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 }

提示

另请参阅：

后退

$isoWeek

来年

$last

在此页面上