تاریخ/از نسخه
1.38.0addDays
یک Date جدید ایجاد میکند و تعداد مشخصی روز به تاریخ دادهشده اضافه میکند، بدون اینکه شیء Date اصلی را تغییر دهد.
addDays(date, amount):Dateپارامترها
dateDateالزامیتاریخی که قرار است تعداد مشخصی روز به آن اضافه شود.
amountnumberالزامیتعداد روزهایی که باید به تاریخ اضافه شوند. مقادیر منفی باعث کم شدن روزها میشوند.
مقدار بازگشتی
Dateیک شیء Date جدید که تعداد مشخصی روز به آن اضافه شده است.
مثالها
01
استفاده پایه
چند روز به یک شیء Date اضافه میکند.
TypeScript
import { addDays } from "@cyref/js";
const date = new Date("2026-01-10");
const result = addDays(date, 5);
console.log(result);
// 2026-01-1502
کم کردن روزها
با استفاده از مقادیر منفی میتوان روزها را از تاریخ کم کرد.
TypeScript
import { addDays } from "@cyref/js";
const date = new Date("2026-01-10");
const result = addDays(date, -3);
console.log(result);
// 2026-01-0703
عبور از مرز ماه
تابع بهصورت خودکار تاریخهایی را که وارد ماه قبل یا بعد میشوند مدیریت میکند.
TypeScript
import { addDays } from "@cyref/js";
const date = new Date("2026-01-30");
const result = addDays(date, 3);
console.log(result);
// 2026-02-0204
تاریخ اصلی بدون تغییر باقی میماند
تابع addDays یک Date جدید ایجاد میکند، بنابراین تاریخ اصلی تغییر نمیکند.
TypeScript
import { addDays } from "@cyref/js";
const date = new Date("2026-05-10");
const result = addDays(date, 7);
console.log(date);
// 2026-05-10
console.log(result);
// 2026-05-1705
اضافه کردن صفر روز
اضافه کردن صفر روز یک Date جدید با همان مقدار تاریخ ایجاد میکند.
TypeScript
import { addDays } from "@cyref/js";
const date = new Date("2026-06-15");
const result = addDays(date, 0);
console.log(result);
// 2026-06-15ساخته شده با@cyref/js·مستندات رسمی