मोंगोडीबी $वर्ष

MongoDB में, $year एकत्रीकरण पाइपलाइन ऑपरेटर किसी दिए गए दिनांक का वर्ष भाग लौटाता है।

$year . का उपयोग करते समय ऑपरेटर, आप वैकल्पिक रूप से परिणाम के लिए उपयोग करने के लिए एक समय क्षेत्र निर्दिष्ट कर सकते हैं।

$year ऑपरेटर या तो एक तिथि स्वीकार करता है (या तो एक तिथि, एक टाइमस्टैम्प, या एक ऑब्जेक्ट आईडी के रूप में), या एक दस्तावेज जो उपयोग करने के लिए दिनांक और समय क्षेत्र निर्दिष्ट करता है।

उदाहरण

मान लीजिए हमारे पास pets . नामक संग्रह है निम्नलिखित दस्तावेज़ के साथ:

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

हम born . से वर्ष वापस करने के लिए निम्नलिखित कोड चला सकते हैं उस दस्तावेज़ में फ़ील्ड।

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

परिणाम:

{ "birthYear" : 2020 } 

हम देख सकते हैं कि वर्ष 2020 वापस किया जाता है।

यहां, मैंने birthYear का उपयोग किया है वापस जाने के लिए फ़ील्ड नाम के रूप में, लेकिन यह कुछ भी हो सकता था (जैसे yearBorn , year , आदि)।

_id MongoDB में अनुमानों का उपयोग करते समय फ़ील्ड डिफ़ॉल्ट रूप से लौटा दी जाती है, लेकिन इस उदाहरण में मैंने स्पष्ट रूप से _id छुपाया है _id: 0 . का उपयोग करके फ़ील्ड ।

समयक्षेत्र निर्दिष्ट करें

आप $year . के आउटपुट के लिए उपयोग करने के लिए एक समय क्षेत्र निर्दिष्ट कर सकते हैं ऑपरेटर।

जब आप ऐसा करते हैं, तो तर्क $year . के पास चला जाता है निम्नलिखित रूप का होना चाहिए:

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

जहां <dateExpression> उपयोग करने की तिथि है, और <tzExpression> उपयोग करने के लिए समय क्षेत्र है।

ओल्सन टाइमज़ोन पहचानकर्ता (उदा. "Europe/London" का उपयोग करके समयक्षेत्र निर्दिष्ट किया जा सकता है , "GMT" ) या UTC ऑफ़सेट (उदा. "+02:30" , "-1030" )।

ओल्सन टाइमज़ोन आइडेंटिफ़ायर

यहां एक उदाहरण दिया गया है जो साल को दो अलग-अलग टाइमज़ोन में आउटपुट करता है, प्रत्येक ओल्सन टाइमज़ोन आईडी का उपयोग करता है:

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          honolulu: { 
            $year: { date: "$born", timezone: "Pacific/Honolulu" }
            },
          auckland: { 
            $year: { date: "$born", timezone: "Pacific/Auckland" }
            }
        }
    }
  ]
)

परिणाम:

{ "honolulu" : 2020, "auckland" : 2021 } 

इस मामले में, Pacific/Auckland का उपयोग करते समय दिनांक अगले वर्ष की ओर बढ़ जाता है समयक्षेत्र।

UTC ऑफ़सेट

यहाँ वही उदाहरण है, इस समय को छोड़कर हम UTC ऑफ़सेट का उपयोग करते हैं।

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          "utcOffset-1000": { 
            $year: { date: "$born", timezone: "-1000" }
            },
          "utcOffset+1200": { 
            $year: { date: "$born", timezone: "+1200" }
            }
        }
    }
  ]
)

परिणाम:

{ "utcOffset-1000" : 2020, "utcOffset+1200" : 2021 }

ऑब्जेक्ट आईडी से वर्ष वापस करें

आप $year . का उपयोग कर सकते हैं ऑब्जेक्ट आईडी से वर्ष के हिस्से को वापस करने के लिए।

ObjectId मान 12 बाइट हेक्साडेसिमल मान होते हैं जिनमें निम्न शामिल होते हैं:

• ऑब्जेक्ट आईडी के निर्माण का प्रतिनिधित्व करने वाला एक 4 बाइट टाइमस्टैम्प मान, यूनिक्स युग के बाद से सेकंड में मापा जाता है।
• 5 बाइट एक यादृच्छिक मान है
• एक 3 बाइट इंक्रीमेंटिंग काउंटर, एक यादृच्छिक मान के लिए आरंभ किया गया।

संक्षेप में, हमारा दस्तावेज़ इस तरह दिखता है:

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

इस दस्तावेज़ में एक ObjectId है। इसलिए हम $year . का उपयोग कर सकते हैं उस वर्ष को वापस करने के लिए जब हमारा दस्तावेज़ बनाया गया था (या अधिक विशेष रूप से, जब _id फ़ील्ड का ObjectId मान बनाया गया था)।

उदाहरण:

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

परिणाम:

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

हम देख सकते हैं कि दस्तावेज़ 2021 में बनाया गया था।

इस मामले में, मैंने $toDate . का भी इस्तेमाल किया ऑब्जेक्ट आईडी के टाइमस्टैम्प भाग को वापस करने के लिए एकत्रीकरण पाइपलाइन ऑपरेटर।

ISO वर्ष

आप $isoWeekYear . का भी उपयोग कर सकते हैं ऑपरेटर को आईएसओ वीक-नंबरिंग वर्ष (यानी आईएसओ 8601 प्रारूप का उपयोग करके वर्ष संख्या) वापस करने के लिए।