Luxon - مكتبة جديدة للعمل مع تواريخ من فريق Moment.js

يبدو ، لماذا نحتاج إلى مكتبة أخرى للعمل مع التواريخ والأوقات التي توجد بها مكتبة لحظات معروفة ؟! الأكثر إثارة للاهتمام هو أن البديل اقترحه فريق Moment نفسه.

تم إعلان مكتبة Luxon كأداة قوية وحديثة ومريحة للعمل مع التواريخ والأوقات في JavaScript. تم إنشاء المكتبة من قبل إسحاق كامبرون ، عضو فريق تطوير Moment منذ عام 2013.

كان لدى المؤلف العديد من الأفكار لتطوير Moment ، والتي لم يستطع صنعها في إطار الكود الموجود. فيما يلي النقاط الرئيسية التي أردت تنفيذها:

• جرب بعض الأفكار حول كيفية جعل واجهة برمجة التطبيقات أكثر منطقية (ولكن هذه الأفكار لم تكن متوافقة مع المنهج الذي تبناه مومنت) ،
• تنفيذ العمل "خارج الصندوق" مع المناطق الزمنية دون ملحقات إضافية ،
• إعادة التفكير بشكل كامل في العمل مع التدويل ، مع مراعاة ظهور API Intl ،
• التبديل إلى مجموعة حديثة من الأدوات والمناهج في تشكيل كود JS.

لذلك ، قرر أن يكتب كل شيء من الصفر ، والذي استغرق حوالي عامين.
والنتيجة هي نوع من نسخة حديثة من Moment.
بدا أن الإصدار الناتج مثير للاهتمام لفريق تطوير Moment بأكمله ، لذلك تقرر الترويج للمكتبة الجديدة تحت رعاية الفريق.

مبادئ Luxon

1. سلاسل المكالمات كما في لحظة.
2. جميع الأنواع غير قابلة للتغيير.
3. واجهة برمجة التطبيقات (API) أكثر وضوحًا: للكائنات المختلفة - طرق مختلفة مع معلمات محددة بوضوح.
4. API Intl للتدويل (العودة إلى إصدار اللغة الإنجليزية إذا كان المتصفح لا يدعم API Intl).
5. API Intl للعمل مع المناطق الزمنية.
6. المزيد من الدعم الكامل لحساب المدة.
7. دعم الفاصل الأصلي.
8. وثائق رمز مضمنة.

أدت هذه المبادئ إلى التحسينات التالية:

• كود Luxon هو أسهل بكثير لفهم وتصحيح.
• يؤدي استخدام إمكانات المستعرض المضمّنة للتدويل إلى تحسين سلوك المكتبة ، ومرة ​​أخرى ، يجعل تصحيح الأخطاء أسهل.
• يتم تنفيذ دعم المنطقة الزمنية بشكل أفضل من أي مكتبة JS أخرى.
• يوفر Luxon أداة بسيطة وقوية للغاية للعمل مع المدة.
• المكتبة لديها وثائق جيدة.

لكن Luxon لها عيوبها:

• يؤدي التركيز على استخدام القدرات المدمجة للمتصفح إلى صعوبات في دعم المتصفحات القديمة.
• بعض ميزات التدويل التي لم تدعمها المتصفحات حتى الآن لا يتم تنفيذها في المكتبة أيضًا (يجب أن تتوقع ظهور هذا الدعم في المتصفحات).
• قد يختلف تطبيق API Intl في متصفحات مختلفة ، على التوالي ، يختلف سلوك Luxon أيضًا.

التثبيت

يوفر Luxon وحدات لجميع منصات JavaScript الحديثة.

تحتوي الوثائق على قائمة كاملة بالمتصفحات المدعومة مع قيود التطبيق. بالنسبة للمتصفحات التي لا تحتوي على دعم دولي محدود أو لديها دعم محدود ، يوصى باستخدام polyfile (على وجه الخصوص ، ينطبق هذا على IE 10 أو 11).

عند العمل مع Node.js (6+) ، إذا كنت بحاجة إلى العمل مع لغات ، فستحتاج أيضًا إلى تثبيت حزمة icu الكاملة وتعيين متغير البيئة لتمكين استخدام هذه الحزمة.

طريقة التثبيت القياسية من npm:
npm تثبيت - حفظ luxon

يحتوي Luxon على دعم لكل من TypeScript و Flow ، وهناك أيضًا وحدة نمطية بتنسيق ES6.

مراجعة سريعة

تتكون مكتبة Luxon من خمس فئات رئيسية:

