טפל בפעולות תאריך ושעה עם Luxon, ספריית תאריכים מודרנית של JavaScript

אתה יכול להשתמש ב-JavaScript כדי לבנות יישומי אינטרנט ויישומים דינמיים הפועלים בסביבות אחרות, כולל שולחן העבודה. אפליקציות רבות צריכות לטפל בתאריכים ושעות, החל מתזמנים ויישומי צ'אט ועד אפליקציות להזמנת אירועים.

Luxon מציעה אלטרנטיבה מעולה ל-JavaScript המקורי תַאֲרִיך אובייקט, עם דרכים ידידותיות יותר ואמינות יותר לטפל בפעולות תאריך ושעה.

התקנת Luxon

אתה יכול להוסיף את Luxon לאפליקציית JavaScript שלך בכמה דרכים, בהתאם לשיטה המועדפת עליך. שתי השיטות הנפוצות ביותר הן לשימוש npm כדי להתקין את הספרייה או להשתמש בקישור CDN כדי לכלול את הספרייה באפליקציה שלך.

כדי להתקין את Luxon בפרויקט Node.js, הפעל את הפקודה npm הבאה בטרמינל שלך:

npm install --save luxon

השתמש בספרייה בקובץ ה-JavaScript שלך על ידי דרישת luxon:

const { DateTime } = לִדרוֹשׁ("לוקסון");

קוד זה משתמש הרס אובייקט לייבא את תאריך שעה class מספריית Luxon וליצור משתנה חדש תאריך שעה בהתייחס למעמד הזה.

זה מאפשר לך ליצור מופעים של תאריכים ושעות ולבצע פעולות כגון עיצוב תאריכים לתצוגה.

לחלופין, אתה יכול לכלול את 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 נרחב

תיעוד ה-API של Luxon מפורט מאוד, מה שמקל על חקירה והבנה של השיטות, האפשרויות והפונקציונליות הזמינות.

כיתת DateTime בלוקסון

ה תאריך שעה מחלקה בלוקסון מייצגת תאריך ושעה מסוימים. הוא מציע גם שיטות מחלקות וגם שיטות המאפשרות לך לבצע משימות שונות. משימות אלו כוללות יצירה, ניתוח, אחזור, שינוי ועיצוב תאריכים ושעות.

הנה כמה מהדרכים השונות ליצור מופע חדש של מחלקת תאריך שעה בלוקסון:

• ה DateTime.local() שיטה:

  const dt = DateTime.local(2023, 5, 21, 1, 22, 37, 845);
  

  קוד זה יוצר מופע DateTime חדש באמצעות ה- DateTime.local() שיטה. השיטה לוקחת שבעה ארגומנטים המייצגים את ערכי השנה, החודש, היום, השעה, הדקה, השנייה ומילי-שניות של התאריך והשעה שברצונך ליצור.
• ה DateTime.fromJSDate() שיטה:

  const עכשיו = חָדָשׁתַאֲרִיך();
  const dt = DateTime.fromJSDate (עכשיו);

  הקוד יוצר חדש תאריך JavaScript מקורי מופע ומעביר אותו ל- DateTime.fromJSDate() שיטה. שיטה זו מחזירה אובייקט DateTime המייצג את אותם תאריך ושעה.
• ה DateTime.fromObject() שיטה:

  const dt = DateTime.fromObject({
   שָׁנָה: 2023,
   חוֹדֶשׁ: 1,
   יְוֹם: 1,
   שָׁעָה: 0,
   דַקָה:0,
   שְׁנִיָה: 0,
   אלפית שנייה: 0
  });

  בלוק קוד זה מראה כיצד ליצור מופע DateTime חדש באמצעות ה DateTime.fromObject() שיטה. השיטה לוקחת אובייקט עם מאפיינים המייצגים את ערכי השנה, החודש, היום, השעה, הדקה, השניה ומילי-שניות של התאריך והשעה שברצונך ליצור.
• משתמש ב DateTime.now() שיטה:

  const dt = DateTime.now();
  

  בלוק קוד זה מראה כיצד ליצור מופע חדש של Date Time באמצעות ה DateTime.now() שיטה. השיטה מחזירה מופע DateTime חדש המייצג את התאריך והשעה הנוכחיים באזור הזמן המקומי.

עיצוב אובייקטי DateTime למחרוזות

Luxon מפשט את העיצוב של תאריך שעה אובייקטים לתוך מחרוזות המייצגות תאריכים ושעות ספציפיים. אתה יכול להשתמש ב- Luxon כדי לעצב תאריכים ושעות בשיטות שונות.

