دع مكتبة Luxon تتحمل عبء معالجة التاريخ والوقت لتطبيقات JavaScript.

يمكنك استخدام JavaScript لإنشاء تطبيقات وتطبيقات ويب ديناميكية تعمل في بيئات أخرى ، بما في ذلك سطح المكتب. تحتاج العديد من التطبيقات إلى التعامل مع التواريخ والأوقات ، من الجدولة وتطبيقات الدردشة إلى تطبيقات حجز الأحداث.

تقدم Luxon بديلاً ممتازًا لجافا سكريبت الأصلي تاريخ الكائن ، مع طرق أكثر موثوقية وسهلة الاستخدام للتعامل مع عمليات التاريخ والوقت.

تركيب Luxon

يمكنك إضافة Luxon إلى تطبيق JavaScript بعدة طرق ، اعتمادًا على طريقتك المفضلة. الطريقتان الأكثر شيوعًا هي الاستخدام npm لتثبيت المكتبة أو لاستخدام ارتباط CDN لتضمين المكتبة في التطبيق الخاص بك.

لتثبيت Luxon في مشروع Node.js ، قم بتشغيل الأمر npm التالي في جهازك الطرفي:

تثبيت npm - حفظ luxon

استخدم المكتبة في ملف JavaScript الخاص بك عن طريق طلب luxon:

مقدار ثابت {DateTime} = يتطلب("لوكسون");

يستخدم هذا الرمز تدمير الكائن لاستيراد ملف التاريخ والوقت class من مكتبة Luxon وإنشاء متغير جديد التاريخ والوقت الرجوع إلى تلك الفئة.

يتيح لك ذلك إنشاء مثيلات للتواريخ والأوقات وإجراء عمليات مثل تنسيق التواريخ للعرض.

instagram viewer

بدلاً من ذلك ، يمكنك تضمين Luxon في تطبيقك باستخدام ملف رابط CDN. للقيام بذلك ، قم بإضافة الترميز التالي إلى ملف HTML الخاص بك:

<النصيsrc=" https://cdn.jsdelivr.net/npm/[email protected]/build/global/luxon.min.js">النصي>

باستخدام هذا الأسلوب ، يمكنك تشغيل البرامج النصية باستخدام لوكسون في نص HTML الخاص بك.

ميزات Luxon

يوفر Luxon العديد من الميزات ، مما يجعله حزمة قيمة للتعامل مع التواريخ والأوقات في تطبيقات JavaScript.

التلاعب الشامل في التاريخ والوقت

تقدم Luxon طرقًا مختلفة لإنشاء التواريخ والأوقات ومعالجتها واسترجاعها. يبسط Luxon المهام مثل إضافة المدد أو طرحها ، وتعيين مكونات محددة للتاريخ / الوقت ، وإجراء عمليات حسابية للوقت النسبي.

التنسيق والترجمة

تتيح لك خيارات تنسيق Luxon عرض التواريخ والأوقات بتنسيقات عديدة. يدعم Luxon أنماط تنسيق مختلفة ويتيح لك تعيين التواريخ والأوقات وفقًا للغات الأخرى.

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

مع Luxon ، يمكنك العمل بكفاءة مع التواريخ والأوقات في مناطق زمنية مختلفة. يوفر Luxon طرقًا لضبط وتحويل المناطق الزمنية.

تصميم ثابت

تتبع Luxon نمط تصميم غير قابل للتغيير ، مما يضمن ذلك التاريخ والوقت الأشياء غير قابلة للتغيير. يوفر نهج التصميم هذا سلوكًا يمكن التنبؤ به ومتسقًا عند التعامل مع التواريخ والأوقات.

وثائق API واسعة النطاق

وثائق واجهة برمجة تطبيقات Luxon مفصلة للغاية ، مما يجعل من السهل استكشاف وفهم الأساليب والخيارات والوظائف المتاحة.

فئة DateTime في Luxon

ال التاريخ والوقت يمثل class في Luxon تاريخًا ووقتًا معينين. إنه يوفر طرقًا للفئات والمثيلات تتيح لك تنفيذ مهام مختلفة. تتضمن هذه المهام إنشاء التواريخ والأوقات وتحليلها واستردادها وتعديلها وتنسيقها.

فيما يلي بعض الطرق المختلفة لإنشاء مثيل جديد لفئة التاريخ والوقت في Luxon:

  • ال DateTime.local () طريقة:
    مقدار ثابت dt = DateTime.local (2023, 5, 21, 1, 22, 37, 845);
    يقوم هذا الرمز بإنشاء مثيل DateTime جديد باستخدام امتداد الملف DateTime.local () طريقة. تأخذ الطريقة سبع وسيطات تمثل قيم السنة والشهر واليوم والساعة والدقيقة والثانية والميلي ثانية للتاريخ والوقت اللذين تريد إنشاءهما.
  • ال DateTime.fromJSDate () طريقة:
    مقدار ثابت الآن = جديدتاريخ();
    مقدار ثابت dt = DateTime.fromJSDate (الآن) ،
    الكود يخلق ملف تاريخ جافا سكريبت الأصلي المثيل ويمرره إلى DateTime.fromJSDate () طريقة. تقوم هذه الطريقة بإرجاع كائن DateTime الذي يمثل نفس التاريخ والوقت.
  • ال DateTime.fromObject () طريقة:
    مقدار ثابت dt = DateTime.fromObject ({
     سنة: 2023,
     شهر: 1,
     يوم: 1,
     ساعة: 0,
     دقيقة:0,
     ثانية: 0,
     ميلي ثانية: 0
    });
    يوضح مقطع التعليمات البرمجية هذا كيفية إنشاء مثيل DateTime جديد باستخدام امتداد الملف DateTime.fromObject () طريقة. تأخذ الطريقة كائنًا بخصائص تمثل قيم السنة والشهر واليوم والساعة والدقيقة والثانية والميلي ثانية للتاريخ والوقت اللذين تريد إنشاءهما.
  • باستخدام DateTime.now () طريقة:
    مقدار ثابت dt = DateTime.now () ،
    يوضح مقطع التعليمات البرمجية هذا كيفية إنشاء مثيل تاريخ ووقت جديد باستخدام امتداد DateTime.now () طريقة. تقوم الطريقة بإرجاع مثيل DateTime جديد يمثل التاريخ والوقت الحاليين في المنطقة الزمنية المحلية.

