लिटिल चमत्कार C # /। NET - DateTimeOffset संरचना

आइए .Net फ्रेमवर्क के कुछ हिस्सों पर विचार करें जो तुच्छ दिखते हैं, लेकिन लिखित और रखरखाव दोनों में आपके कोड को सरल बनाने में काफी सक्षम हैं।


.NET में लिखने वाले (और यदि आप ऐसा नहीं करते हैं, तो इस पोस्ट को व्यर्थ में पढ़ रहे हैं) शायद अपनी जरूरतों के लिए समय-समय पर डेटटाइम संरचना का उपयोग करेंगे। यह संरचना स्थानीय समय क्षेत्र (या यूटीसी) से संबंधित तिथियों, समय या तिथियों / समय के भंडारण के लिए सुविधाजनक है।


हालांकि, ऐसे समय होते हैं जब आपको समय को एक ऑफसेट के रूप में सहेजने की आवश्यकता होती है, और इसे स्थानीय समय में परिवर्तित नहीं करते हैं। और यहां, पहली बार .NET 3.5 में दिखाई देने वाली संरचना - DateTimeOffset - आपकी सहायता के लिए आएगी।

समस्या: डेटटाइम पार्सिंग से स्थानीय समय में रूपांतरण हो सकता है

कल्पना करें कि आप किसी फ़ाइल, वेब सेवा आदि का उपयोग कर रहे हैं। कुछ तृतीय-पक्ष कंपनी जिनके सर्वर एक अलग समय क्षेत्र में हैं। इसके अलावा, उनके पास लौटे डेटा में कई फ़ील्ड हैं, जिनमें तारीखें होनी चाहिए, लेकिन वास्तव में डेटाइम संरचना के क्रमबद्ध उदाहरण हैं, जिसमें आधी रात को सेट किया गया है। उदाहरण के लिए, वे इस रूप में रोगी के जन्म की तारीख को प्रेषित करते हैं:

2012-03-01 00: 00: 00-05: 00

ऐसा रिकॉर्ड इंगित करता है कि व्यक्ति 1 मार्च 2012 को अनिर्दिष्ट समय पर पैदा हुआ था (अंत में, अधिकांश रूपों को आपको अपने जन्म के समय को भरने की आवश्यकता नहीं है)। लेकिन जब से डेटटाइम संरचना का एक उदाहरण "हेड-ऑन" क्रमबद्ध किया गया था, इसमें मध्य समय अपने समय क्षेत्र के अनुसार निर्धारित होता है।


इसलिए, यह जानते हुए कि यह तिथि पूर्वी समय क्षेत्र के साथ संगत है, और हम केंद्रीय समय क्षेत्र में हैं, हम इसे इस तरह से पार्स करते हैं:

// // ..
var dateString = "2012-03-01 00:00:00-05:00";
// DateTime
var birthDay = DateTime.Parse(dateString);

सही लगता है, है ना? लेकिन यहाँ समस्या है। यदि हम अपने स्थानीय मशीन पर DateTime ऑब्जेक्ट की सामग्री की जाँच करते हैं जहाँ केन्द्रीय समय क्षेत्र सेट है, तो हम इसे देखेंगे:

2012-02-29 11:00:00 अपराह्न

क्या हुआ? (या जैसा कि एक चरित्र ने कहा - यह किसने किया?) हाँ, DateTime.Parse () विधि ने स्थानीय समय क्षेत्र में तारीख को परिवर्तित कर दिया क्योंकि जन्म की मूल तिथि निर्दिष्ट ऑफसेट के साथ संग्रहीत थी। उन्होंने आपको केवल एक सेवा प्रदान की है - उन्होंने निर्दिष्ट तारीख और समय को आपकी स्थानीय तारीख और समय में बदल दिया है। यह इतना बुरा नहीं है अगर यह जन्मदिन के बारे में नहीं था, जो 1 मार्च से 29 फरवरी तक चला गया।


बेशक, हम तीसरे पक्ष को फोन कर सकते हैं और तारीख के साथ स्ट्रिंग में समय को रोकने या समय के साथ ऑफसेट भेजने को रोकने के लिए कह सकते हैं (इस मामले में, यह स्थानीय समय में परिवर्तित नहीं होगा, लेकिन DateTimeKind.Unececified के रूप में चिह्नित किया जाएगा)।


हालांकि, ऐसा होता है कि हमारे पास इस तरह से बदलाव करने का अवसर नहीं है।


ऐसे समय होते हैं जब आप ऑफ़सेट के साथ दिनांक और समय पढ़ना चाहते हैं, लेकिन इसे स्थानीय समय क्षेत्र में परिवर्तित नहीं करते हैं। और यहाँ DateTimeOffset काम आता है।

DateTimeOffset - DateTime और ऑफसेट को संग्रहीत करता है

