No MongoDB, o
$isoDayOfWeek operador de pipeline de agregação retorna o número do dia da semana no formato ISO 8601, variando de 1 (para segunda-feira) para 7 (para domingo). Opcionalmente, você pode especificar um fuso horário a ser usado para o resultado.
O
$isoDayOfWeek O operador aceita uma data (como Date, Timestamp ou ObjectId) ou um documento que especifica a data e o fuso horário a serem usados. Exemplo
Suponha que tenhamos uma coleção chamada
pets com o seguinte documento:{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
} Podemos executar o seguinte código para extrair o dia ISO da semana do
born campo nesse documento. db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthIsoDayOfWeek: { $isoDayOfWeek: "$born" }
}
}
]
)Resultado:
{ "birthIsoDayOfWeek" : 4 } Nesse caso, obtemos um resultado 4, que é um resultado diferente do que recebo ao usar o
$dayOfWeek operador contra o mesmo documento. Aqui, usei
birthIsoDayOfWeek como o nome do campo a ser retornado, mas pode ser qualquer coisa (como isoDayOfWeek , day , etc). O
_id campo é retornado por padrão ao usar projeções no MongoDB, mas neste exemplo eu escondi explicitamente o _id campo usando _id: 0 . Especificar um fuso horário
Você pode especificar um fuso horário a ser usado para a saída do
$isoDayOfWeek operador. Quando você faz isso, o argumento é passado para
$isoDayOfWeek deve ter a seguinte forma:{ date: <dateExpression>, timezone: <tzExpression> }Onde
<dateExpression> é a data a ser usada e <tzExpression> é o fuso horário a ser usado. O fuso horário pode ser especificado usando o identificador de fuso horário Olson (por exemplo,
"Europe/London" , "GMT" ) ou o deslocamento UTC (por exemplo, "+02:30" , "-1030" ). Identificador de fuso horário Olson
Aqui está um exemplo que gera o dia em dois fusos horários diferentes, cada um usando os IDs de fuso horário 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 } Deslocamento UTC
Aqui está o mesmo exemplo, exceto que desta vez usamos o deslocamento 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 } Retorne o dia da semana de um ObjectId
Você pode usar
$isoDayOfWeek para retornar a parte do dia da semana ISO de um ObjectId. Os valores ObjectId são valores hexadecimais de 12 bytes que consistem em:
- Um valor de carimbo de data/hora de 4 bytes, representando a criação do ObjectId, medido em segundos desde a época do Unix.
- Um valor de 5 bytes é aleatório
- Um contador de incremento de 3 bytes, inicializado com um valor aleatório.
Para recapitular, nosso documento se parece com isso:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
} Este documento contém um ObjectId. Podemos, portanto, usar
$isoDayOfWeek para retornar o dia ISO da semana em que nosso documento foi criado (ou mais especificamente, quando o _id valor ObjectId do campo foi criado). Exemplo:
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 o documento foi criado no 2º dia da semana ao usar o formato ISO 8601.
Nesse caso, também usei o
$toDate operador de pipeline de agregação para retornar a parte de carimbo de data/hora do ObjectId. 
