متى تستخدم هذه الدوال؟
استخدم قيماً تاريخية بصيغة ISO قدر الإمكان واختبر التعبير في سياق الحقل أو النموذج أو القالب نفسه. التنسيق للعرض، أما المقارنة والحساب فيجب أن يعتمدا على قيمة التاريخ الأساسية.طريقة الكتابة
استخدم الدالة بصيغةdateFormat($.submitted_at, "YYYY-MM-DD"). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
addDays
تضيف عدداً من الأيام إلى قيمة تاريخ أو وقت.
التوقيع: addDays(date, days)
مثال:
value | addDays(...).
addHours
تضيف عدداً من الساعات إلى قيمة تاريخ أو وقت.
التوقيع: addHours(date, hours)
مثال:
value | addHours(...).
addMinutes
تضيف عدداً من الدقائق إلى قيمة تاريخ أو وقت.
التوقيع: addMinutes(date, minutes)
مثال:
value | addMinutes(...).
addMonths
تضيف عدداً من الأشهر إلى قيمة تاريخ أو وقت.
التوقيع: addMonths(date, months)
مثال:
value | addMonths(...).
addYears
تضيف عدداً من السنوات إلى قيمة تاريخ أو وقت.
التوقيع: addYears(date, years)
مثال:
value | addYears(...).
date
تنشئ أو تحول قيمة إلى كائن تاريخ قابل للاستخدام في دوال التاريخ.
التوقيع: date(year, month, day, hour?, minute?, second?, millisecond?)
مثال:
value | date(...).
dateAdd
تضيف مقداراً بوحدة زمنية محددة إلى تاريخ.
التوقيع: dateAdd(date, amount, unit)
مثال:
value | dateAdd(...).
dateDiff
تعيد الفرق بين تاريخين بالوحدة الزمنية المحددة.
التوقيع: dateDiff(date, other, unit)
مثال:
value | dateDiff(...).
dateFormat
تنسيق قيمة التاريخ للعرض باستخدام رموز التنسيق العامة ذات الأحرف الكبيرة مثل YYYY-MM-DD.
التوقيع: dateFormat(date, format)
مثال:
value | dateFormat(...).
dateFromString
تحول سلسلة تاريخ صالحة إلى قيمة تاريخ.
التوقيع: dateFromString(str)
مثال:
value | dateFromString(...).
dateFromTime
تنشئ قيمة تاريخ من مكونات الوقت أو من تمثيل وقت مدعوم.
التوقيع: dateFromTime(time)
مثال:
value | dateFromTime(...).
dateFromTimestamp
تحول طابعاً زمنياً بالمللي ثانية إلى قيمة تاريخ.
التوقيع: dateFromTimestamp(timestamp)
مثال:
value | dateFromTimestamp(...).
dateParse
تحلل نص تاريخ وفق نمط تنسيق محدد وتعيد قيمة تاريخ.
التوقيع: dateParse(str, format)
مثال:
value | dateParse(...).
dateSubtract
تطرح مقداراً بوحدة زمنية محددة من تاريخ.
التوقيع: dateSubtract(date, amount, unit)
مثال:
value | dateSubtract(...).
day
تعيد يوم الشهر من قيمة التاريخ.
التوقيع: day(date)
مثال:
value | day(...).
dayOfYear
تعيد رقم اليوم ضمن السنة.
التوقيع: dayOfYear(date)
مثال:
value | dayOfYear(...).
daysInMonth
تعيد عدد الأيام في شهر التاريخ المعطى.
التوقيع: daysInMonth(year, month)
مثال:
value | daysInMonth(...).
diffDays
تعيد الفرق بين تاريخين بعدد الأيام.
التوقيع: diffDays(date1, date2)
مثال:
value | diffDays(...).
diffHours
تعيد الفرق بين تاريخين بعدد الساعات.
التوقيع: diffHours(date1, date2)
مثال:
value | diffHours(...).
diffMinutes
تعيد الفرق بين تاريخين بعدد الدقائق.
التوقيع: diffMinutes(date1, date2)
مثال:
value | diffMinutes(...).
endOfDay
تعيد لحظة نهاية اليوم للتاريخ المعطى.
التوقيع: endOfDay(date)
مثال:
value | endOfDay(...).
endOfMonth
تعيد لحظة نهاية الشهر للتاريخ المعطى.
التوقيع: endOfMonth(date)
مثال:
value | endOfMonth(...).
endOfWeek
تعيد لحظة نهاية الأسبوع للتاريخ المعطى.
التوقيع: endOfWeek(date)
مثال:
value | endOfWeek(...).
endOfYear
تعيد لحظة نهاية السنة للتاريخ المعطى.
التوقيع: endOfYear(date)
مثال:
value | endOfYear(...).
formatDateTime
تنسيق تاريخ ووقت للعرض وفق الإعدادات المحلية المتاحة.
التوقيع: formatDateTime(date, dateStyle?, timeStyle?, locale?)
مثال:
value | formatDateTime(...).
formatFull
تنسيق التاريخ أو الوقت بأسلوب عرض كامل.
التوقيع: formatFull(date, locale?)
مثال:
value | formatFull(...).
formatLong
تنسيق التاريخ أو الوقت بأسلوب عرض طويل.
التوقيع: formatLong(date, locale?)
مثال:
value | formatLong(...).
formatMedium
تنسيق التاريخ أو الوقت بأسلوب عرض متوسط.
التوقيع: formatMedium(date, locale?)
مثال:
value | formatMedium(...).
formatShort
تنسيق التاريخ أو الوقت بأسلوب عرض قصير.
التوقيع: formatShort(date, locale?)
مثال:
value | formatShort(...).
formatTimeLong
تنسيق الجزء الزمني بأسلوب عرض طويل.
التوقيع: formatTimeLong(date, locale?)
مثال:
value | formatTimeLong(...).
formatTimeMedium
تنسيق الجزء الزمني بأسلوب عرض متوسط.
التوقيع: formatTimeMedium(date, locale?)
مثال:
value | formatTimeMedium(...).
formatTimeShort
تنسيق الجزء الزمني بأسلوب عرض قصير.
التوقيع: formatTimeShort(date, locale?)
مثال:
value | formatTimeShort(...).
getAge
تحسب العمر التقريبي أو الكامل من تاريخ الميلاد وتاريخ مرجعي حسب توقيع الدالة.
التوقيع: getAge(birthDate)
مثال:
value | getAge(...).
hour
تعيد ساعة اليوم من قيمة التاريخ.
التوقيع: hour(date)
مثال:
value | hour(...).
isAfter
تتحقق من وقوع تاريخ بعد تاريخ آخر، مع إمكانية تحديد دقة المقارنة.
التوقيع: isAfter(date, other, unit)
مثال:
value | isAfter(...).
isBefore
تتحقق من وقوع تاريخ قبل تاريخ آخر، مع إمكانية تحديد دقة المقارنة.
التوقيع: isBefore(date, other, unit)
مثال:
value | isBefore(...).
isLeapYear
تتحقق من كون سنة التاريخ سنة كبيسة.
التوقيع: isLeapYear(year)
مثال:
value | isLeapYear(...).
isSame
تتحقق من تساوي تاريخين، مع إمكانية تحديد دقة المقارنة.
التوقيع: isSame(date, other, unit)
مثال:
value | isSame(...).
isSameDay
تتحقق من وقوع تاريخين في اليوم التقويمي نفسه.
التوقيع: isSameDay(date1, date2)
مثال:
value | isSameDay(...).
isSameOrAfter
تتحقق من وقوع تاريخ في نفس تاريخ آخر أو بعده.
التوقيع: isSameOrAfter(date, other, unit)
مثال:
value | isSameOrAfter(...).
isSameOrBefore
تتحقق من وقوع تاريخ في نفس تاريخ آخر أو قبله.
التوقيع: isSameOrBefore(date, other, unit)
مثال:
value | isSameOrBefore(...).
isToday
تتحقق من وقوع التاريخ في يوم اليوم وفق منطقة زمنية التقييم.
التوقيع: isToday(date)
مثال:
value | isToday(...).
isTomorrow
تتحقق من وقوع التاريخ في يوم الغد وفق منطقة زمنية التقييم.
التوقيع: isTomorrow(date)
مثال:
value | isTomorrow(...).
isValidDatePattern
تتحقق من صلاحية نص التاريخ وفق نمط تاريخ محدد.
التوقيع: isValidDatePattern(dateString)
مثال:
value | isValidDatePattern(...).
isYesterday
تتحقق من وقوع التاريخ في يوم الأمس وفق منطقة زمنية التقييم.
التوقيع: isYesterday(date)
مثال:
value | isYesterday(...).
millisecond
تعيد جزء المللي ثانية من قيمة التاريخ.
التوقيع: millisecond(date)
مثال:
value | millisecond(...).
minute
تعيد دقيقة الساعة من قيمة التاريخ.
التوقيع: minute(date)
مثال:
value | minute(...).
month
تعيد رقم الشهر من قيمة التاريخ.
التوقيع: month(date)
مثال:
value | month(...).
normalizeDateInput
توحّد مدخل تاريخ أو وقت مدعوم إلى قيمة يمكن لدوال التاريخ معالجتها.
التوقيع: normalizeDateInput(value)
مثال:
value | normalizeDateInput(...).
now
تعيد التاريخ والوقت الحاليين عند التقييم. لا تستخدمها في قيمة محفوظة تتطلب ثباتاً دون سياسة تحديث.
التوقيع: now()
مثال:
value | now(...).
parseDateString
تحلل سلسلة تاريخ شائعة إلى قيمة تاريخ عند إمكان ذلك.
التوقيع: parseDateString(dateString)
مثال:
value | parseDateString(...).
parseIsoDate
تحلل سلسلة تاريخ ISO إلى قيمة تاريخ.
التوقيع: parseIsoDate(isoDate)
مثال:
value | parseIsoDate(...).
second
تعيد ثانية الدقيقة من قيمة التاريخ.
التوقيع: second(date)
مثال:
value | second(...).
startOfDay
تعيد لحظة بداية اليوم للتاريخ المعطى.
التوقيع: startOfDay(date)
مثال:
value | startOfDay(...).
startOfMonth
تعيد لحظة بداية الشهر للتاريخ المعطى.
التوقيع: startOfMonth(date)
مثال:
value | startOfMonth(...).
startOfWeek
تعيد لحظة بداية الأسبوع للتاريخ المعطى.
التوقيع: startOfWeek(date)
مثال:
value | startOfWeek(...).
startOfYear
تعيد لحظة بداية السنة للتاريخ المعطى.
التوقيع: startOfYear(date)
مثال:
value | startOfYear(...).
subtractDays
تطرح عدداً من الأيام من قيمة تاريخ أو وقت.
التوقيع: subtractDays(date, days)
مثال:
value | subtractDays(...).
subtractMonths
تطرح عدداً من الأشهر من قيمة تاريخ أو وقت.
التوقيع: subtractMonths(date, months)
مثال:
value | subtractMonths(...).
subtractYears
تطرح عدداً من السنوات من قيمة تاريخ أو وقت.
التوقيع: subtractYears(date, years)
مثال:
value | subtractYears(...).
timestamp
تحول قيمة التاريخ إلى طابع زمني بالمللي ثانية.
التوقيع: timestamp(date)
مثال:
value | timestamp(...).
toIsoDate
تحول التاريخ إلى تمثيل نصي بصيغة ISO.
التوقيع: toIsoDate(date)
مثال:
value | toIsoDate(...).
weekOfYear
تعيد رقم الأسبوع ضمن السنة.
التوقيع: weekOfYear(date)
مثال:
value | weekOfYear(...).
year
تعيد السنة من قيمة التاريخ.
التوقيع: year(date)
مثال:
value | year(...).
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