तो क्या DateTimeOffset के बारे में? संरचना अपने नाम के समान सरल है, DateTimeOffset दिनांक + समय + ऑफसेट है। यही कारण है कि यह समय में बहुत अधिक सटीक बिंदु का प्रतिनिधित्व करता है, क्योंकि इसमें उन ऑफसेट के बारे में जानकारी शामिल है, जिस पर वर्तमान तिथि और समय निर्धारित किया गया था।


सच में, DateTime और DateTimeOffset की कार्यक्षमता कई मायनों में ओवरलैप होती है, और चूंकि Microsoft के पास एक या दूसरे को चुनने के लिए एक गाइड है, मैं आपको सलाह देता हूं कि आप MSDN पर इसके साथ खुद को परिचित करें। आलेख "DateTime, DateTimeOffset और TimeZoneInfo के बीच चयन करने" का हकदार है।


सामान्य तौर पर, आप डेटटाइम का उपयोग कर सकते हैं यदि आप एक ही समय क्षेत्र में "संलग्न" हैं या यूटीसी में केवल सार्वभौमिक समय का उपयोग करते हैं। लेकिन अगर आप अलग-अलग समय क्षेत्रों से दिनांक और समय का उपयोग करना चाहते हैं, और स्थानीय समय में परिवर्तित किए बिना ऑफसेट जानकारी को भी सहेजना चाहते हैं, तो बेहतर है कि DateTimeOffset का उपयोग करें।


DateTimeOffset संरचना में डेटाइम संरचना (दिन, महीना, वर्ष, घंटा, मिनट, दूसरा, आदि) के समान ही कई गुण हैं, इसलिए मैंने उनका वर्णन यहाँ नहीं किया। मुख्य अंतर कई नई विशेषताएं हैं:

दिनांक समय

ऑफ़सेट के बिना एक डेटटाइम लौटाता है।

LocalDateTime

ऑफ़सेट (यानी स्थानीय समय क्षेत्र में) को ध्यान में रखते हुए परिवर्तित डेटटाइम लौटाता है।

ओफ़्सेट

UTC के सापेक्ष ऑफ़सेट लौटाता है।

UtcDateTime

UTC समय के रूप में दिनांक समय देता है।


DateTime संपत्ति आपको एक DateTime (स्थानीय समय क्षेत्र में नहीं डाली गई) लौटाती है, और ऑफसेट संपत्ति में TimeSpan प्रारूप है, जो UTC से ऑफ़सेट का प्रतिनिधित्व करता है। इसमें LocalDateTime और UtcDateTime गुण भी हैं जो दिए गए DateTimeOffset को स्थानीय समय क्षेत्र या UTC के लिए DateTime में परिवर्तित करते हैं।


मैं यह भी नोट करता हूं कि DateTimeOffset संरचना के Now और UtcNow गुण DateTime प्रकार को वापस नहीं करते हैं, लेकिन DateTimeOffsets UTC से संबंधित ऑफसेट के साथ। बेशक, DateTime की तरह, DateTimeOffset के पास ऐसे तरीके हैं जो दिनांक / समय के साथ सौदा करते हैं, DateTimeOffset प्रकार को DateTime के बजाय वापस करते हैं।


तो यह सब कैसे उपरोक्त उदाहरण में हमारी मदद करता है? अब हम जानते हैं कि तीसरा पक्ष हमें अपने समय क्षेत्र की तारीख और समय भेजता है, जिसे स्थानीय तिथि / समय में बदलने की आवश्यकता नहीं है। इसलिए, आप DateTimeOffset.Parse () (या TryParse ()) का उपयोग कर सकते हैं और केवल तारीख का चयन कर सकते हैं:

// // ..
var dateString = "2012-03-01 00:00:00-05:00";
// / ( /)
var dtOffset = DateTimeOffset.Parse(dateString);
// DateTime
// Date
//
var theDay = dtOffset.Date;

इस प्रकार, आप आसानी से "मध्यरात्रि पारी" को ट्रैक किए बिना तिथियों को पार्स कर सकते हैं या इसका उपयोग कर सकते हैं जहां आपको स्थानीय समय में परिवर्तित किए बिना एक तिथि, समय और ऑफसेट की आवश्यकता होती है।

परिणाम

हालाँकि दिनांक समय / समय को पार्स करने, जोड़-तोड़ करने और तुलना करने के मामले में डेटटाइम संरचना काफी शक्तिशाली है, लेकिन यह विभिन्न समय क्षेत्रों के प्रारूप में तारीखों के साथ काम करने में बहुत अप्रिय मिनटों का वितरण कर सकता है। इस मामले में DateTimeOffset अधिक लचीला है, क्योंकि यह UTC से ऑफसेट का उपयोग करता है।


V.F. एलियन उर्फ ​​hDrummer द्वारा मुफ्त अनुवाद (c), यहाँ मूल है ।