MongoDB $segundo

No MongoDB, o $second operador de pipeline de agregação retorna a segunda parte de uma data como um número entre 0 e 59 . O valor também pode ser 60 para contabilizar os segundos bissextos sempre que aplicável.

Opcionalmente, você pode especificar um fuso horário a ser usado para o resultado.

O $second 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 a segunda parte do born campo nesse documento.

db.pets.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          birthSecond: { $second: "$born" }
        }
    }
  ]
)

Resultado:

{ "birthSecond" : 15 }

Aqui, usei birthSecond como o nome do campo a ser retornado, mas pode ser qualquer coisa (como secondsAtBirth , seconds , 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 $second operador.

Quando você faz isso, o argumento é passado para $second 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 os segundos em dois fusos horários diferentes, cada um usando os IDs de fuso horário Olson:

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          kabul: { 
            $second: { date: "$born", timezone: "Asia/Kabul" }
            },
          brisbane: { 
            $second: { date: "$born", timezone: "Australia/Brisbane" }
            }
        }
    }
  ]
)

Resultado:

{ "kabul" : 15, "brisbane" : 15 }

Visto que a mudança de fuso horário não afeta a parte dos segundos, o resultado é o mesmo.

Deslocamento UTC

Neste exemplo, usamos o deslocamento UTC.

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          "utcOffset+04:30": { 
            $second: { date: "$born", timezone: "+04:30" }
            },
          "utcOffset+05:45": { 
            $second: { date: "$born", timezone: "+05:45" }
            }
        }
    }
  ]
)

Resultado:

{ "utcOffset+04:30" : 15, "utcOffset+05:45" : 15 }

Retorne os segundos de um ObjectId

Você pode usar $second para retornar a parte de segundos 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 $second para retornar o segundo 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"},
          "second": { $second: "$_id" }
        }
    }
  ]
).pretty()

Resultado:

{
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
	"second" : 35
}

Podemos ver que o documento foi criado no 35º segundo (do 11º minuto da 1ª hora do dia).

Nesse caso, também usei o $toDate operador de pipeline de agregação para retornar a parte de carimbo de data/hora do ObjectId.