Go में टाइमज़ोन: घंटा, दिन या डेटा कैसे न खोएं

परिचय: समय सिर्फ टिक-टॉक नहीं है

अगर आपने कभी Go में कोई ऐसा एप्लिकेशन लिखा है जो अलग-अलग देशों के यूज़र्स और डेट के साथ काम करता है, तो आपने "टाइमज़ोन" नामक सिरदर्द का सामना ज़रूर किया होगा। लगता है इसमें क्या मुश्किल है? बस time.Now() लिया और काम खत्म। लेकिन यह तब तक ठीक है जब तक आपका सर्वर UTC पर न हो और क्लाइंट MSK+3 पर, और आपका "आज" जादुई रूप से "कल" में न बदल जाए।

इस लेख में हम वास्तविक उदाहरणों के साथ, बिना अनावश्यक बातों के और तैयार कोड के साथ, Go में टाइमज़ोन के साथ सही तरीके से काम करना सीखेंगे। आप जानेंगे कि डेटा कैसे न खोएं, डिबगिंग में पागल न हों, और अपने एप्लिकेशन को टाइमज़ोन के प्रति मज़बूत बनाएं। चलिए शुरू करते हैं!

बेसिक: time.Time के पीछे क्या है

Go में time.Time टाइप सिर्फ मिलीसेकंड की संख्या नहीं है। यह एक स्ट्रक्चर है जो दो मुख्य घटकों को स्टोर करता है:

\n
• एब्सोल्यूट टाइम — 1 जनवरी 1970 (unix timestamp) से नैनोसेकंड की संख्या।
\n
• Location — टाइमज़ोन (समय क्षेत्र) का पॉइंटर।
\n

यह Location ही तय करता है कि समय कैसे दिखेगा: 14:00 MSK या 11:00 UTC। शुरुआती लोगों की सबसे बड़ी गलती यह सोचना है कि time.Now() "लोकल टाइम" लौटाता है। असल में यह सर्वर के लोकल टाइमज़ोन के साथ वर्तमान समय लौटाता है। कोड को दूसरे सर्वर पर ले जाएं — और सब कुछ "बदल" जाएगा।

किसी विशिष्ट ज़ोन के साथ समय कैसे बनाएं

सबसे आसान तरीका time.LoadLocation का उपयोग करना है। यह सिस्टम के IANA डेटाबेस (आमतौर पर /usr/share/zoneinfo में) से ज़ोन लोड करता है।

package main\n\nimport (\n    "fmt"\n    "time"\n)\n\nfunc main() {\n    loc, err := time.LoadLocation("Europe/Moscow")\n    if err != nil {\n        panic(err)\n    }\n\n    // किसी विशिष्ट ज़ोन में समय बनाएं\n    t := time.Date(2025, 3, 15, 14, 30, 0, 0, loc)\n    fmt.Println(t) // 2025-03-15 14:30:00 +0300 MSK\n}\n

ध्यान दें: time.Date अंतिम आर्गुमेंट के रूप में Location लेता है। अगर आप time.UTC या time.Local पास करते हैं, तो व्यवहार अलग होगा।

अगर सिस्टम में ज़ोन न हो तो क्या करें?

कभी-कभी (जैसे, मिनिमल Docker इमेज में) zoneinfo डेटाबेस मौजूद नहीं होता। इसका समाधान — फिक्स्ड ऑफसेट वाला ज़ोन बनाने के लिए time.FixedZone का उपयोग करें:

loc := time.FixedZone("MSK", 3*60*60) // UTC से +3 घंटे\nt := time.Now().In(loc)\nfmt.Println(t)\n

नुकसान: FixedZone डेलाइट सेविंग टाइम और ऐतिहासिक बदलावों के बारे में नहीं जानता। अधिकांश आधुनिक एप्लिकेशन के लिए यह स्वीकार्य है, लेकिन अगर आपको ऐतिहासिक सटीकता चाहिए (जैसे, 2014 के वित्तीय लेन-देन के लिए), तो LoadLocation का उपयोग करें।

सर्वर डेवलपमेंट का सुनहरा नियम: UTC में स्टोर करें

Go (और किसी भी अन्य भाषा) में टाइमज़ोन के साथ काम करने का सुनहरा नियम है — हमेशा समय को UTC में स्टोर करें, और केवल डिस्प्ले लेवल पर कन्वर्ट करें। क्यों?

\n
• सर्वर दूसरे टाइमज़ोन में शिफ्ट हो सकता है।
\n
• यूज़र अलग-अलग ज़ोन से हो सकते हैं।
\n
• UTC समय की तुलना और सॉर्ट करना बहुत आसान है।
\n
• लॉग का विश्लेषण करना आसान होता है।
\n

व्यवहार में यह इस तरह दिखता है:

// यूज़र का समय प्राप्त करें (जैसे, फॉर्म से)\nuserTime := "2025-03-15 14:30"\nuserLoc, _ := time.LoadLocation("Asia/Tokyo")\n\n// यूज़र के लोकल समय के रूप में पार्स करें\nt, _ := time.ParseInLocation("2006-01-02 15:04", userTime, userLoc)\n\n// सेव करने के लिए UTC में कन्वर्ट करें\nutcTime := t.UTC()\nfmt.Println(utcTime) // 2025-03-15 05:30:00 +0000 UTC\n

सामान्य गलती: सीरियलाइज़ेशन के दौरान Location का रीसेट होना

जब आप time.Time को डेटाबेस (जैसे, database/sql के माध्यम से PostgreSQL) में सेव करते हैं, तो ड्राइवर Location को UTC या Local पर "रीसेट" कर सकता है। आश्चर्य से बचने के लिए, हमेशा कन्वर्ट करें