CyrefJS
CCyrefJS
EN
بازگشت به مستندات
تاریخ/از نسخه 1.38.0

addDays

یک 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-15
02

کم کردن روزها

با استفاده از مقادیر منفی می‌توان روزها را از تاریخ کم کرد.

TypeScript
import { addDays } from "@cyref/js";

const date = new Date("2026-01-10");

const result = addDays(date, -3);

console.log(result);
// 2026-01-07
03

عبور از مرز ماه

تابع به‌صورت خودکار تاریخ‌هایی را که وارد ماه قبل یا بعد می‌شوند مدیریت می‌کند.

TypeScript
import { addDays } from "@cyref/js";

const date = new Date("2026-01-30");

const result = addDays(date, 3);

console.log(result);
// 2026-02-02
04

تاریخ اصلی بدون تغییر باقی می‌ماند

تابع 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-17
05

اضافه کردن صفر روز

اضافه کردن صفر روز یک 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·مستندات رسمی