MongoDB $secondo

In MongoDB, il $second l'operatore della pipeline di aggregazione restituisce la seconda parte di una data come numero compreso tra 0 e 59 . Il valore può anche essere 60 per tenere conto dei secondi intercalari quando applicabile.

Puoi facoltativamente specificare un fuso orario da utilizzare per il risultato.

Il $second operatore accetta una data (come una data, un timestamp o un ObjectId) o un documento che specifica la data e il fuso orario da utilizzare.

Esempio

Supponiamo di avere una collezione chiamata pets con il seguente documento:

{
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"name" : "Fetch",
	"born" : ISODate("2020-12-31T23:30:15.123Z")
}

Possiamo eseguire il codice seguente per estrarre la seconda porzione da born campo in quel documento.

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

Risultato:

{ "birthSecond" : 15 }

Qui ho usato birthSecond come nome del campo da restituire, ma potrebbe essere qualsiasi cosa (come secondsAtBirth , seconds , eccetera).

Il _id il campo viene restituito per impostazione predefinita quando si utilizzano le proiezioni in MongoDB, ma in questo esempio ho nascosto esplicitamente _id campo utilizzando _id: 0 .

Specifica un fuso orario

Puoi specificare un fuso orario da utilizzare per l'output di $second operatore.

Quando lo fai, l'argomento passa a $second deve essere della seguente forma:

{ date: <dateExpression>, timezone: <tzExpression> }

Dove <dateExpression> è la data da utilizzare e <tzExpression> è il fuso orario da utilizzare.

Il fuso orario può essere specificato utilizzando l'identificatore del fuso orario Olson (ad es. "Europe/London" , "GMT" ) o l'offset UTC (ad es. "+02:30" , "-1030" ).

Identificatore di fuso orario Olson

Ecco un esempio che restituisce i secondi in due diversi fusi orari, ciascuno dei quali utilizza gli ID fuso orario Olson:

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

Risultato:

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

Dato che la modifica del fuso orario non influisce sulla parte dei secondi, il risultato è lo stesso.

Offset UTC

In questo esempio utilizziamo l'offset 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" }
            }
        }
    }
  ]
)

Risultato:

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

Restituisci i secondi da un ObjectId

Puoi usare $second per restituire la parte dei secondi da un ObjectId.

I valori ObjectId sono valori esadecimali a 12 byte costituiti da:

• Un valore di timestamp di 4 byte, che rappresenta la creazione dell'ObjectId, misurato in secondi dall'epoca di Unix.
• Un 5 byte è un valore casuale
• Un contatore incrementale di 3 byte, inizializzato su un valore casuale.

Per ricapitolare, il nostro documento si presenta così:

{
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"name" : "Fetch",
	"born" : ISODate("2020-12-31T23:30:15.123Z")
}

Questo documento contiene un ObjectId. Possiamo quindi usare $second per restituire il secondo in cui il nostro documento è stato creato (o più specificamente, quando il _id è stato creato il valore ObjectId del campo).

Esempio:

db.pets.aggregate(
  [
    {
      $project:
        {
          "timeStamp": { $toDate: "$_id"},
          "second": { $second: "$_id" }
        }
    }
  ]
).pretty()

Risultato:

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

Possiamo vedere che il documento è stato creato il 35° secondo (dell'11° minuto della 1° ora del giorno).

In questo caso, ho utilizzato anche $toDate operatore della pipeline di aggregazione per restituire la parte timestamp di ObjectId.