إنتقل إلى المحتوى الرئيسي

DateTime():add()

يضيف مقدارًا محددًا من الوقت إلى كائن DateTime.

التوقيع

add(amount: number, unit: string)

المعاملات

المعاملالنوعالوصف
amountintالمقدار المطلوب إضافته.
unitStringوحدة الوقت المطلوب إضافته. تشمل الوحدات المدعومة: years، year، months، month، weeks، week، days، day، hours، hour، minutes، minute، seconds، second، milliseconds، millisecond.

القيمة المعادة

  • النوع: IDateTime
  • نسخة DateTime الحالية، مما يسمح بتسلسل الاستدعاءات.

أمثلة

local now = DateTime()
-- Add 5 days
now:add(5, "days")
toast("Date after adding 5 days: " .. now:format("yyyy-MM-dd"))

-- Add 2 months
now = DateTime() -- Reset
now:add(2, "months")
toast("Date after adding 2 months: " .. now:format("yyyy-MM-dd"))