NodaTime C# (.NET) के लिए: पूर्ण गाइड उदाहरण सहित

सॉफ्टवेयर डेवलपमेंट में तिथि और समय के साथ काम करना सबसे जटिल और त्रुटि-प्रवण कार्यों में से एक है। .NET में बिल्ट-इन DateTime और DateTimeOffset टाइप में कई बुनियादी समस्याएं हैं: स्थानीय और UTC समय के बीच भ्रम, "समय में पल" और "कैलेंडर तिथि" के बीच स्पष्ट अंतर का अभाव, समय क्षेत्रों और डेलाइट सेविंग टाइम के साथ काम करते समय अस्पष्टता। NodaTime लाइब्रेरी इन समस्याओं को हल करने के लिए बनाई गई है, जो डेवलपर्स को समय के साथ काम करने के लिए एक सुरक्षित, अभिव्यंजक और टाइप-सेफ API प्रदान करती है।

NodaTime .NET में तिथि और समय के साथ काम करने के लिए एक वैकल्पिक लाइब्रेरी है, जो Java के लिए Joda-Time लाइब्रेरी से प्रेरित है। यह समय की विभिन्न अवधारणाओं के बीच स्पष्ट अंतर प्रदान करती है: Instant (समय में पल), LocalDateTime (बिना समय क्षेत्र के तिथि और समय), ZonedDateTime (समय क्षेत्र सहित तिथि और समय), Duration (नैनोसेकंड में समय अंतराल) और Period (कैलेंडर इकाइयों में समय अंतराल)। लाइब्रेरी IANA (tzdata डेटाबेस) से समय क्षेत्र डेटा का उपयोग करती है, जो इसे बिल्ट-इन Windows तंत्रों की तुलना में अधिक सटीक और अद्यतित बनाती है।

NodaTime का मुख्य उद्देश्य समय के साथ गलत संचालन को कंपाइल टाइम पर असंभव बनाना है। उदाहरण के लिए, आप गलती से LocalDateTime को Duration के साथ नहीं जोड़ सकते (क्योंकि समय क्षेत्र के बिना इसका कोई अर्थ नहीं है), या Instant की तुलना LocalDate से नहीं कर सकते। लाइब्रेरी फ़ॉर्मेटिंग, पार्सिंग, समय क्षेत्रों और कैलेंडर सिस्टम (जूलियन, इस्लामिक और हिब्रू कैलेंडर सहित) के साथ काम करने के लिए शक्तिशाली क्षमताएं भी प्रदान करती है।

इंस्टॉलेशन

.NET प्रोजेक्ट में NodaTime इंस्टॉल करने के लिए NuGet Package Manager का उपयोग करें। निम्नलिखित कमांड में से कोई एक चलाएं:

# .NET CLI के माध्यम से (अनुशंसित)
dotnet add package NodaTime

# Package Manager Console के माध्यम से (Visual Studio)
Install-Package NodaTime

# या NuGet Package Manager UI के माध्यम से: "NodaTime" खोजें

इंस्टॉलेशन के बाद, अपनी फ़ाइल की शुरुआत में using NodaTime; डायरेक्टिव जोड़ें। समय क्षेत्रों के साथ काम करने के लिए using NodaTime.TimeZones; की भी आवश्यकता हो सकती है।

त्वरित शुरुआत

NodaTime की मुख्य क्षमताओं को प्रदर्शित करने वाला एक न्यूनतम कार्यशील उदाहरण:

using NodaTime;
using NodaTime.Text;

// 1. UTC में वर्तमान समय का पल
Instant now = SystemClock.Instance.GetCurrentInstant();
Console.WriteLine($"वर्तमान पल (UTC): {now}");

// 2. स्थानीय समय में रूपांतरण (मास्को)
DateTimeZone moscowZone = DateTimeZoneProviders.Tzdb["Europe/Moscow"];
ZonedDateTime moscowTime = now.InZone(moscowZone);
Console.WriteLine($"मास्को में समय: {moscowTime}");

