MongoDB में, $dateToParts
एकत्रीकरण पाइपलाइन ऑपरेटर किसी दिए गए दिनांक के दिनांक भाग लौटाता है।
अधिक विशेष रूप से, यह एक दस्तावेज़ देता है जिसमें किसी दिए गए बीएसओएन दिनांक मान के घटक भाग अलग-अलग गुणों के रूप में होते हैं।
दिनांक भाग $dateToParts
. द्वारा लौटाए गए year
हैं , month
, day
, hour
, minute
, second
और millisecond
।
$dateToParts
. का उपयोग करते समय ऑपरेटर, आप वैकल्पिक रूप से परिणाम के लिए उपयोग करने के लिए एक समय क्षेत्र निर्दिष्ट कर सकते हैं।
$dateToParts
ऑपरेटर या तो एक तिथि स्वीकार करता है (या तो एक तिथि, एक टाइमस्टैम्प, या एक ऑब्जेक्ट आईडी के रूप में), या एक दस्तावेज जो उपयोग करने के लिए दिनांक और समय क्षेत्र निर्दिष्ट करता है।
उदाहरण
मान लीजिए हमारे पास pets
. नामक संग्रह है निम्नलिखित दस्तावेज़ के साथ:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
हम born
. से विभिन्न दिनांक भागों को वापस करने के लिए निम्नलिखित कोड चला सकते हैं उस दस्तावेज़ में फ़ील्ड।
db.pets.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
}
]
).pretty()
परिणाम:
{ "dateParts" : { "year" : 2020, "month" : 12, "day" : 31, "hour" : 23, "minute" : 30, "second" : 15, "millisecond" : 123 } }
हम देख सकते हैं कि प्रत्येक दिनांक भाग अपने स्वयं के क्षेत्र में वापस आ गया है।
यहाँ, मैंने dateParts
. का उपयोग किया है वापस जाने के लिए फ़ील्ड नाम के रूप में, लेकिन यह कुछ भी हो सकता था (जैसे कि theDate
आदि)।
_id
MongoDB में अनुमानों का उपयोग करते समय फ़ील्ड डिफ़ॉल्ट रूप से लौटा दी जाती है, लेकिन इस उदाहरण में मैंने स्पष्ट रूप से _id
छुपाया है _id: 0
. का उपयोग करके फ़ील्ड ।
समयक्षेत्र निर्दिष्ट करें
आप $dateToParts
. के आउटपुट के लिए उपयोग करने के लिए एक समय क्षेत्र निर्दिष्ट कर सकते हैं ऑपरेटर।
जब आप ऐसा करते हैं, तो तर्क $dateToParts
. को पास हो जाता है निम्नलिखित रूप का होना चाहिए:
{ date: <dateExpression>, timezone: <tzExpression> }
जहां <dateExpression>
उपयोग करने की तिथि है, और <tzExpression>
उपयोग करने के लिए समय क्षेत्र है।
ओल्सन टाइमज़ोन पहचानकर्ता (उदा. "Europe/London"
का उपयोग करके समयक्षेत्र निर्दिष्ट किया जा सकता है , "GMT"
) या UTC ऑफ़सेट (उदा. "+02:30"
, "-1030"
)।
ओल्सन टाइमज़ोन आइडेंटिफ़ायर
यहां एक उदाहरण दिया गया है जो ओल्सन टाइमज़ोन आईडी का उपयोग करके दो अलग-अलग समय क्षेत्रों में दिनांक भागों को आउटपुट करता है:
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$dateToParts: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$dateToParts: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
).pretty()
परिणाम:
{ "honolulu" : { "year" : 2020, "month" : 12, "day" : 31, "hour" : 13, "minute" : 30, "second" : 15, "millisecond" : 123 }, "auckland" : { "year" : 2021, "month" : 1, "day" : 1, "hour" : 12, "minute" : 30, "second" : 15, "millisecond" : 123 } }
इस मामले में, Pacific/Auckland
का उपयोग करते समय दिनांक अगले वर्ष/माह/सप्ताह/दिन/घंटा हो जाता है समयक्षेत्र।
UTC ऑफ़सेट
यहाँ वही उदाहरण है, इस समय को छोड़कर हम UTC ऑफ़सेट का उपयोग करते हैं।
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$dateToParts: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$dateToParts: { date: "$born", timezone: "+1200" }
}
}
}
]
).pretty()
परिणाम:
{ "utcOffset-1000" : { "year" : 2020, "month" : 12, "day" : 31, "hour" : 13, "minute" : 30, "second" : 15, "millisecond" : 123 }, "utcOffset+1200" : { "year" : 2021, "month" : 1, "day" : 1, "hour" : 11, "minute" : 30, "second" : 15, "millisecond" : 123 } }
ISO सप्ताह दिनांक भाग
आप iso8601: true
. का उपयोग कर सकते हैं ISO सप्ताह दिनांक फ़ील्ड का उपयोग करने के लिए आउटपुट दस्तावेज़ को संशोधित करने के लिए। यह दिनांक ISO 8601 मानक पर आधारित है।
मान लीजिए हमारे पास cats
. नामक संग्रह है निम्नलिखित दस्तावेज़ के साथ:
{ "_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"), "name" : "Scratch", "born" : ISODate("2021-01-03T23:30:15.123Z") }
हम born
. से ISO दिनांक फ़ील्ड निकालने के लिए निम्न कोड चला सकते हैं उस दस्तावेज़ में फ़ील्ड।
प्रदर्शित करने के लिए यहां एक उदाहरण दिया गया है:
db.pets.aggregate(
[
{
$project: {
_id: 0,
dateParts: {
$dateToParts: {
date: "$born"
}
},
datePartsISO: {
$dateToParts: {
date: "$born",
iso8601: true
}
}
}
}
]
).pretty()
परिणाम:
{ "dateParts" : { "year" : 2020, "month" : 12, "day" : 31, "hour" : 23, "minute" : 30, "second" : 15, "millisecond" : 123 }, "datePartsISO" : { "isoWeekYear" : 2020, "isoWeek" : 53, "isoDayOfWeek" : 4, "hour" : 23, "minute" : 30, "second" : 15, "millisecond" : 123 } }
पहला आउटपुट दस्तावेज़ सामान्य दिनांक आउटपुट का उपयोग करता है। दूसरा दस्तावेज़ ISO सप्ताह दिनांक फ़ील्ड और मानों का उपयोग करता है।
ऑब्जेक्ट आईडी से दिनांक भाग लौटाएं
आप $dateToParts
. का उपयोग कर सकते हैं किसी ऑब्जेक्ट आईडी से दिनांक भागों को वापस करने के लिए।
ObjectId मान 12 बाइट हेक्साडेसिमल मान होते हैं जिनमें निम्न शामिल होते हैं:
- ऑब्जेक्ट आईडी के निर्माण का प्रतिनिधित्व करने वाला एक 4 बाइट टाइमस्टैम्प मान, यूनिक्स युग के बाद से सेकंड में मापा जाता है।
- 5 बाइट एक यादृच्छिक मान है
- एक 3 बाइट इंक्रीमेंटिंग काउंटर, एक यादृच्छिक मान के लिए आरंभ किया गया।
संक्षेप में, हमारा दस्तावेज़ इस तरह दिखता है:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
इस दस्तावेज़ में एक ObjectId है। इसलिए हम $dateToParts
. का उपयोग कर सकते हैं हमारे दस्तावेज़ के निर्माण की तिथि के आधार पर दिनांक भागों को वापस करने के लिए (या अधिक विशेष रूप से, जब _id
फ़ील्ड का ObjectId मान बनाया गया था)।
उदाहरण:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"dateParts": { $dateToParts: { date: "$_id" } }
}
}
]
).pretty()
परिणाम:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "dateParts" : { "year" : 2021, "month" : 1, "day" : 19, "hour" : 1, "minute" : 11, "second" : 35, "millisecond" : 0 } }
इस मामले में, मैंने $toDate
. का भी इस्तेमाल किया ऑब्जेक्ट आईडी के टाइमस्टैम्प भाग को वापस करने के लिए एकत्रीकरण पाइपलाइन ऑपरेटर।