تنسيق كائنات DateTime إلى سلاسل

يبسط Luxon تنسيق ملفات التاريخ والوقت كائنات في سلاسل تمثل تواريخ وأوقات محددة. يمكنك استخدام Luxon لتنسيق التواريخ والأوقات بطرق مختلفة.

ISO 8601

يتم استخدام تنسيق ISO 8601 على نطاق واسع لتمثيل التاريخ والوقت القياسي. لتنسيق أ التاريخ والوقت كسلسلة ISO 8601 ، استخدم toISO () طريقة:

مقدار ثابت now = DateTime.local () ؛
وحدة التحكم.log (now.toISO ()) ؛ // 2023-05-21T15: 20: 07.936 + 01: 00

تنسيقات قابلة للقراءة البشرية

يدعم Luxon التنسيقات التي يمكن للبشر قراءتها والتي يمكنك تخصيصها للغات المحلية. يمكنك تنسيق ملف التاريخ والوقت تعترض على سلسلة يمكن للبشر قراءتها بامتداد toLocaleString () طريقة:

مقدار ثابت now = DateTime.local () ؛
وحدة التحكم.log (now.toLocaleString ()) ؛ // 5/21/2023

التنسيق المستند إلى الرمز المميز

يسمح لك التنسيق المستند إلى الرمز المميز بتنسيق التاريخ والوقت في سلاسل مخصصة باستخدام عناصر نائبة تسمى الرموز المميزة. لتنسيق أ التاريخ والوقت كائن باستخدام الرموز المميزة ، فاستخدم toFormat () طريقة:

مقدار ثابت now = DateTime.local () ؛
وحدة التحكم.log (now.toFormat ("yyyy-MM-dd HH: mm: ss")); //2023-05-21 15:16:57

في المثال أعلاه ، سلسلة التنسيق yyyy-MM-dd HH: mm: ss يمثل تنسيق الإخراج المطلوب. الرموز س س س س, مم, ي, ح ح, مم، و ss تتوافق مع السنة والشهر واليوم والساعة والدقيقة والثانية من التاريخ والوقت الكائن ، على التوالي.

يسمح لك Luxon بأداء مجموعة واسعة من تمثيلات التاريخ والوقت من خلال توفير مجموعة واسعة من الرموز المميزة.

الاعراب والتحقق من صحة التواريخ والأوقات في Luxon

يوفر Luxon طرقًا قوية للتحليل والتحقق من صحة التواريخ والأوقات. هذه الميزات مفيدة لمهام مثل التحقق من صحة إدخال المستخدم أو تحويل تمثيلات السلسلة للتواريخ والأوقات إلى التاريخ والوقت أشياء.

طريقة fromFormat ()

ال fromFormat () تسمح لك هذه الطريقة بتحليل تمثيل سلسلة لتاريخ ووقت ، وتحويله إلى ملف التاريخ والوقت هدف. يستغرق وسيطتين ، سلسلة الإدخال وسلسلة التنسيق التي تحدد تنسيق الإدخال.

على سبيل المثال:

DateTime.fromFormat ("25 مايو 2023", "LLLL dd yyyy")

التحقق من التواريخ والأوقات بالطريقة الصالحة

ال صالح طريقة التحقق إذا أ التاريخ والوقت يمثل الكائن تاريخًا ووقتًا صالحين. يعود حقيقي إذا كان الكائن صالحًا و خطأ شنيع خلاف ذلك.

مثل ذلك:

مقدار ثابت alidDate = DateTime.fromObject ({ سنة: 2022, شهر: 2, يوم: 29 });
وحدة التحكم.log (validDate.isValid) ، // خطأ شنيع
مقدار ثابت validDate = DateTime.fromObject ({ سنة: 2022, شهر: 2, يوم: 28 });
وحدة التحكم.log (validDate.isValid) ؛ // حقيقي

في المثال الأول التاريخ والوقت يمثل الكائن تاريخًا غير صالح نظرًا لأن 29 فبراير 2022 غير صالح. الثاني التاريخ والوقت يمثل الكائن تاريخًا صالحًا في 28 فبراير 2022.

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

بدائل لـ Luxon

لقد تعلمت كيفية إنشاء وتنسيق والتحقق من صحة مثيلات التاريخ والوقت باستخدام Luxon. ستساعدك هذه النصائح عند إنشاء تطبيقات الويب التي تتطلب التعامل مع التاريخ والوقت.

يمكنك أيضًا استخدام حزم JavaScript أخرى لتحقيق معالجة التاريخ والوقت في تطبيقات الويب الخاصة بك ، بما في ذلك Day.js و Date.fns. هذه الحزم لها مزاياها وعيوبها ، ويجب أن تبني تفضيلاتك على احتياجاتك الخاصة.