// 3. एक विशिष्ट तिथि और समय बनाना
LocalDateTime localDate = new LocalDateTime(2024, 12, 25, 10, 30, 0);
Console.WriteLine($"स्थानीय तिथि: {localDate}");

// 4. स्ट्रिंग पार्स करना
var pattern = LocalDateTimePattern.CreateWithInvariantCulture("yyyy-MM-dd HH:mm:ss");
LocalDateTime parsed = pattern.Parse("2024-12-25 10:30:00").Value;
Console.WriteLine($"पार्स किया गया: {parsed}");

// 5. अवधियों के साथ काम करना
Duration duration = Duration.FromHours(2.5);
Instant future = now + duration;
Console.WriteLine($"2.5 घंटे बाद: {future.InZone(moscowZone)}");

मुख्य क्लास और तरीके

1. Instant — समय में पल

सिग्नेचर: public readonly struct Instant : IEquatable<Instant>, IComparable<Instant>

यह क्या करता है: टाइमलाइन पर एक बिंदु का प्रतिनिधित्व करता है, जिसे Unix युग (1 जनवरी 1970, 00:00:00 UTC) से नैनोसेकंड में मापा जाता है। यह समय क्षेत्रों से स्वतंत्र है।

Instant epoch = Instant.FromUnixTimeTicks(0); // Unix युग
Instant now = SystemClock.Instance.GetCurrentInstant(); // वर्तमान पल
Console.WriteLine($"युग से सेकंड: {now.ToUnixTimeSeconds()}");

2. LocalDateTime — बिना समय क्षेत्र के तिथि और समय

सिग्नेचर: public readonly struct LocalDateTime : IEquatable<LocalDateTime>, IComparable<LocalDateTime>

यह क्या करता है: एक तिथि और समय का प्रतिनिधित्व करता है, लेकिन किसी विशिष्ट समय क्षेत्र से बंधा नहीं है। कैलेंडर तिथियों और स्थानीय समय के लिए उपयोगी।

LocalDateTime newYear = new LocalDateTime(2025, 1, 1, 0, 0, 0);
Console.WriteLine($"नया साल: {newYear}");

// कैलेंडर इकाइयाँ जोड़ना
LocalDateTime nextWeek = newYear.PlusWeeks(1);
Console.WriteLine($"एक सप्ताह बाद: {nextWeek}");

3. ZonedDateTime — समय क्षेत्र सहित तिथि और समय

सिग्नेचर: public readonly struct ZonedDateTime : IEquatable<ZonedDateTime>

यह क्या करता है: एक विशिष्ट समय क्षेत्र से जुड़ी तिथि और समय का प्रतिनिधित्व करता है। यह डेलाइट सेविंग टाइम संक्रमण को सही ढंग से संभालता है।

DateTimeZone istZone = DateTimeZoneProviders.Tzdb["Asia/Kolkata"];
ZonedDateTime istTime = now.InZone(istZone);
Console.WriteLine($"भारतीय समय: {istTime}");

// समय क्षेत्र बदलना
ZonedDateTime londonTime = istTime.WithZone(DateTimeZoneProviders.Tzdb["Europe/London"]);
Console.WriteLine($"लंदन समय: {londonTime}");

4. Duration — नैनोसेकंड में समय अंतराल

सिग्नेचर: public readonly struct Duration : IEquatable<Duration>, IComparable<Duration>

यह क्या करता है: दो Instants के बीच सटीक समय अंतर का प्रतिनिधित्व करता है। कैलेंडर इकाइयों से स्वतंत्र।

Duration twoHours = Duration.FromHours(2);
Duration halfDay = Duration.FromStandardDays(0.5);
Duration total = twoHours + halfDay;
Console.WriteLine($"कुल अवधि: {total.TotalHours} घंटे");

5. Period — कैलेंडर इकाइयों में समय अंतराल

सिग्नेचर: public sealed class Period : IEquatable<Period>

यह क्या करता है: वर्ष, महीने, दिन आदि जैसी कैलेंडर इकाइयों में समय अंतर का प्रतिनिधित्व करता है। यह Duration से भिन्न है क्योंकि यह कैलेंडर पर निर्भर है।

