En MongoDB, el $isoDayOfWeek el operador de canalización de agregación devuelve el número del día de la semana en formato ISO 8601, que va desde 1 (para el lunes) a 7 (para el domingo).
Opcionalmente, puede especificar una zona horaria para usar para el resultado.
El $isoDayOfWeek El operador acepta una fecha (como una fecha, una marca de tiempo o un Id. de objeto) o un documento que especifica la fecha y la zona horaria a utilizar.
Ejemplo
Supongamos que tenemos una colección llamada pets con el siguiente documento:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
Podemos ejecutar el siguiente código para extraer el día ISO de la semana del born campo en ese documento.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthIsoDayOfWeek: { $isoDayOfWeek: "$born" }
}
}
]
)Resultado:
{ "birthIsoDayOfWeek" : 4 }
En este caso obtenemos un resultado de 4, que es un resultado diferente al que obtengo cuando uso el $dayOfWeek operador contra el mismo documento.
Aquí, usé birthIsoDayOfWeek como el nombre del campo a devolver, pero podría haber sido cualquier cosa (como isoDayOfWeek , day , etc).
El _id El campo se devuelve de forma predeterminada cuando se usan proyecciones en MongoDB, pero en este ejemplo oculté explícitamente el _id campo usando _id: 0 .
Especifique una zona horaria
Puede especificar una zona horaria para usar para la salida de $isoDayOfWeek operador.
Cuando haces esto, el argumento pasa a $isoDayOfWeek debe ser de la siguiente forma:
{ date: <dateExpression>, timezone: <tzExpression> }
Donde <dateExpression> es la fecha a usar, y <tzExpression> es la zona horaria a utilizar.
La zona horaria se puede especificar utilizando el identificador de zona horaria de Olson (por ejemplo, "Europe/London" , "GMT" ) o el desplazamiento UTC (por ejemplo, "+02:30" , "-1030" ).
Identificador de zona horaria de Olson
Este es un ejemplo que muestra el día en dos zonas horarias diferentes, cada una con los ID de zona horaria de Olson:
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$isoDayOfWeek: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$isoDayOfWeek: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
)Resultado:
{ "honolulu" : 4, "auckland" : 5 } Desplazamiento UTC
Este es el mismo ejemplo, excepto que esta vez usamos el desplazamiento UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$isoDayOfWeek: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$isoDayOfWeek: { date: "$born", timezone: "+1200" }
}
}
}
]
)Resultado:
{ "utcOffset-1000" : 4, "utcOffset+1200" : 5 } Devolver el día de la semana desde un ObjectId
Puedes usar $isoDayOfWeek para devolver la parte del día de la semana ISO de un ObjectId.
Los valores de ObjectId son valores hexadecimales de 12 bytes que constan de:
- Un valor de marca de tiempo de 4 bytes, que representa la creación del ObjectId, medido en segundos desde la época de Unix.
- Un byte de 5 es un valor aleatorio
- Un contador incremental de 3 bytes, inicializado a un valor aleatorio.
En resumen, nuestro documento se ve así:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
Este documento contiene un ObjectId. Por lo tanto, podemos usar $isoDayOfWeek para devolver el día ISO de la semana en que se creó nuestro documento (o más específicamente, cuando el _id se creó el valor ObjectId del campo).
Ejemplo:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"isoDayOfWeek": { $isoDayOfWeek: "$_id" }
}
}
]
).pretty()Resultado:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
"isoDayOfWeek" : 2
} Podemos ver que el documento se creó el segundo día de la semana al usar el formato ISO 8601.
En este caso, también usé el $toDate operador de canalización de agregación para devolver la parte de la marca de tiempo del ObjectId.
