logologo
البدء
الدليل
التطوير
الإضافات
API
English
简体中文
日本語
한국어
Deutsch
Français
Español
Português
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
البدء
الدليل
التطوير
الإضافات
API
logologo
نظرة عامة
تعليمات الإعداد

بناء جملة القالب

الاستخدام الأساسي
معالجة التكرار

أدوات التنسيق

نظرة عامة
تنسيق النص
تنسيق الأرقام
تنسيق العملة
تنسيق التاريخ
تنسيق الفاصل الزمني
تنسيق المصفوفة

ميزات متقدمة

الحكم الشرطي
ميزات متقدمة
الأسئلة الشائعة
سيناريوهات التطبيق
Previous Pageتنسيق العملة
Next Pageتنسيق الفاصل الزمني
إشعار الترجمة بالذكاء الاصطناعي

تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.

#تنسيق التاريخ

#1. formatD(patternOut, patternIn)

#شرح الصيغة

تنسّق هذه الدالة التاريخ بقبول نمط تنسيق للإخراج 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، إلخ.