जावास्क्रिप्ट टेम्पोरल इंस्टेंट: उच्च-सटीकता समय गणना

जावास्क्रिप्ट लंबे समय से अपनी कम-आदर्श दिनांक और समय संभालने की क्षमताओं के लिए जाना जाता है। विरासत में मिला Date ऑब्जेक्ट, हालांकि व्यापक रूप से उपयोग किया जाता है, म्यूटेबिलिटी, असंगत एपीआई व्यवहार, और टाइम ज़ोन के लिए खराब समर्थन से ग्रस्त है। पेश है Temporal API, जो दिनांक और समय में हेरफेर करने का एक आधुनिक तरीका है, जिसे इन कमियों को दूर करने के लिए डिज़ाइन किया गया है। टेम्पोरल के केंद्र में Instant ऑब्जेक्ट है, जो नैनोसेकंड सटीकता के साथ समय में एक विशिष्ट बिंदु का प्रतिनिधित्व करता है। यह ब्लॉग पोस्ट आपके जावास्क्रिप्ट अनुप्रयोगों में उच्च-सटीकता समय गणना के लिए Temporal.Instant का उपयोग करने के लिए एक व्यापक गाइड प्रदान करता है, जो विविध आवश्यकताओं वाले वैश्विक दर्शकों के लिए है।

Temporal.Instant क्या है?

Temporal.Instant यूनिक्स युग (1 जनवरी, 1970, 00:00:00 समन्वित सार्वभौमिक समय (UTC)) से मापे गए समय में एक बिंदु को नैनोसेकंड सटीकता के साथ दर्शाता है। विरासत में मिले Date ऑब्जेक्ट के विपरीत, Temporal.Instant अपरिवर्तनीय (immutable) है, जिसका अर्थ है कि बनाने के बाद इसका मान नहीं बदला जा सकता है। यह अपरिवर्तनीयता अप्रत्याशित दुष्प्रभावों को रोकने और डेटा अखंडता सुनिश्चित करने के लिए महत्वपूर्ण है, खासकर जटिल अनुप्रयोगों में।

Temporal.Instant ऑब्जेक्ट बनाना

Temporal.Instant ऑब्जेक्ट बनाने के कई तरीके हैं:

1. एक संख्या से (युग के बाद से मिलीसेकंड)

आप यूनिक्स युग के बाद से बीते मिलीसेकंड की संख्या से एक Instant बना सकते हैं। यह वैसा ही है जैसा कि विरासत Date ऑब्जेक्ट काम करता है, लेकिन Temporal.Instant अधिक सटीकता प्रदान करता है।

            
const instant = Temporal.Instant.fromEpochMilliseconds(1678886400000); // March 15, 2023, 00:00:00 UTC
console.log(instant.toString()); // Output: 2023-03-15T00:00:00Z

            

              
                Copy
              
            
          

2. एक संख्या से (युग के बाद से नैनोसेकंड)

और भी अधिक सटीकता के लिए, आप यूनिक्स युग के बाद से बीते नैनोसेकंड की संख्या से एक Instant बना सकते हैं। यह Temporal.Instant के साथ समय में एक बिंदु का प्रतिनिधित्व करने का सबसे सटीक तरीका है।

            
const instant = Temporal.Instant.fromEpochNanoseconds(1678886400000000000n); // March 15, 2023, 00:00:00 UTC
console.log(instant.toString()); // Output: 2023-03-15T00:00:00Z

            

              
                Copy
              
            
          

BigInt लिटरल को इंगित करने के लिए n प्रत्यय के उपयोग पर ध्यान दें। नैनोसेकंड मान अक्सर जावास्क्रिप्ट संख्याओं के लिए अधिकतम सुरक्षित पूर्णांक मान से अधिक हो जाते हैं, इसलिए सटीकता बनाए रखने के लिए BigInt का उपयोग करना आवश्यक है।

3. एक ISO 8601 स्ट्रिंग से

Temporal.Instant को UTC दिनांक और समय का प्रतिनिधित्व करने वाले ISO 8601 स्ट्रिंग से भी बनाया जा सकता है।

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00Z');
console.log(instant.toString()); // Output: 2023-03-15T00:00:00Z

const instantWithFractionalSeconds = Temporal.Instant.from('2023-03-15T00:00:00.123456789Z');
console.log(instantWithFractionalSeconds.toString()); // Output: 2023-03-15T00:00:00.123456789Z

            

              
                Copy
              
            
          