DateTime - التاريخ والوقت مع إعدادات المنطقة الزمنية وعرض ، وكذلك الأساليب ذات الصلة.
المدة - فترة زمنية (المدة) ، على سبيل المثال ، "شهرين" أو "يوم واحد ، 3 ساعات".
معلومات - طرق ثابتة للحصول على بيانات عامة في الوقت والتاريخ.
الفاصل الزمني - الفاصل الزمني وطرق العمل معها.
الإعدادات هي طرق ثابتة تحدد السلوك العام لـ Luxon.

import {DateTime, Duration, Info, Interval, Settings} from 'luxon'; 

تاريخك الأول

أهم فئة في Luxon هي DateTime. يمثل DateTime التاريخ + الوقت جنبًا إلى جنب مع المنطقة الزمنية والإعدادات المحلية. هذه هي الطريقة التي يمكنك تعيين 15 مايو 2017 08:30 في المنطقة الزمنية المحلية:

 var dt = DateTime.local(2017, 5, 15, 8, 30); 

هذه هي الدعوة لتحديد الوقت الحالي:

 var now = DateTime.local(); 

إنشاء من كائن

 DateTime.fromObject({ month:12, day: 22, hour: 12, minutes: 20, zone: 'Europe/Kaliningrad' }); //=> 2018-12-22T12:20:00.000+02:00 

إنشاء من السلسلة بتنسيق ISO 8601

 DateTime.fromISO("2017-05-15"); //=> May 15, 2017 at 0:00 DateTime.fromISO("2017-05-15T08:30:00"); //=> May 15, 2017 at 8:30 

عند التحويل إلى سلسلة ، تقوم Luxon أيضًا بإرجاع سلسلة بتنسيق ISO 8601:

 DateTime.local().toString(); //=> "2018-12-18T20:58:29.995+03:00" 

الحصول على المكونات الفردية:

 var dt = DateTime.local(); dt.year; //=> 2018 dt.month; //=> 12 dt.day; //=> 18 dt.second; //=> 27 dt.weekday; //=> 2 dt.zoneName; //=> "Europe/Moscow" dt.offset; //=> 180 dt.daysInMonth; //=> 31 

الإخراج المنسق

يحتوي Luxon على العديد من الطرق لتحويل DateTime إلى سلسلة ، اثنتان منها أهمهما toLocaleString و toISO ، الأول يحول إلى تنسيق يأخذ في الاعتبار ورنيش المستعرض ، والثاني يعد النص للمعالجة البرنامجية (على سبيل المثال ، للنقل إلى خادم):

 dt.toLocaleString(); //=> "18.12.2018" dt.toLocaleString(DateTime.DATETIME_MED); //=> "18 . 2018 ., 21:46" dt.toISO(); //=> "2018-12-18T21:46:55.013+03:00" 

يحتوي Luxon على 24 "إعدادات مسبقة" جاهزة للإخراج المنسق (مثل DATETIME_MED و TIME_WITH_LONG_OFFSET).

يمكنك أيضًا إنشاء خيار التنسيق الخاص بك استنادًا إلى الرموز المميزة:

 dt.setLocale('ru').toFormat('d MMMM tt - ZZZZZ'); //=> "18  21:46:55 - ,  " 

تحويلات التاريخ والوقت

ملاحظة مهمة: كائنات Luxon غير قابلة للتغيير ، أي أي طرق تعديل مطبقة عليها ستُرجع النسخة المعدلة دون تغيير الكائن الأصلي. لذلك ، يجب فهم جميع المصطلحات الواردة في هذه المقالة (كما هو الحال في وثائق Luxon) مثل "التغيير" ، "التثبيت" ، "إعادة التعريف" على أنها "إنشاء مثيل جديد مع خصائص أخرى".

التحولات الرياضية

 var dt = DateTime.local(2018, 12, 18, 20, 30); //=> "18.12.2018, 20:30" dt.plus({hours: 3, minutes: 2}); //=> "18.12.2018, 23:32" dt.minus({days: 7}); //=> "11.12.2018, 20:30" dt.startOf('day'); //=> "18.12.2018, 0:00" dt.endOf('hour'); //=> "18.12.2018, 20:00" 

تجاوز المعلمات الفردية

 var dt = DateTime.local(); dt.set({hour: 3}).hour //=> 3 

التحويلات الدولية

يدعم Luxon العديد من تحويلات Intl المختلفة ، أحد أهمها التنسيق لمختلف اللغات:

 var dt = DateTime.local(); var f = {month: 'long', day: 'numeric'}; dt.setLocale('fr').toLocaleString(f); //=> "18 décembre" dt.setLocale('en-GB').toLocaleString(f); //=> "18 December" dt.setLocale('en-US').toLocaleString(f); //=> "December 18" 

يمكن لفئة المعلومات إرجاع قوائم بالأشهر وأيام الأسبوع في لغة معينة:

 Info.months('long', {locale: 'it'}); //=> ["gennaio", "febbraio", "marzo", ...] Info.weekdays ('short', {locale: 'de'}); //=> ["Mo", "Di", "Mi", ...] 

