Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

$week(聚合)

在此页面上

  • 定义
  • 行为
  • 例子
$week

用 0 到 53 之间的数字返回日期所在年份的星期。

周从星期日开始,第一周从一年的第一个星期日开始。一年中第一个星期日之前的天数位于第 0 周。此行为与 strftime 标准库函数的 "%U" 操作符相同。

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

{ $week: <dateExpression> }

参数可以是:

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

  • 具有此格式的文档:

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

    Optional. 操作结果的时区。 <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"
例子
结果
{ $week: new Date("Jan 1, 2016") }
0
{ $week: { date: new Date("2016-01-04") } }
1
{ $week: {
date: new Date("August 14, 2011"),
timezone: "America/Chicago"
} }
33
{ $week: ISODate("1998-11-01T00:00:00Z") }
44
{ $week: {
date: ISODate("1998-11-01T00:00:00Z"),
timezone: "-0500"
} }
43
{ $week: "March 28, 1976" }
error
{ $week: Date("2016-01-01") }
error
{ $week: "2009-04-09" }
error

注意

$week 不支持将字符串用作参数。

使用以下文档创建 sales 集合:

{
"_id" : 1,
"item" : "abc",
"price" : 10,
"quantity" : 2,
"date" : ISODate("2014-01-01T08:15:39.736Z")
}

以下聚合使用 $week 和其他日期操作符来拆分 date 字段:

db.sales.aggregate(
[
{
$project:
{
year: { $year: "$date" },
month: { $month: "$date" },
day: { $dayOfMonth: "$date" },
hour: { $hour: "$date" },
minutes: { $minute: "$date" },
seconds: { $second: "$date" },
milliseconds: { $millisecond: "$date" },
dayOfYear: { $dayOfYear: "$date" },
dayOfWeek: { $dayOfWeek: "$date" },
week: { $week: "$date" }
}
}
]
)

操作返回以下结果:

{
"_id" : 1,
"year" : 2014,
"month" : 1,
"day" : 1,
"hour" : 8,
"minutes" : 15,
"seconds" : 39,
"milliseconds" : 736,
"dayOfYear" : 1,
"dayOfWeek" : 4,
"week" : 0
}

后退

$unsetField

在此页面上