UTC को इंगित करने के लिए ISO 8601 स्ट्रिंग Z के साथ समाप्त होनी चाहिए। स्ट्रिंग में वैकल्पिक रूप से नौ अंकों तक की सटीकता के साथ भिन्नात्मक सेकंड शामिल हो सकते हैं।

4. Temporal.Now से (सिस्टम घड़ी)

आप Temporal.Now.instant() का उपयोग करके समय का वर्तमान क्षण प्राप्त कर सकते हैं:

            
const now = Temporal.Now.instant();
console.log(now.toString()); // Output: Varies depending on the current time

            

              
                Copy
              
            
          

Temporal.Instant ऑब्जेक्ट्स के साथ काम करना

एक बार जब आपके पास Temporal.Instant ऑब्जेक्ट हो, तो आप उस पर विभिन्न ऑपरेशन कर सकते हैं। याद रखें कि Temporal.Instant ऑब्जेक्ट अपरिवर्तनीय हैं, इसलिए ये ऑपरेशन मूल को संशोधित करने के बजाय नए Temporal.Instant ऑब्जेक्ट लौटाते हैं।

1. समय जोड़ना और घटाना

आप add() और subtract() विधियों का उपयोग करके Instant से समय जोड़ या घटा सकते हैं। ये विधियां एक Temporal.Duration ऑब्जेक्ट स्वीकार करती हैं, जो समय की अवधि का प्रतिनिधित्व करता है।

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00Z');
const duration = Temporal.Duration.from({ hours: 2, minutes: 30 });

const futureInstant = instant.add(duration);
console.log(futureInstant.toString()); // Output: 2023-03-15T02:30:00Z

const pastInstant = instant.subtract(duration);
console.log(pastInstant.toString()); // Output: 2023-03-14T21:30:00Z

            

              
                Copy
              
            
          

आप अवधि के लिए एक स्ट्रिंग प्रतिनिधित्व का भी उपयोग कर सकते हैं:

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00Z');
const futureInstant = instant.add('PT2H30M'); // ISO 8601 duration string
console.log(futureInstant.toString()); // Output: 2023-03-15T02:30:00Z

            

              
                Copy
              
            
          

2. इंस्टेंट्स की तुलना करना

आप compare() विधि का उपयोग करके दो Temporal.Instant ऑब्जेक्ट्स की तुलना कर सकते हैं। यह विधि लौटाती है:

• -1 यदि पहला इंस्टेंट दूसरे से पहले का है।
• 0 यदि दोनों इंस्टेंट बराबर हैं।
• 1 यदि पहला इंस्टेंट दूसरे के बाद का है।

            
const instant1 = Temporal.Instant.from('2023-03-15T00:00:00Z');
const instant2 = Temporal.Instant.from('2023-03-15T01:00:00Z');

console.log(Temporal.Instant.compare(instant1, instant2)); // Output: -1
console.log(Temporal.Instant.compare(instant2, instant1)); // Output: 1
console.log(Temporal.Instant.compare(instant1, instant1)); // Output: 0

            

              
                Copy
              
            
          

3. अन्य टेम्पोरल प्रकारों में परिवर्तित करना

Temporal.Instant को अन्य टेम्पोरल प्रकारों में परिवर्तित किया जा सकता है, जैसे कि Temporal.ZonedDateTime, Temporal.PlainDateTime, और Temporal.PlainDate। यह टाइम ज़ोन और स्थानीयकृत दिनांक और समय अभ्यावेदन के साथ काम करने के लिए आवश्यक है।

a. Temporal.ZonedDateTime में

Temporal.ZonedDateTime एक विशिष्ट टाइम ज़ोन के साथ दिनांक और समय का प्रतिनिधित्व करता है। एक Instant को ZonedDateTime में बदलने के लिए, आपको टाइम ज़ोन निर्दिष्ट करने की आवश्यकता है।

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00Z');
const zonedDateTime = instant.toZonedDateTimeISO('America/Los_Angeles');
console.log(zonedDateTime.toString()); // Output: 2023-03-14T17:00:00-07:00[America/Los_Angeles]

            

              
                Copy
              
            
          

toZonedDateTimeISO() विधि ISO 8601 कैलेंडर का उपयोग करके एक ZonedDateTime बनाती है। आप एक अलग कैलेंडर निर्दिष्ट करने के लिए toZonedDateTime() का भी उपयोग कर सकते हैं।

b. Temporal.PlainDateTime में

