إشعار الترجمة بالذكاء الاصطناعي
تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.
تنسيق التاريخ
شرح الصيغة
تنسّق هذه الدالة التاريخ بقبول نمط تنسيق للإخراج 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) أو 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: نمط تنسيق الإخراج للتاريخ.
مثال
// بيئة المثال: خيارات 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 (بالثواني)، مثال: 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، إلخ.