TempusJS - जावास्क्रिप्ट में तारीख के साथ काम करना

सभी को नमस्कार!
मुझे अक्सर आंकड़ों के साथ काम करना पड़ता है और बहुत कुछ तारीखों से बंधा होता है। इसके अलावा, एक ही तारीख को विभिन्न प्रारूपों में पृष्ठ पर उपयोग किया जा सकता है (उदाहरण के लिए, कार के लिए सुविधाजनक और किसी व्यक्ति के लिए सुविधाजनक)। मुझे लगता है कि आप में से अधिकांश इस सभी भयावह कोड से अच्छी तरह वाकिफ हैं जो दिनांक ऑब्जेक्ट का उपयोग करने से आता है।
उदाहरण के लिए, DD.MM.YYYY प्रारूप में वर्तमान तिथि प्राप्त करने के लिए, हमें निम्नलिखित करने की आवश्यकता है:

var d = new Date(), fd = d.getDate() + '.' + (d.getMonth()+1) + '.' + d.getFullYear(); 

और आपको इस तरह की बहुत सारी लाइनें कब मिलती हैं? क्या यह उल्लेख करना आसान है कि जावास्क्रिप्ट में एक महीना खरोंच से शुरू होता है जब आप न केवल उस पर विकसित होते हैं? या तथ्य यह है कि बैकेंड पर लगभग हर जगह की तरह, मिलीसेकंड और सेकंड नहीं हैं? आप लोकप्रिय Moment.js पुस्तकालय के साथ कुछ समस्याओं को हल कर सकते हैं, लेकिन यह बहुत धीरे-धीरे काम करता है।
प्रश्न में पुस्तकालय इन समस्याओं को हल करता है।
यदि दिलचस्पी है, तो मेरा सुझाव है कि आप इस संक्षिप्त समीक्षा को पढ़ें।



TempusJS काफी हद तक एक डेट ऑब्जेक्ट पर वाक्य रचना चीनी से बना है, इसलिए यह बहुत तेजी से काम करता है। पुस्तकालय का वाक्य-विन्यास अपने आप में काफी सरल है। उदाहरण के लिए, पिछले उदाहरण को लिखने के लिए, आप यह कर सकते हैं:

 var fd = tempus().format('%d.%m.%Y'); 

अब गति के बारे में। स्पॉइलर में, आप टेंपस की तुलना मोमेंट के साथ कर सकते हैं और दिनांक को प्रारूपित करने का मूल तरीका देख सकते हैं (ऊपर देखें):


तो, इस पुस्तकालय के फायदों में, आप निम्नलिखित लिख सकते हैं:

• IE6 +, क्रोम, फ़ायरफ़ॉक्स, ओपेरा का समर्थन करता है;
• कॉल चेन का समर्थन करता है;
• महीने शून्य के बजाय 1 (डिफ़ॉल्ट) पर शुरू हो सकते हैं;
• मिलीसेकंड को अक्षम (डिफ़ॉल्ट रूप से) या सक्षम किया जा सकता है;
• तेजी से काम (चूंकि कई मामलों में, ब्राउज़र एक दिनांक ऑब्जेक्ट का उपयोग करता है, जिसके कार्यान्वयन को तेज भाषाओं में लिखा गया है);
• कस्टम स्वरूपों और प्लगइन्स का समर्थन करता है
• तिथि का सत्यापन बहुत तेज है और केवल तारीख निर्धारित करने वाले कार्यों पर निर्भर करता है (चूंकि सत्यापन तब होता है जब मूल्यों को दर्ज किया जाता है, और अलग से गणना नहीं की जाती है);
• तिथियों की एक सरणी है ;
• बहुभाषी और उपयोगकर्ता भाषा का स्वतः पता लगाना।