Temporal.PlainDateTime बिना टाइम ज़ोन के दिनांक और समय का प्रतिनिधित्व करता है। एक Instant को PlainDateTime में बदलने के लिए, आपको पहले इसे ZonedDateTime में बदलना होगा और फिर उससे PlainDateTime प्राप्त करना होगा।

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00Z');
const zonedDateTime = instant.toZonedDateTimeISO('America/Los_Angeles');
const plainDateTime = zonedDateTime.toPlainDateTime();
console.log(plainDateTime.toString()); // Output: 2023-03-14T17:00:00

            

              
                Copy
              
            
          

c. Temporal.PlainDate में

Temporal.PlainDate समय या टाइम ज़ोन के बिना एक तारीख का प्रतिनिधित्व करता है। PlainDateTime के समान, आप पहले ZonedDateTime में परिवर्तित करते हैं।

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00Z');
const zonedDateTime = instant.toZonedDateTimeISO('America/Los_Angeles');
const plainDate = zonedDateTime.toPlainDate();
console.log(plainDate.toString()); // Output: 2023-03-14

            

              
                Copy
              
            
          

4. युग के बाद से मिलीसेकंड और नैनोसेकंड प्राप्त करना

आप क्रमशः epochMilliseconds और epochNanoseconds गुणों का उपयोग करके यूनिक्स युग के बाद से बीते मिलीसेकंड या नैनोसेकंड की संख्या प्राप्त कर सकते हैं।

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00.123456789Z');
console.log(instant.epochMilliseconds); // Output: 1678886400123
console.log(instant.epochNanoseconds); // Output: 1678886400123456789n

            

              
                Copy
              
            
          

Temporal.Instant के उपयोग के मामले

Temporal.Instant उन परिदृश्यों में विशेष रूप से उपयोगी है जहां उच्च-सटीकता समय गणना की आवश्यकता होती है। यहाँ कुछ उदाहरण दिए गए हैं:

1. इवेंट लॉगिंग और ऑडिटिंग

इवेंट्स को लॉग करते समय या सिस्टम गतिविधि का ऑडिट करते समय, किसी घटना के घटित होने का सटीक समय दर्ज करना महत्वपूर्ण है। Temporal.Instant टाइमस्टैम्प को सटीक रूप से रिकॉर्ड करने के लिए आवश्यक सटीकता प्रदान करता है।

            
function logEvent(eventDescription) {
  const timestamp = Temporal.Now.instant().toString();
  console.log(`[${timestamp}] ${eventDescription}`);
}

logEvent('User logged in');
logEvent('File saved');

            

              
                Copy
              
            
          

2. प्रदर्शन मापन

कोड के प्रदर्शन को मापने के लिए सटीक समय की आवश्यकता होती है। Temporal.Instant का उपयोग नैनोसेकंड सटीकता के साथ कोड ब्लॉक के निष्पादन समय को मापने के लिए किया जा सकता है।

            
const start = Temporal.Now.instant();
// Code to measure
for (let i = 0; i < 1000000; i++) {
  // Some operation
}
const end = Temporal.Now.instant();

const duration = end.since(start);
console.log(`Execution time: ${duration.total('milliseconds')} milliseconds`);

            

              
                Copy
              
            
          

3. डिस्ट्रिब्यूटेड सिस्टम्स और डेटा सिंक्रनाइज़ेशन

डिस्ट्रिब्यूटेड सिस्टम्स में, कई नोड्स में डेटा स्थिरता बनाए रखने के लिए अक्सर सटीक समय सिंक्रनाइज़ेशन की आवश्यकता होती है। Temporal.Instant का उपयोग डेटा अपडेट के लिए टाइमस्टैम्प का प्रतिनिधित्व करने और समय के आधार पर टकरावों को हल करने के लिए किया जा सकता है।

उदाहरण के लिए, एक ऐसे परिदृश्य पर विचार करें जहां डेटा विभिन्न भौगोलिक स्थानों (जैसे, एक सामग्री वितरण नेटवर्क या एक वितरित डेटाबेस) में कई सर्वरों पर दोहराया जाता है। यदि कोई उपयोगकर्ता किसी रिकॉर्ड को अपडेट करता है, तो सिस्टम को यह सुनिश्चित करने की आवश्यकता होती है कि नवीनतम अपडेट सभी सर्वरों पर लगातार प्रचारित हो। प्रत्येक अपडेट को टाइमस्टैम्प करने के लिए Temporal.Instant का उपयोग करने से नेटवर्क विलंबता और सर्वरों के बीच संभावित घड़ी तिरछा होने पर भी सटीक ऑर्डरिंग सुनिश्चित होती है।

