הודעת תרגום AI
מסמך זה תורגם על ידי AI. למידע מדויק, אנא עיינו בגרסה באנגלית.
עיצוב תאריכים
הסבר תחבירי
מעצב תאריך, מקבל תבנית פלט patternOut ותבנית קלט patternIn (ברירת מחדל ISO 8601).
דוגמאות נפוצות
{d.createdAt:formatD(YYYY-MM-DD)} // פלט 2024-01-15
{d.createdAt:formatD(YYYY年M月D日)} // פלט 2024年1月15日
{d.updatedAt:formatD(YYYY年M月D日 HH:mm)} // פלט 2024年1月15日 14:30
{d.orderDate:formatD(YYYY/MM/DD HH:mm:ss)} // פלט 2024/01/15 14:30:25
{d.birthday:formatD(M月D日)} // פלט 1月15日
{d.meetingTime:formatD(HH:mm)} // פלט 14:30
{d.deadline:formatD(YYYY年M月D日 dddd)} // פלט 2024年1月15日 星期一
דוגמאות לפורמטים נוספים
'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
תוצאה
הפלט הוא מחרוזת תאריך בפורמט שצוין.
2. :addD(amount, unit, patternIn)
הסבר תחבירי
מוסיף כמות זמן מוגדרת לתאריך. יחידות נתמכות: day, week, month, quarter, year, hour, minute, second, millisecond.
פרמטרים:
- amount: הכמות להוספה
- unit: יחידת זמן (ללא הבחנה בין אותיות רישיות לקטנות)
- patternIn: אופציונלי, תבנית קלט, ברירת מחדל ISO8601
דוגמה
'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.
דוגמה
'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: אופציונלי, תבנית קלט
דוגמה
'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)
הסבר תחבירי
מגדיר את התאריך לסוף יחידת הזמן שצוינה.
פרמטרים זהים לעיל.
דוגמה
'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) או d
week(s) או w
quarter(s) או Q
month(s) או M
year(s) או y
hour(s) או h
minute(s) או m
second(s) או s
millisecond(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: פורמט תאריך פלט
דוגמה
'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"
תוצאה
הפלט הוא מחרוזת תאריך מומרת.
8. תבניות עיצוב תאריכים
הסבר על תבניות תאריך נפוצות (בהתאם לתיעוד DayJS):
X: חותמת זמן Unix (שניות), כגון 1360013296
x: חותמת זמן Unix באלפיות השנייה, כגון 1360013296123
YY: שנה ב-2 ספרות, כגון 18
YYYY: שנה ב-4 ספרות, כגון 2018
M, MM, MMM, MMMM: חודש (מספר, 2 ספרות, קיצור, שם מלא)
D, DD: יום (מספר, 2 ספרות)
d, dd, ddd, dddd: יום בשבוע (מספר, מינימלי, מקוצר, שם מלא)
H, HH, h, hh: שעות (פורמט 24 שעות או 12 שעות)
m, mm: דקות
s, ss: שניות
SSS: אלפיות השנייה (3 ספרות)
Z, ZZ: היסט UTC, כגון +05:00 או +0500
A, a: AM/PM
Q: רבעון (1-4)
Do: יום בחודש עם מספר סידורי, כגון 1st, 2nd, …
- פורמטים נוספים ניתן למצוא בתיעוד המלא.
בנוסף, קיימים פורמטים מקומיים מבוססי שפה: כגון LT, LTS, L, LL, LLL, LLLL וכו'.