Go में time.Time का शून्य मान: कोड तोड़ने वाली 5 सामान्य गलतियाँ

परिचय: वह बग जिसने हर Go डेवलपर को पकड़ा है

क्या आपने कभी लॉग में तारीख 0001-01-01 00:00:00 +0000 UTC देखी है और सोचा है, "यह कहाँ से आया? मैंने तो कुछ इनिशियलाइज़ ही नहीं किया!"? बधाई हो, आप Go में time.Time के शून्य मान (zero value) से मिले हैं। यह एक क्लासिक जाल है जिसने Stack Overflow पर हज़ारों व्यूज़ और दुनिया भर में सैकड़ों घंटे की डिबगिंग करवाई है।

इस लेख में, हम समझेंगे कि time.Time के लिए zero value क्या है, यह अप्रत्याशित व्यवहार क्यों करता है, "खाली" तारीख को असली तारीख से कैसे अलग करें, और सबसे महत्वपूर्ण — प्रोडक्शन में इन गलतियों से कैसे बचें। अगर आप Go में लिखते हैं और तारीखों के साथ काम करते हैं, तो यह सामग्री आपको बहुत सारी परेशानी से बचाएगी।

Go में zero value क्या है और time.Time खास क्यों है

Go में हर प्रकार का एक शून्य मान (zero value) होता है। संख्याओं के लिए यह 0 है, स्ट्रिंग के लिए "", और पॉइंटर्स के लिए nil। तर्क सरल है: यदि आप बिना इनिशियलाइज़ेशन के एक वेरिएबल घोषित करते हैं, तो उसे एक "डमी" मान मिलता है। लेकिन time.Time के साथ यह अधिक जटिल है।

time.Time का शून्य मान Unix timestamp 0 (1970-01-01) नहीं है, जैसा कि आप उम्मीद कर सकते हैं। यह 0001-01-01 00:00:00 +0000 UTC है। क्यों? क्योंकि आंतरिक रूप से time.Time 1 जनवरी, वर्ष 1 (ग्रेगोरियन कैलेंडर के अनुसार) से नैनोसेकंड स्टोर करता है। इस प्रतिनिधित्व में शून्य वर्ष 1 देता है।

package main\n\nimport (\n    "fmt"\n    "time"\n)\n\nfunc main() {\n    var t time.Time\n    fmt.Println(t) // 0001-01-01 00:00:00 +0000 UTC\n    fmt.Println(t.Unix()) // -62135596800 (नकारात्मक संख्या!)\n}\n

समस्या दिख रही है? अगर आप if t == 0 से जाँच करने या Unix शून्य से तुलना करने की कोशिश करते हैं, तो आपका कोड टूट जाएगा। आइए time.Time के zero value से जुड़ी शीर्ष गलतियों और उनसे बचने के तरीकों को समझते हैं।

time.Time के शून्य मान से जुड़ी 5 सबसे बड़ी गलतियाँ

1. Unix timestamp 0 से तुलना करना

सबसे आम गलती यह जाँचने की कोशिश करना है कि समय "खाली" है, इसे time.Unix(0, 0) से तुलना करके। यह काम नहीं करेगा, क्योंकि शून्य मान 1970 का साल नहीं है।

// ❌ गलती: यह कभी true नहीं होगा\nvar t time.Time\nif t == time.Unix(0, 0) {\n    fmt.Println("समय खाली है")\n}\n\n// ✅ सही: IsZero() मेथड का उपयोग करें\nif t.IsZero() {\n    fmt.Println("समय खाली है")\n}\n

IsZero() मेथड आपका मुख्य हथियार है। यह केवल शून्य मान के लिए true लौटाता है, किसी भी "पुरानी" तारीख के लिए नहीं।

2. JSON में सीरियलाइज़ेशन: अप्रत्याशित null

जब आप time.Time वाली स्ट्रक्चर को JSON में सीरियलाइज़ करते हैं, तो शून्य मान स्ट्रिंग "0001-01-01T00:00:00Z" में बदल जाता है। यह API, फ्रंटएंड और डेटाबेस को तोड़ देता है। क्लाइंट null के बजाय एक अजीब तारीख देखते हैं।

type Event struct {\n    Name      string    `json:"name"`\n    StartTime time.Time `json:"start_time"`\n}\n\nfunc main() {\n    e := Event{Name: "test"}\n    data, _ := json.Marshal(e)\n    fmt.Println(string(data))\n    // {"name":"test","start_time":"0001-01-01T00:00:00Z"}\n    // ❌ यह null होना चाहिए या फ़ील्ड गायब होनी चाहिए\n}\n

समाधान: time.Time पर पॉइंटर (*time.Time) या कस्टम सीरियलाइज़ेशन लॉजिक वाला कस्टम टाइप उपयोग करें।

// ✅ पॉइंटर वाला विकल्प\ntype Event struct {\n    Name      string     `json:"name"`\n    StartTime *time.Time `json:"start_time,omitempty"`\n}\n\n// ✅ या omitempty के साथ कस्टम टाइप\ntype CustomTime struct {\n    time.Time\n}\n\nfunc (ct CustomTime) MarshalJSON() ([]byte, error) {\n    if ct.IsZero() {\n        return []byte("null"), nil\n    }\n    return json.Marshal(ct.Time)\n}\n

3. डेटाबेस (SQL) से जुड़ी समस्याएँ

PostgreSQL या MySQL में शून्य time.Time डालने पर आपको तारीख 0001-01-01 मिलेगी, जो रेंज सीमा त्रुटि (साल 1 अनुमत सीमा से बाहर) का कारण बनेगी।