4. वित्तीय लेनदेन

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

उदाहरण के लिए, उच्च-आवृत्ति ट्रेडिंग सिस्टम उस सटीक क्षण को पकड़ने के लिए माइक्रोसेकंड या नैनोसेकंड सटीकता की मांग करते हैं जब कोई ऑर्डर निष्पादित होता है। समय में छोटी-छोटी विसंगतियों से भी महत्वपूर्ण वित्तीय परिणाम हो सकते हैं। Temporal.Instant इन महत्वपूर्ण अनुप्रयोगों के लिए आवश्यक रिज़ॉल्यूशन प्रदान करता है।

5. वैज्ञानिक अनुप्रयोग

कई वैज्ञानिक अनुप्रयोगों, जैसे खगोल विज्ञान, भौतिकी सिमुलेशन, और प्रयोगों से डेटा लॉगिंग, के लिए बहुत सटीक समय माप की आवश्यकता होती है। ये माप अक्सर डेटा का विश्लेषण करने और सटीक निष्कर्ष निकालने के लिए महत्वपूर्ण होते हैं।

एक दूरबीन की कल्पना करें जो एक दूर के तारे से डेटा कैप्चर कर रही है। तारे की स्थिति, गति और अन्य गुणों को निर्धारित करने के लिए प्रत्येक अवलोकन का सटीक समय आवश्यक है। Temporal.Instant वैज्ञानिकों को इन टाइमस्टैम्प को आवश्यक सटीकता के साथ रिकॉर्ड करने की अनुमति देता है।

अंतर्राष्ट्रीयकरण और टाइम ज़ोन

हालांकि Temporal.Instant UTC में समय में एक बिंदु का प्रतिनिधित्व करता है, वैश्विक दर्शकों के लिए दिनांक और समय के साथ काम करते समय टाइम ज़ोन पर विचार करना महत्वपूर्ण है। जैसा कि पहले दिखाया गया है, आप एक विशिष्ट टाइम ज़ोन में समय के एक ही बिंदु का प्रतिनिधित्व करने के लिए एक Instant को Temporal.ZonedDateTime में बदल सकते हैं।

उपयोगकर्ताओं को दिनांक और समय प्रदर्शित करते समय, भ्रम से बचने के लिए हमेशा उनके स्थानीय टाइम ज़ोन का उपयोग करें। आप उपयोगकर्ता का टाइम ज़ोन उनके ब्राउज़र या ऑपरेटिंग सिस्टम से प्राप्त कर सकते हैं। उदाहरण के लिए, आप उपयोगकर्ता के लोकेल और टाइम ज़ोन के अनुसार दिनांक और समय को प्रारूपित करने के लिए Intl.DateTimeFormat API का उपयोग कर सकते हैं।

            
const instant = Temporal.Instant.from('2023-03-15T00:00:00Z');
const zonedDateTime = instant.toZonedDateTimeISO(Temporal.Now.timeZone());

const formatter = new Intl.DateTimeFormat(undefined, {
  year: 'numeric',
  month: 'long',
  day: 'numeric',
  hour: 'numeric',
  minute: 'numeric',
  timeZoneName: 'short',
});

console.log(formatter.format(zonedDateTime)); // Output: Varies depending on the user's locale and time zone

            

              
                Copy
              
            
          

यह उदाहरण उपयोगकर्ता के सिस्टम टाइम ज़ोन का उपयोग करता है। यदि आवश्यक हो तो आप Temporal.Now.timeZone() को एक विशिष्ट टाइम ज़ोन पहचानकर्ता (जैसे, 'America/Los_Angeles') से बदल सकते हैं।

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

ब्राउज़र और एनवायरनमेंट सपोर्ट

2023 के अंत तक, टेम्पोरल एपीआई अभी भी अपेक्षाकृत नया है और सभी ब्राउज़रों और जावास्क्रिप्ट एनवायरनमेंट में पूरी तरह से समर्थित नहीं है। पुराने ब्राउज़रों के लिए समर्थन प्रदान करने के लिए आपको पॉलीफ़िल का उपयोग करने की आवश्यकता हो सकती है।

@js-temporal/polyfill पैकेज टेम्पोरल एपीआई के लिए एक पॉलीफ़िल प्रदान करता है। आप इसे npm या yarn का उपयोग करके इंस्टॉल कर सकते हैं:

            
npm install @js-temporal/polyfill

            

              
                Copy
              
            
          

