$isoWeek (aggregation)
On this page
Definition
-
$isoWeek
-
New in version 3.4.
Returns the week number in ISO 8601 format, ranging from
1
to53
. Week numbers start at1
with the week (Monday through Sunday) that contains the year’s first Thursday.The
$isoWeek
expression has the following operator expression syntax:Changed in version 3.6.
The argument must be a valid expression that resolves to one of the following:
A document of the following form:
New in version 3.6.
Field Description date
The date to which the operator is applied. <dateExpression>
must be a valid expression that resolves to a Date, a Timestamp, or an ObjectID.timezone
Optional.
The timezone of the operation result.<tzExpression>
must be a valid expression that resolves to a string formatted as either an Olson Timezone Identifier or a UTC Offset . If notimezone
is provided, the result is displayed inUTC
.Format
Examples
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"
Behavior
Example | Result |
---|---|
1 | |
53 | |
32 | |
45 | |
44 | |
error |
|
error |
|
error |
Note
$isoWeek
cannot take a string as an argument.