المناطق الزمنية

Luxon يدعم المناطق الزمنية. إذا قمت بإنشاء DateTime دون تحديد منطقة زمنية بشكل صريح ، فسيتم تحديد المنطقة المحلية افتراضيًا. إذا قمت بتغيير المنطقة الخاصة بـ DateTime ، فسيتم إعادة حساب الوقت والتاريخ مع مراعاة الفرق بين المناطق الزمنية.

 var dt = DateTime.local(2018, 12, 18, 20, 00); //=> 2018-12-18T20:00:00.000+03:00 dt.zone.name; //=> "Europe/Moscow" dt.setZone('Asia/Vladivostok'); //=> 2018-12-19T03:00:00.000+10:00 

يدعم Luxon أيضًا العمل مع التاريخ والوقت بتنسيق UTC:

 DateTime.utc(2018, 5, 15); //=> 2018-05-15T00:00:00.000Z DateTime.utc(); //=> 2018-12-18T17:58:29.995Z DateTime.local().toUTC(); //=> 2018-12-18T17:58:29.995Z DateTime.utc().toLocal(); //=> 2018-12-18T20:58:29.995+03:00 

المدة

توفر فئة المدة القدرة على العمل لمدة ، على سبيل المثال ، "ساعتان و 7 دقائق". يمكنك إنشاء مدة مثل هذا:

 var dur = Duration.fromObject({hours: 2, minutes: 7}); 

يمكن إضافة فترات زمنية وطرحها. المدة قد يكون لها قيمة سالبة.

 dur.minus(dur).minus(dur); //=> {hours: -2, minutes: -7} 

وبالمثل ، يمكن إضافة المدة أو طرحها من DateTime.

 DateTime.local().plus(dur); 

المدة لها حروف (على غرار تاريخ DateTime):

 dur.hours; //=> 2 dur.minutes; //=> 7 dur.seconds; //=> 0 dur.zone; //=> undefined 

المدة لها أيضًا طرق مفيدة أخرى:

 dur.as('seconds'); //=> 7620 dur.toObject(); //=> { hours: 2, minutes: 7 } dur.toISO(); //=> 'PT2H7M' 

فترات

يتم تعريف الفواصل الزمنية بأنها الفترة الفاصلة بين نقطتين زمنيتين ؛ يتم استخدام فئة الفاصل الزمني للعمل معهم. يتم تضمين وقت البدء في الفاصل الزمني ، لكن وقت الانتهاء ليس كذلك: وفقًا لذلك ، يتم وضع علامة البداية عند التحويل إلى سلسلة مع قوس مربع ، وتكون النهاية مع قوس دائري.

 var today = DateTime.local(2018, 12, 18); var later = DateTime.local(2020, 10, 12); var interval = Interval.fromDateTimes(today, later); interval.toString(); //=> "[2018-12-18T00:00:00.000+03:00 – 2020-10-12T00:00:00.000+03:00)" interval.toISO(); //=> "2018-12-18T00:00:00.000+03:00/2020-10-12T00:00:00.000+03:00" interval.length(); //=> 57369600000 interval.length('years', true); //=> 1.8169398907103824 interval.contains(DateTime.local(2019)); //=> true 

يمكن مقارنة الفواصل مع بعضها البعض ودمجها مع بعضها البعض:

 var nextYear = Interval.after(DateTime.local(), {year: 1}); var prevYear = Interval.before(DateTime.local(), {year: 1}); prevYear.overlaps(nextYear); //false prevYear.abutsStart(nextYear); //true nextYear.union(prevYear).length('years'); //=> 2 

Luxon واللحظة

تعيش مكتبة Luxon في مشروع "Moment" ، ولكنها ليست بديلاً كاملاً لمكتبة Moment. لا يوفر Luxon وظيفة Moment الكاملة ، على سبيل المثال ، لم يتم تنفيذ تنسيق التاريخ النسبي مؤخرًا إلا في إصدار متصفح Chrome 71 ، ولا يعمل بعد في المتصفحات الأخرى ، ولم يتم دعمه بعد في Luxon (على الرغم من أنه متوقع). ولكن حتى لو كانت المتصفحات تدعم الوظيفة المطلوبة ، يجب أن تفهم أنها ستكون متاحة فقط في هذه البيئات الجديدة. في المتصفحات القديمة ، ستعمل Luxon مع المشكلات ، بينما تعمل Moment في أي وقت وفي أي مكان.

بالإضافة إلى ذلك ، تمت إعادة تصميم واجهة برمجة تطبيقات Luxon بالكامل وهي مختلفة تمامًا عن واجهة برمجة تطبيقات Moment.

لاحظ الاختلافات الرئيسية بين Moment و Luxon.

الحصانة

