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

在此页面上