对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

$isoWeekYear(表达式操作符)

$isoWeekYear

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

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

{ $isoWeekYear: <dateExpression> }

参数可以是:

  • 具有此格式的文档:

    { date: <dateExpression>, timezone: <tzExpression> }
    字段
    说明

    date

    应用操作符的日期。<dateExpression> 必须是解析为日期、时间戳或对象标识符的有效表达式。

    timezone

    可选。操作结果的时区。<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"
例子
结果
{ $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 }
给本页内容打分

在此页面上