كائنات Luxon غير قابلة للتغيير ، لكن Moment لا.
في المثال أدناه ، m1 و m2 هما نفس الكائن الذي تم تعديله بواسطة طريقة الإضافة.

 var m1 = moment(); var m2 = m1.add(1, 'hours'); m1 === m2; //=> true 

في حالة Luxon ، تقوم طريقة الجمع بإرجاع كائن d2 جديد دون تغيير d1 الأصلي.

 var d1 = DateTime.local(); var d2 = d1.plus({ hours: 1 }); d1 === d2; //=> false d1.valueOf() === d2.valueOf(); //=> false 

لهذا السبب ، لا يتطلب Luxon منشئي نسخ خاصين أو طرق استنساخ تستخدمها Moment للحصول على نسخ دون تغيير القيمة الأصلية.

الاختلافات الوظيفية الرئيسية

1. يبدأ العد التنازلي للأشهر في Luxon من 1 ، وليس من البداية ، كما في Moment (وفي الأصل في كائن Date js).
2. يتم تطبيق التعريب والمناطق الزمنية باستخدام API Intl الأصلي (أو polyphile) ، ولا يتم تضمينها في المكتبة.
3. يحتوي Luxon على أنواع مدمجة وفترة زمنية.
4. لا يدعم Luxon تنسيق التاريخ النسبي.
5. لا يوجد لدى Luxon أيضًا طريقة أنسنة لتمثيل المدة بأسلوب "إنساني" (على سبيل المثال ، "بضع ثوان").

اختلافات نمط API

• في أساليب Luxon API ، توجد المعلمات الاختيارية عادةً في آخر.
• يحتوي Luxon على العديد من الطرق المنفصلة لإنشاء كائنات (على سبيل المثال ، fromISO) ، على عكس Moment ، التي لها وظيفة واحدة لهذا ، ويتم تعيين نوع الكائن بواسطة المعلمات.
• لدى Luxon محللون صارمون للغاية ، في حين أن Moment لديه أكثر ليبرالية ، أي إذا كان تنسيق سلسلة الإدخال مختلفًا عن المعيار ، فسيقوم Luxon فورًا بتقديم خطأ ، وستحاول Moment تصحيح بعض الأخطاء في التنسيق.
• يستخدم Luxon getters (dt.year ، dt.isValid) للحصول على قيمة الحقول الداخلية ، وليس أساليب مثل Moment (m.year () ، m.isValid ()).
• يسمح Luxon لطريقة واحدة بتعيين جميع المعلمات الضرورية على الفور ({السنة: 2016 ، الشهر: 4}) ، في لحظة يتم تعيينها واحدة فقط في كل مرة - سلسلة من المكالمات m.year (2016) .month (4).
• المدة في Luxon هي فئة منفصلة من المستوى الأعلى.

خلاف ذلك ، استعار Luxon الكثير من الأفكار من Moment ، حتى أن الوثائق تحتوي على جداول معادلة أساليب Moment و Luxon.

أحجام ملفات المكتبة

لوكون (v. 1.8.2)
luxon.min.js - 61 كيلوبايت

لحظة (v. 2.23.0)
moment.min.js - 51 كيلو بايت
moment.min.js + locale / ru.js - 59 كيلوبايت
moment-with-locales.min.js - 323 كيلو بايت

كما ترون ، بدون لغات Moment ، يكون الحجم أصغر بمقدار 10 كيلو بايت من Luxon ، ولكن مع إضافة عدة لغات ، يصبح الحجم متساوًا تقريبًا.

إذا كان الدعم مطلوبًا فورًا لجميع المناطق ، فهناك مكسب كبير من Luxon.

ملخص

المكتبة جاهزة تمامًا للاستخدام ويعد المؤلف بدعمها. تحتوي المكتبة بالفعل على 7K + نجوم على جيثب وشعبيتها تنمو فقط. ليس فقط المؤلف نفسه يرتكب الالتزامات في شفرتها ، ولكن على الأقل 6 مطورين آخرين.

سأفترض أن مكتبة Luxon هي استجابة لظهور دعم API Intl في المتصفحات. يدرك مطورو اللحظات أن العمل مع التواريخ على الويب يمكن أن يتغير بشكل كبير ويحاولون الاستعداد لهذه التغييرات. لكنهم لا يستطيعون التنبؤ بدقة بتطوير الويب ، ومعه المشروع الجديد (الذي يسمونه هم أنفسهم مشروع مختبرات Moment). هل سيتم نقل أفكار Luxon إلى Moment 3؟ هل سينتقل معظم المستخدمين من Moment إلى Luxon في وقت ما؟ ربما سيتم إعادة تسمية Luxon بلحظة؟ المطورين أنفسهم يعترفون أنهم لا يستطيعون الآن الإجابة على هذه الأسئلة.