MongoDB $ milisekunda

V MongoDB, $millisecond operátor agregačního kanálu vrátí milisekundovou část data jako celé číslo mezi 0 a 999 .

Volitelně můžete zadat časové pásmo, které se použije pro výsledek.

$millisecond operátor přijímá buď datum (jako datum, časové razítko nebo ObjectId), nebo dokument, který určuje datum a časové pásmo, které se má použít.

Příklad

Předpokládejme, že máme sbírku nazvanou pets s následujícím dokumentem:

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

Můžeme spustit následující kód a extrahovat milisekundovou část z born pole v tomto dokumentu.

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

Výsledek:

{ "birthMilliSecond" : 123 }

Zde jsem použil birthMilliSecond jako název pole, které se má vrátit, ale mohlo to být cokoliv (například milliSecondsAtBirth , milliSeconds , atd).

_id pole je vráceno ve výchozím nastavení při použití projekcí v MongoDB, ale v tomto příkladu jsem explicitně skryl _id pole pomocí _id: 0 .

Zadejte časové pásmo

Můžete zadat časové pásmo, které se použije pro výstup $millisecond operátor.

Když to uděláte, argument se předá do $millisecond musí mít následující tvar:

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

Kde <dateExpression> je datum použití a <tzExpression> je časové pásmo, které se má použít.

Časové pásmo lze zadat buď pomocí identifikátoru časového pásma Olson (např. "Europe/London" , "GMT" ) nebo offset UTC (např. "+02:30" , "-1030" ).

Olsonův identifikátor časového pásma

Zde je příklad, který zobrazuje milisekundy ve dvou různých časových pásmech, každé s použitím Olsonových ID časových pásem:

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

Výsledek:

{ "kabul" : 123, "brisbane" : 123 } 

Vzhledem k tomu, že změna časového pásma nemá vliv na část milisekund, výsledek je stejný.

Posun UTC

V tomto příkladu používáme offset UTC.

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

Výsledek:

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

Vrátí milisekundy z ObjectId

Můžete použít $millisecond vrátíte část milisekund z ObjectId.

Hodnoty ObjectId jsou 12bajtové hexadecimální hodnoty, které se skládají z:

• Čtyřbajtová hodnota časového razítka představující vytvoření ObjectId, měřená v sekundách od epochy Unixu.
• 5 bajtů je náhodná hodnota
• 3bajtový inkrementační čítač, inicializovaný na náhodnou hodnotu.

Abychom to shrnuli, náš dokument vypadá takto:

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

Tento dokument obsahuje ObjectId. Můžeme tedy použít $millisecond vrátit milisekundovou část z tohoto ObjectId.

Jak však již bylo zmíněno, časová zóna ObjectId se měří pouze v sekundách od epochy Unixu, a proto nezahrnuje část v milisekundách.

Příklad:

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

Výsledek:

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

Vidíme, že časové razítko nezahrnuje část milisekund a výsledek je 0 .

V tomto případě jsem také použil $toDate operátor agregačního kanálu, aby vrátil část ObjectId s časovým razítkem.