TIP
מסמך זה תורגם על ידי בינה מלאכותית. לכל אי דיוק, אנא עיין בגרסה האנגלית
עיצוב תאריכים
הסבר תחבירי
מעצב תאריך על ידי קבלת תבנית פלט (patternOut) ותבנית קלט אופציונלית (patternIn), כאשר ברירת המחדל היא ISO 8601. ניתן להתאים את אזור הזמן והשפה באמצעות options.timezone ו-options.lang.
דוגמה
// סביבת דוגמה: אפשרויות API { "lang": "en-us", "timezone": "Europe/Paris" }
'20160131':formatD(L) // פלט 01/31/2016
'20160131':formatD(LL) // פלט January 31, 2016
'20160131':formatD(LLLL) // פלט Sunday, January 31, 2016 12:00 AM
'20160131':formatD(dddd) // פלט Sunday
// דוגמה בצרפתית:
'2017-05-10T15:57:23.769561+03:00':formatD(LLLL) // פלט mercredi 10 mai 2017 14:57
'20160131':formatD(LLLL) // פלט dimanche 31 janvier 2016 00:00
1410715640:formatD(LLLL, X) // פלט dimanche 14 septembre 2014 19:27
תוצאה
הפלט הוא מחרוזת התאריך המעוצבת לפי המפרט.
2. :addD(amount, unit, patternIn)
הסבר תחבירי
מוסיף כמות זמן מוגדרת לתאריך. היחידות הנתמכות כוללות: day, week, month, quarter, year, hour, minute, second, millisecond.
פרמטרים:
- amount: הכמות להוספה.
- unit: יחידת הזמן (לא תלוית רישיות).
- patternIn: אופציונלי, פורמט הקלט (ברירת המחדל היא ISO8601).
דוגמה
// סביבת דוגמה: אפשרויות API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':addD('3', 'day') // פלט "2017-05-13T12:57:23.769Z"
'2017-05-10 15:57:23.769561+03:00':addD('3', 'month') // פלט "2017-08-10T12:57:23.769Z"
'20160131':addD('3', 'day') // פלט "2016-02-03T00:00:00.000Z"
'20160131':addD('3', 'month') // פלט "2016-04-30T00:00:00.000Z"
'31-2016-01':addD('3', 'month', 'DD-YYYY-MM') // פלט "2016-04-30T00:00:00.000Z"
תוצאה
הפלט הוא התאריך החדש לאחר הוספת הזמן המוגדר.
3. :subD(amount, unit, patternIn)
הסבר תחבירי
מחסיר כמות זמן מוגדרת מתאריך. הפרמטרים זהים לאלו של addD.
דוגמה
// סביבת דוגמה: אפשרויות API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':subD('3', 'day') // פלט "2017-05-07T12:57:23.769Z"
'2017-05-10 15:57:23.769561+03:00':subD('3', 'month') // פלט "2017-02-10T12:57:23.769Z"
'20160131':subD('3', 'day') // פלט "2016-01-28T00:00:00.000Z"
'20160131':subD('3', 'month') // פלט "2015-10-31T00:00:00.000Z"
'31-2016-01':subD('3', 'month', 'DD-YYYY-MM') // פלט "2015-10-31T00:00:00.000Z"
תוצאה
הפלט הוא התאריך החדש לאחר הפחתת הזמן המוגדר.
4. :startOfD(unit, patternIn)
הסבר תחבירי
מגדיר את התאריך לתחילת יחידת הזמן המוגדרת.
פרמטרים:
- unit: יחידת הזמן.
- patternIn: אופציונלי, פורמט הקלט.
דוגמה
// סביבת דוגמה: אפשרויות API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':startOfD('day') // פלט "2017-05-10T00:00:00.000Z"
'2017-05-10 15:57:23.769561+03:00':startOfD('month') // פלט "2017-05-01T00:00:00.000Z"
'20160131':startOfD('day') // פלט "2016-01-31T00:00:00.000Z"
'20160131':startOfD('month') // פלט "2016-01-01T00:00:00.000Z"
'31-2016-01':startOfD('month', 'DD-YYYY-MM') // פלט "2016-01-01T00:00:00.000Z"
תוצאה
הפלט הוא מחרוזת התאריך המוגדרת לתחילת היחידה.
5. :endOfD(unit, patternIn)
הסבר תחבירי
מגדיר את התאריך לסוף יחידת הזמן המוגדרת.
הפרמטרים זהים לאלו של startOfD.
דוגמה
// סביבת דוגמה: אפשרויות API { "lang": "fr", "timezone": "Europe/Paris" }
'2017-05-10T15:57:23.769561+03:00':endOfD('day') // פלט "2017-05-10T23:59:59.999Z"
'2017-05-10 15:57:23.769561+03:00':endOfD('month') // פלט "2017-05-31T23:59:59.999Z"
'20160131':endOfD('day') // פלט "2016-01-31T23:59:59.999Z"
'20160131':endOfD('month') // פלט "2016-01-31T23:59:59.999Z"
'31-2016-01':endOfD('month', 'DD-YYYY-MM') // פלט "2016-01-31T23:59:59.999Z"
תוצאה
הפלט הוא מחרוזת התאריך המוגדרת לסוף היחידה.
6. :diffD(toDate, unit, patternFromDate, patternToDate)
הסבר תחבירי
מחשב את ההפרש בין שני תאריכים ומציג אותו ביחידה המוגדרת. יחידות הפלט הנתמכות כוללות:
day(s) או dweek(s) או wquarter(s) או Qmonth(s) או Myear(s) או yhour(s) או hminute(s) או msecond(s) או smillisecond(s) או ms (יחידת ברירת המחדל)
פרמטרים:
- toDate: תאריך היעד.
- unit: יחידת הפלט.
- patternFromDate: אופציונלי, פורמט תאריך ההתחלה.
- patternToDate: אופציונלי, פורמט תאריך היעד.
דוגמה
'20101001':diffD('20101201') // פלט 5270400000
'20101001':diffD('20101201', 'second') // פלט 5270400
'20101001':diffD('20101201', 's') // פלט 5270400
'20101001':diffD('20101201', 'm') // פלט 87840
'20101001':diffD('20101201', 'h') // פלט 1464
'20101001':diffD('20101201', 'weeks') // פלט 8
'20101001':diffD('20101201', 'days') // פלט 61
'2010+10+01':diffD('2010=12=01', 'ms', 'YYYY+MM+DD', 'YYYY=MM=DD') // פלט 5270400000
תוצאה
הפלט הוא הפרש הזמן בין שני התאריכים, מומר ליחידה המוגדרת.
7. :convDate(patternIn, patternOut)
הסבר תחבירי
ממיר תאריך מפורמט אחד לאחר (לא מומלץ לשימוש).
פרמטרים:
- patternIn: פורמט תאריך הקלט.
- patternOut: פורמט תאריך הפלט.
דוגמה
// סביבת דוגמה: אפשרויות API { "lang": "en", "timezone": "Europe/Paris" }
'20160131':convDate('YYYYMMDD', 'L') // פלט "01/31/2016"
'20160131':convDate('YYYYMMDD', 'LL') // פלט "January 31, 2016"
'20160131':convDate('YYYYMMDD', 'LLLL') // פלט "Sunday, January 31, 2016 12:00 AM"
'20160131':convDate('YYYYMMDD', 'dddd') // פלט "Sunday"
1410715640:convDate('X', 'LLLL') // פלט "Sunday, September 14, 2014 7:27 PM"
// דוגמה בצרפתית:
'20160131':convDate('YYYYMMDD', 'LLLL') // פלט "dimanche 31 janvier 2016 00:00"
'20160131':convDate('YYYYMMDD', 'dddd') // פלט "dimanche"
תוצאה
הפלט הוא מחרוזת התאריך המומרת לפורמט המוגדר.
8. תבניות עיצוב תאריכים
סימני תבניות תאריך נפוצים (עיין בתיעוד DayJS):
X: חותמת זמן Unix (בשניות), לדוגמה 1360013296x: חותמת זמן Unix באלפיות השנייה, לדוגמה 1360013296123YY: שנה דו-ספרתית, לדוגמה 18YYYY: שנה ארבע-ספרתית, לדוגמה 2018M, MM, MMM, MMMM: חודש (מספר, דו-ספרתי, מקוצר, שם מלא)D, DD: יום בחודש (מספר, דו-ספרתי)d, dd, ddd, dddd: יום בשבוע (מספר, מינימלי, מקוצר, שם מלא)H, HH, h, hh: שעה (בפורמט 24 שעות או 12 שעות)m, mm: דקהs, ss: שנייהSSS: אלפית השנייה (3 ספרות)Z, ZZ: היסט UTC, לדוגמה +05:00 או +0500A, a: AM/PMQ: רבעון (1-4)Do: יום בחודש עם סיומת סודרת, לדוגמה 1st, 2nd, …- לפורמטים נוספים, עיין בתיעוד המלא.
בנוסף, קיימים פורמטים מותאמים לשפה, כגון
LT, LTS, L, LL, LLL, LLLL וכו'.