Period oneMonth = Period.FromMonths(1);
LocalDateTime today = new LocalDateTime(2024, 3, 15, 0, 0, 0);
LocalDateTime nextMonth = today.Plus(oneMonth);
Console.WriteLine($"एक महीने बाद: {nextMonth}"); // 15 अप्रैल 2024

समय क्षेत्रों के साथ काम करना

NodaTime IANA समय क्षेत्र डेटाबेस का उपयोग करता है। सामान्य समय क्षेत्रों के उदाहरण:

// भारतीय समय (IST)
DateTimeZone indiaZone = DateTimeZoneProviders.Tzdb["Asia/Kolkata"];

// अमेरिकी समय क्षेत्र
DateTimeZone easternUS = DateTimeZoneProviders.Tzdb["America/New_York"];
DateTimeZone pacificUS = DateTimeZoneProviders.Tzdb["America/Los_Angeles"];

// यूरोपीय समय क्षेत्र
DateTimeZone londonZone = DateTimeZoneProviders.Tzdb["Europe/London"];
DateTimeZone parisZone = DateTimeZoneProviders.Tzdb["Europe/Paris"];

// सभी उपलब्ध समय क्षेत्रों की सूची प्राप्त करना
var allZones = DateTimeZoneProviders.Tzdb.Ids;
foreach (var zone in allZones.Take(5))
{
    Console.WriteLine(zone);
}

फ़ॉर्मेटिंग और पार्सिंग

NodaTime पैटर्न-आधारित फ़ॉर्मेटिंग और पार्सिंग प्रदान करता है:

using NodaTime.Text;

// कस्टम पैटर्न के साथ फ़ॉर्मेटिंग
var datePattern = LocalDatePattern.CreateWithInvariantCulture("dd/MM/yyyy");
LocalDate date = new LocalDate(2024, 12, 25);
string formatted = datePattern.Format(date);
Console.WriteLine($"फ़ॉर्मेटेड तिथि: {formatted}"); // 25/12/2024

// पार्सिंग
var parseResult = datePattern.Parse("25/12/2024");
if (parseResult.Success)
{
    Console.WriteLine($"पार्स की गई तिथि: {parseResult.Value}");
}

// ISO 8601 फ़ॉर्मेट
string isoString = Instant.FromDateTimeUtc(DateTime.UtcNow).ToString();
Console.WriteLine($"ISO 8601: {isoString}");

सर्वोत्तम अभ्यास

• Instant का उपयोग करें जब आपको केवल एक विशिष्ट पल को स्टोर करना हो (जैसे, डेटाबेस में टाइमस्टैम्प)
• ZonedDateTime का उपयोग करें जब समय क्षेत्र की जानकारी महत्वपूर्ण हो (जैसे, उपयोगकर्ता इनपुट)
• LocalDateTime का उपयोग करें केवल कैलेंडर तिथियों और स्थानीय समय के लिए, बिना समय क्षेत्र के संदर्भ के
• Duration का उपयोग करें सटीक समय अंतराल के लिए (जैसे, टाइमआउट)
• Period का उपयोग करें मानव-पठनीय अंतराल के लिए (जैसे, "3 महीने बाद")
• हमेशा DateTimeZoneProviders.Tzdb का उपयोग करें, Windows समय क्षेत्रों का नहीं
• समय क्षेत्र रूपांतरण करते समय डेलाइट सेविंग टाइम संक्रमण को संभालें

निष्कर्ष

NodaTime .NET में तिथि और समय के साथ काम करने के लिए एक शक्तिशाली और सुरक्षित विकल्प है। यह सामान्य गलतियों को रोकता है, स्पष्ट और अभिव्यंजक API प्रदान करता है, और जटिल समय क्षेत्र और कैलेंडर संचालन को सरल बनाता है। चाहे आप एक नया प्रोजेक्ट शुरू कर रहे हों या मौजूदा कोड को रिफैक्टर कर रहे हों, NodaTime आपके समय-संबंधित कोड को अधिक मजबूत और बनाए रखने में आसान बना सकता है।