6 způsobů, jak získat rok z rande v MongoDB

MongoDB poskytuje několik operátorů agregačních kanálů pro práci s daty. To zahrnuje operátory, které extrahují určité části dat, jako je rok, měsíc, den atd.

Existuje také několik metod MongoDB, které vám umožňují iterovat kurzorem a použít funkci JavaScriptu. To vám proto umožňuje používat JavaScript k extrahování hodnot data a částí data atd. z pole.

Tento článek představuje 6 způsobů, jak vrátit část roku z data v MongoDB.

Ukázková data

Předpokládejme, že máme sbírku nazvanou cats s následujícími dokumenty:

{ "_id" : 1, "name" : "Scratch", "born" : ISODate("2021-01-03T23:30:15.123Z") }
{ "_id" : 2, "name" : "Meow", "born" : ISODate("2019-12-08T04:00:12Z") }
{ "_id" : 3, "name" : "Fluffy", "born" : ISODate("2020-09-24T10:30:00Z") }

Následující příklady ukazují různé možnosti pro vrácení části roku z born pole těchto dokumentů.

$year Operátor

$year operátor je nejzřejmější volbou pro extrakci části roku z data. Je speciálně navržen tak, aby vrátil dokument s částí data s rokem.

Můžeme spustit následující kód a vrátit rok z born pole ve výše uvedeném dokumentu.

db.cats.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          birthYear: { $year: "$born" }
        }
    }
  ]
)

Výsledek:

{ "birthYear" : 2021 }
{ "birthYear" : 2019 }
{ "birthYear" : 2020 }

Při použití $year můžete také určit časové pásmo operátor.

Viz MongoDB $year pro další informace a příklady.

$dateToString Operátor

$dateToString operátor převede objekt data na řetězec podle uživatelem zadaného formátu. Uživatel tedy může určit, že v případě potřeby se vrátí pouze část roku.

Pro každou část data existují specifikátory formátu. %Y specifikátor formátu vrací rok.

Příklad:

db.cats.aggregate(
   [
     {
       $project: {
         _id: 0,
          birthYear: { $dateToString: { format: "%Y", date: "$born" } }
       }
     }
   ]
)

Výsledek:

{ "birthYear" : "2021" }
{ "birthYear" : "2019" }
{ "birthYear" : "2020" }

Mohli jsme poskytnout více specifikátorů formátu, abychom do výsledku zahrnuli části data, ale protože nás v tomto článku zajímá pouze extrahování roku, použili jsme pouze jeden specifikátor formátu.

Viz MongoDB $dateToString pro další informace a příklady.

$dateToParts Operátor

$dateToParts operátor vrátí dokument, který obsahuje součásti dané hodnoty BSON Date jako jednotlivé vlastnosti. Vrácené vlastnosti jsou year , month , day , hour , minute , second a millisecond .

Vyzbrojeni těmito znalostmi můžeme použít $dateToParts v jedné fázi potrubí a poté přidejte další fázi potrubí, která extrahuje year část.

Zde je to, co $dateToParts vrací pro naše tři dokumenty:

db.cats.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          dateParts: { $dateToParts: { date: "$born" } }
        }
    }
  ]
).pretty()

Výsledek:

{
	"dateParts" : {
		"year" : 2021,
		"month" : 1,
		"day" : 3,
		"hour" : 23,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	}
}
{
	"dateParts" : {
		"year" : 2019,
		"month" : 12,
		"day" : 8,
		"hour" : 4,
		"minute" : 0,
		"second" : 12,
		"millisecond" : 0
	}
}
{
	"dateParts" : {
		"year" : 2020,
		"month" : 9,
		"day" : 24,
		"hour" : 10,
		"minute" : 30,
		"second" : 0,
		"millisecond" : 0
	}
}

Tato data lze předat do další fáze procesu, kde se získá pouze year pole.

Co se stane, když přidáme další projekci pouze pro year pole:

db.cats.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          dateParts: { $dateToParts: { date: "$born" } }
        }
    },
    {
      $project:
        {
          birthYear: "$dateParts.year"
        }
    }
  ]
)

Výsledek:

{ "birthYear" : 2021 }
{ "birthYear" : 2019 }
{ "birthYear" : 2020 }

To samozřejmě není tak stručné jako použití předchozích možností. V závislosti na tom, co ve svém kanálu děláte, může být tento přístup užitečnou možností.

$dateToParts operátor také přijímá iso8601 parametr, který upravuje výstupní dokument tak, aby používal pole data týdne podle ISO.

Viz MongoDB $dateToParts pro další informace a příklady.

The forEach() Metoda

Můžete použít cursor.forEach() iterovat kurzorem pomocí metody JavaScript, jako je getFullYear() nebo getUTCFullYear() vrátit pouze hodnotu roku.

db.cats.find().forEach(
  function(c) {
    print(
      c.born.getFullYear()
      );
  }
);

Výsledek:

2021
2019
2020

Předchozí možnosti vrátí celý dokument, který obsahuje pár název/hodnota. Tato možnost vrátí pouze hodnotu skutečného roku, nikoli celý dokument.

map() Metoda

cursor.map() metoda aplikuje funkci na každý dokument navštívený kurzorem a kombinuje hodnoty do pole.

Příklad:

db.cats.find().map(
  function(c) {
    c = c.born.getFullYear();
    return c;
  }
);

Výsledek:

[ 2021, 2019, 2020 ]

$isoWeekYear Operátor

Pokud potřebujete vrátit rok ve formátu ISO 8601, použijte $isoWeekYear . Rok ISO 8601 začíná pondělím týdne 1 a končí nedělí posledního týdne.

Příklad:

db.cats.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          birthIsoWeekYear: { $isoWeekYear: "$born" }
        }
    }
  ]
)

Výsledek:

{ "birthIsoWeekYear" : NumberLong(2020) }
{ "birthIsoWeekYear" : NumberLong(2019) }
{ "birthIsoWeekYear" : NumberLong(2020) }

Všimněte si, že prvním rokem je nyní rok 2020 namísto roku 2021 jako v předchozích příkladech. Při použití $isoWeekYear se nebudou všechny roky lišit , protože to závisí na příslušném datu.