ISO 8601

פורמט ISO 8601 נמצא בשימוש נרחב לייצוג תאריך ושעה סטנדרטי. לפורמט א תאריך שעה אובייקט כמחרוזת ISO 8601, השתמש ב- toISO() שיטה:

const now = DateTime.local();
לְנַחֵם.log (now.toISO()); // 2023-05-21T15:20:07.936+01:00

פורמטים קריא אנושיים

Luxon תומכת בפורמטים הניתנים לקריאה על ידי אדם שתוכל להתאים אישית עבור שפות מקומיות. אתה יכול לעצב את א תאריך שעה מתנגד למחרוזת הניתנת לקריאה באמצעות ה- toLocaleString() שיטה:

const now = DateTime.local();
לְנַחֵם.log (now.toLocaleString()); // 5/21/2023

עיצוב מבוסס אסימון

עיצוב מבוסס אסימון מאפשר לך לעצב תאריך ושעה למחרוזות מותאמות אישית באמצעות מצייני מיקום הנקראים אסימונים. לפורמט א תאריך שעה אובייקט באמצעות אסימונים, השתמש ב- לפרמט() שיטה:

const now = DateTime.local();
לְנַחֵם.log (now.toFormat("yyyy-MM-dd HH: mm: ss")); //2023-05-21 15:16:57

בדוגמה למעלה, מחרוזת הפורמט yyyy-MM-dd HH: mm: ss מייצג את פורמט הפלט הרצוי. האסימונים yyyy, מ.מ, dd, HH, מ"מ, ו ss תואמים את השנה, החודש, היום, השעה, הדקה והשנייה של ה תאריך שעה אובייקט, בהתאמה.

Luxon מאפשרת לך לבצע מגוון רחב של ייצוגי תאריך ושעה על ידי אספקת סט נרחב של אסימונים.

ניתוח ואימות תאריכים ושעות בלוקסון

Luxon מספקת שיטות חזקות לניתוח ואימות תאריכים ושעות. תכונות אלה שימושיות עבור משימות כגון אימות קלט משתמש או המרת ייצוגי מחרוזת של תאריכים ושעות תאריך שעה חפצים.

שיטת fromFormat()‎

ה fromFormat() השיטה מאפשרת לך לנתח ייצוג מחרוזת של תאריך ושעה, ולהמיר אותו ל-a תאריך שעה לְהִתְנַגֵד. זה דורש שני ארגומנטים, מחרוזת הקלט ומחרוזת פורמט המציינת את פורמט הקלט.

לדוגמה:

DateTime.fromFormat("25 במאי 2023", "LLLL dd yyyy")

אימות תאריכים ושעות בשיטת isValid

ה הוא תקף השיטה בודקת אם א תאריך שעה אובייקט מייצג תאריך ושעה חוקיים. זה חוזר נָכוֹן אם האובייקט תקף ו שֶׁקֶר אחרת.

ככה:

const invalidDate = DateTime.fromObject({ שָׁנָה: 2022, חוֹדֶשׁ: 2, יְוֹם: 29 });
לְנַחֵם.log (invalidDate.isValid); // שקר
const validDate = DateTime.fromObject({ שָׁנָה: 2022, חוֹדֶשׁ: 2, יְוֹם: 28 });
לְנַחֵם.log (validDate.isValid); // נכון

בדוגמה, הראשון תאריך שעה אובייקט מייצג תאריך לא חוקי מכיוון ש-29 בפברואר 2022 אינו חוקי. השני תאריך שעה האובייקט מייצג תאריך תקף של 28 בפברואר 2022.

תכונות ניתוח ואימות ב- Luxon עוזרות לך לטפל במדויק בתאריכים ובשעות, לאמת קלט ולספק ייצוגים אמינים של נתוני תאריך ושעה.

חלופות ללוקסון

למדת כיצד ליצור, לעצב ולאמת מופעי תאריך ושעה עם Luxon. טיפים אלה יסייעו לך בבניית אפליקציות אינטרנט הדורשות טיפול בתאריך ושעה.

אתה יכול גם להשתמש בחבילות JavaScript אחרות כדי להשיג טיפול בתאריך ושעה ביישומי האינטרנט שלך, כולל Day.js ו-Date.fns. לחבילות אלו יש יתרונות וחסרונות, ועליכם לבסס את העדפתכם על הצרכים הספציפיים שלכם.