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

differenceInDays

تفاوت تعداد روزهای تقویمی بین دو تاریخ را با مقایسه آن‌ها در ابتدای روز مربوط به خودشان محاسبه می‌کند.

differenceInDays(dateLeft, dateRight):number

پارامترها

dateLeftDateالزامی

تاریخ اول که در سمت چپ محاسبه اختلاف قرار می‌گیرد.

dateRightDateالزامی

تاریخ دوم که در سمت راست محاسبه اختلاف قرار می‌گیرد.

مقدار بازگشتی

number

تفاوت دو تاریخ بر حسب روز. مقدار مثبت یعنی dateLeft بعد از dateRight است و مقدار منفی یعنی dateLeft قبل از dateRight است.

مثال‌ها

01

استفاده پایه

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

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

const dateLeft = new Date("2026-01-10");
const dateRight = new Date("2026-01-05");

const result = differenceInDays(dateLeft, dateRight);

console.log(result);
// 5
02

تفاوت منفی

اگر dateLeft قبل از dateRight باشد، نتیجه منفی خواهد بود.

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

const dateLeft = new Date("2026-01-05");
const dateRight = new Date("2026-01-10");

const result = differenceInDays(dateLeft, dateRight);

console.log(result);
// -5
03

تاریخ یکسان

دو تاریخ که مربوط به یک روز تقویمی باشند، مقدار صفر برمی‌گردانند.

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

const dateLeft = new Date("2026-03-15");
const dateRight = new Date("2026-03-15");

const result = differenceInDays(dateLeft, dateRight);

console.log(result);
// 0
04

زمان روز نادیده گرفته می‌شود

قبل از محاسبه اختلاف، بخش زمانی هر دو تاریخ روی نیمه‌شب تنظیم می‌شود.

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

const dateLeft = new Date("2026-04-10T23:30:00");
const dateRight = new Date("2026-04-09T01:15:00");

const result = differenceInDays(dateLeft, dateRight);

console.log(result);
// 1
05

اشیای Date تغییر نمی‌کنند

تابع قبل از تغییر بخش زمانی، از هر دو تاریخ یک کپی ایجاد می‌کند و بنابراین اشیای Date اصلی تغییر نمی‌کنند.

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

const dateLeft = new Date("2026-05-10T18:30:00");
const dateRight = new Date("2026-05-05T09:15:00");

differenceInDays(dateLeft, dateRight);

console.log(dateLeft);
// 2026-05-10T18:30:00

console.log(dateRight);
// 2026-05-05T09:15:00
ساخته شده با@cyref/js·مستندات رسمی