إشعار الترجمة بالذكاء الاصطناعي
تمت ترجمة هذا المستند بواسطة الذكاء الاصطناعي. للحصول على معلومات دقيقة، يرجى الرجوع إلى النسخة الإنجليزية.
تنسيق التاريخ
شرح الصيغة
تنسيق التاريخ، يقبل نمط تنسيق المخرجات 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: السنة برقمين، مثل 18
YYYY: السنة بأربعة أرقام، مثل 2018
M، 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 أو +0500
A، a: صباحاً/مساءً (AM/PM)
Q: الربع (1-4)
Do: اليوم مع لاحقة ترتيبية، مثل 1st, 2nd, …
- للاطلاع على التنسيقات الأخرى، يرجى مراجعة الوثائق الكاملة.
بالإضافة إلى ذلك، توجد تنسيقات محلية تعتمد على اللغة: مثل LT، LTS، L، LL، LLL، LLLL وغيرها.