इस पुस्तकालय के सभी कार्यों को प्रलेखन में वर्णित किया गया है । साइट पर परीक्षण भी हैं (यदि आपको कोई त्रुटि मिलती है, तो कृपया इसे यहां रिपोर्ट करें ।

यहां हम केवल कुछ कार्यों पर ध्यान केंद्रित करेंगे।

स्वरूपण और पार्सिंग

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

 tempus(). //    calc({month: -1}). //      format('%d.%m.%Y'); //     

इस प्रकार, हमें एक ही दिन, घंटा और दूसरा मिलता है, लेकिन एक महीने पहले। यह पिछले महीने की रिपोर्ट प्राप्त करने के लिए उपयोगी है।

अगला उदाहरण डेट पार्सिंग है।

 //   TempusDate  "2013-11-18" tempus('18.11.2013'); //   TempusDate  "2013-12-12" tempus('2013-12-12', '%Y-%m-%d')); 

Tempus स्वचालित रूप से कुछ ज्ञात स्वरूपों का पता लगा सकता है। इसके अलावा, आप एक विशिष्ट प्रारूप निर्दिष्ट कर सकते हैं, फिर पार्सिंग तेजी से होगी। इसके अलावा, आप एक तारीख निर्धारित कर सकते हैं जिसे पार्सिंग विफल होने पर वापस कर दिया जाएगा:

 // .. "123"     '%d.%m.%Y',  //   ,   2013-01-01 tempus('123', '%d.%m.%Y', tempus([2013, 1, 1])); 

डिफ़ॉल्ट स्वरूपों की सूची यहां पाई जा सकती है।

अब पहले से फॉर्मेट की गई तारीख का प्रारूप बदल दें

 // '2013-11-05' tempus('05.11.2013').format('%Y-%m-%d'); //   // 'October, 12' tempus('2013-10-12 12:31:01', '%Y-%m-%d %H:%M:%S').format('%B, %d'); 

स्वरूपण के लिए आप स्थानीयकरण का भी उपयोग कर सकते हैं। डिफ़ॉल्ट रूप से, उपयोगकर्ता भाषा का चयन किया जाएगा (हम इसे ब्राउज़र से लेते हैं) या डिफ़ॉल्ट भाषा अगर उपयोगकर्ता भाषा उपलब्ध टेंपस भाषाओं में नहीं मिली है।

 //   tempus.lang('ru'); //   format // ', 05' tempus(1383609600).format('%B, %d'); 

फिलहाल केवल दो भाषाएं हैं - रूसी और अंग्रेजी, इसलिए मुझे मदद करने में खुशी होगी।

मान्यता

दिनांक का सत्यापन निम्नानुसार है:

 //  false tempus('32.08.2013', '%d.%m.%Y').valid(); //  true tempus('00:00 01.01.2012', '%H:%M %d.%m.%Y').valid(); 

त्रुटि के मामले में, आप उन फ़ील्ड्स को देख सकते हैं जिनमें यह हुआ था - जहाँ भी मान गलत नहीं है:

 //  {"year":-5,"month":false,"day":false,"hours":false, // "minutes":false,"seconds":false,"milliseconds":false} tempus(). year(-5). //  =-5, ..  errors(); //     

तिथि सीमा

कभी-कभी हमें वर्षों की संख्या (उदाहरण के लिए, आयु), महीने, दिन आदि प्राप्त करने की आवश्यकता होती है। दो तिथियों के बीच। ऐसा करने के लिए, हम बीच की विधि का उपयोग कर सकते हैं, जो वांछित प्रारूप ('वर्ष', 'महीना', 'दिन', 'घंटे', 'मिनट', 'सेकंड', 'मिलीसेकंड') में दो तिथियों और रिटर्न के बीच अंतर पाता है।
यहाँ 1 नवंबर, 2013 और 5 मई, 2014 के बीच महीनों की संख्या प्राप्त करने का एक सरल उदाहरण है:

 //  6 tempus([2013, 11, 1]).between(tempus([2014, 5, 5]), 'month'); 

या नए साल तक कितने घंटे बचे हैं

 tempus().between(tempus([2014]), 'hours'); 

पिछले उदाहरण में, आप देख सकते हैं कि मैंने केवल वर्ष का संकेत दिया। किसी सरणी या ऑब्जेक्ट के साथ मान सेट करते समय, अनुपलब्ध मान होंगे
कम से कम भरा हुआ। न्यूनतम मूल्यों के साथ स्थिरांक की एक सूची, आप दस्तावेज़ में देख सकते हैं।

इसके अलावा, हम कैल्क फ़ंक्शन का उपयोग करके एक तारीख बदल सकते हैं:

 //  TempusDate   2012-01-01 tempus([2011, 5, 2]).calc({year: 1, month: -4, day: -1}); 

खुद के प्रारूप

हम महीने के लिए अपने स्वयं के प्रारूप का उपयोग करते हैं, जो 1 से 12 तक मान ले सकते हैं (और 01 से 12 तक नहीं):

 //    tempus.registerFormat('%q', //  - %q function(date) { //    , ..     %q return date.month(); }, function(value) { //     var v = Number(value); return {month: (isNaN(v) ? undefined : v) }; }, 1, //  ,     2, //   'number' //  ); //  //  "01.1.2013"; tempus({year: 2013, month: 1, day: 1}).format('%d.%q.%Y'); //  {"year":2013,"month":2,"day":10,"hours":0,"minutes":0,"seconds":0}; tempus('10.2.2013', '%d.%q.%Y').get(); 

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

 tempus.unregisterFormat('%d'); //  "%d.01.2013", ..  %d   . tempus.format({year: 2013, month: 1, day: 1}, '%d.%m.%Y'); 

गेटर्स / सेटर्स

आप वर्ष (), महीने (), दिन (), घंटे (), सेकंड (), मिलीसेकंड (), dayOfWeek (), utc (), टाइमस्टैम्प () या सेट का उपयोग करके कुछ मान प्राप्त / सेट कर सकते हैं। ()। उदाहरण के लिए:

 tempus(). //    year(1900). //    ,   1900  leapYear(); // ,    ,    false tempus().year(); //         

तारीख पीढ़ी

आप कई तरीकों से तारीख उत्पन्न कर सकते हैं, मापदंडों की पूरी सूची प्रलेखन में है। यहाँ एक न्यूनतम उदाहरण है।

 // returns ["29.03.2013", "30.03.2013", "31.03.2013", "01.04.2013", "02.04.2013"]; tempus.generate({ dateFrom: '20130329', formatFrom: '%Y.%m.%d', dateTo: '20130402', period: {day: 1}, format: '%d.%m.%Y' }); 

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

प्लग-इन

अच्छी तरह से और आखिरी - प्लगइन्स। यहां हम एक यादृच्छिक तारीख उत्पन्न करने के लिए कारखाने का विस्तार करते हैं। इसके अलावा, हमें टेंपसडेट क्लास की जरूरत है, यह tempus.classes () में पाया जा सकता है। यहाँ एक उदाहरण प्लगइन है:

 (function (tempus) { var TempusDate = tempus.classes('TempusDate'); tempus.randomDate = function() { var date = new TempusDate(); date.year(Math.floor((Math.random()*(tempus.MAX_YEAR - tempus.MIN_YEAR)) + tempus.MIN_YEAR)). month(Math.floor((Math.random()*(tempus.MAX_MONTH - tempus.MIN_MONTH)) + tempus.MIN_MONTH)). day(Math.floor((Math.random()*(date.dayCount() - tempus.MIN_DAY)) + tempus.MIN_DAY)). hours(Math.floor((Math.random()*(tempus.MAX_HOURS - tempus.MIN_HOURS)) + tempus.MIN_HOURS)). minutes(Math.floor((Math.random()*(tempus.MAX_MINUTES - tempus.MIN_MINUTES)) + tempus.MIN_MINUTES)). seconds(Math.floor((Math.random()*(tempus.MAX_SECONDS - tempus.MIN_SECONDS)) + tempus.MIN_SECONDS)); return date; }; })(tempus); //        var someRandomDate = tempus.randomDate(); 

मुझे लगता है कि इस तरह से jQuery + Tempus, Angular + Tempus, आदि का एक समूह का उपयोग करके आसानी से विजेट लिखना संभव होगा।

स्रोत कोड

आप इसे जीथूब से स्रोत डाउनलोड करके स्थापित कर सकते हैं:
https://github.com/crusat/tempus-js/releases
या बोवर के माध्यम से:

 $ bower install tempus 

आपको केवल एक फ़ाइल की आवश्यकता है - tempus.js या tempus.min.js।

मुझे उम्मीद है कि यह पुस्तकालय उपयोगी होगा, और यह जानना भी दिलचस्प होगा कि पुस्तकालय को सही दिशा में आगे बढ़ाने के लिए इसमें क्या कमी है। आपका ध्यान के लिए धन्यवाद!
पुनश्च निमंत्रण के लिए धन्यवाद!