फिर, अपने जावास्क्रिप्ट कोड में पॉलीफ़िल आयात करें:

            
import '@js-temporal/polyfill';

            

              
                Copy
              
            
          

यह टेम्पोरल एपीआई को वैश्विक स्कोप में जोड़ देगा, जिससे आप इसे अपने कोड में उपयोग कर सकेंगे, भले ही एनवायरनमेंट मूल रूप से इसका समर्थन न करता हो।

सर्वोत्तम अभ्यास और विचार

• आंतरिक भंडारण और गणना के लिए UTC का उपयोग करें: टाइम ज़ोन-संबंधी समस्याओं से बचने के लिए सभी टाइमस्टैम्प को UTC में संग्रहीत करें। केवल उपयोगकर्ताओं को दिनांक और समय प्रदर्शित करते समय स्थानीय टाइम ज़ोन में परिवर्तित करें।
• टाइम ज़ोन रूपांतरणों को सावधानी से संभालें: DST और टाइम ज़ोन नियम परिवर्तनों से अवगत रहें। सटीक रूपांतरण सुनिश्चित करने के लिए एक अप-टू-डेट टाइम ज़ोन डेटाबेस का उपयोग करें।
• नैनोसेकंड मानों के लिए BigInt का उपयोग करें: नैनोसेकंड मान अक्सर जावास्क्रिप्ट संख्याओं के लिए अधिकतम सुरक्षित पूर्णांक मान से अधिक हो जाते हैं। सटीकता बनाए रखने के लिए BigInt का उपयोग करें।
• पॉलीफ़िल का उपयोग करने पर विचार करें: यदि आपको पुराने ब्राउज़रों या एनवायरनमेंट का समर्थन करने की आवश्यकता है, तो @js-temporal/polyfill पैकेज का उपयोग करें।
• अपने कोड का अच्छी तरह से परीक्षण करें: यह सुनिश्चित करने के लिए कि यह सभी उपयोगकर्ताओं के लिए सही ढंग से काम करता है, अपने कोड का विभिन्न टाइम ज़ोन और लोकेल के साथ परीक्षण करें।
• अपनी मान्यताओं का दस्तावेजीकरण करें: टाइम ज़ोन, लोकेल, या दिनांक और समय प्रारूपों के बारे में आपके द्वारा की गई किसी भी मान्यता का स्पष्ट रूप से दस्तावेजीकरण करें।

निष्कर्ष

Temporal.Instant जावास्क्रिप्ट में समय के बिंदुओं का प्रतिनिधित्व करने का एक मजबूत और सटीक तरीका प्रदान करता है। इसकी अपरिवर्तनीयता, नैनोसेकंड सटीकता, और अन्य टेम्पोरल प्रकारों के साथ एकीकरण इसे विभिन्न प्रकार के अनुप्रयोगों में जटिल समय गणनाओं को संभालने के लिए एक शक्तिशाली उपकरण बनाता है। Instant ऑब्जेक्ट बनाने, हेरफेर करने और तुलना करने के तरीके को समझकर, और अंतर्राष्ट्रीयकरण और टाइम ज़ोन हैंडलिंग के लिए सर्वोत्तम प्रथाओं का पालन करके, आप एक वैश्विक दर्शकों के लिए विश्वसनीय और सटीक दिनांक और समय कार्यक्षमता का निर्माण कर सकते हैं। Instant ऑब्जेक्ट सहित टेम्पोरल एपीआई को अपनाने से, डेवलपर्स को विरासत Date ऑब्जेक्ट की सीमाओं से आगे बढ़ने और अधिक मजबूत और रखरखाव योग्य एप्लिकेशन बनाने की अनुमति मिलती है जो विभिन्न संस्कृतियों और क्षेत्रों में समय की जटिलताओं को सटीक रूप से दर्शाते हैं।

जैसे-जैसे टेम्पोरल एपीआई को व्यापक रूप से अपनाया जाएगा, यह जावास्क्रिप्ट में दिनांक और समय में हेरफेर के लिए मानक बनने के लिए तैयार है। जो डेवलपर्स इसकी विशेषताओं और सर्वोत्तम प्रथाओं से खुद को परिचित करते हैं, वे समय-जागरूक अनुप्रयोगों की अगली पीढ़ी बनाने के लिए अच्छी तरह से सुसज्जित होंगे।