تاریخ/از نسخه
1.38.0differenceInDays
تفاوت تعداد روزهای تقویمی بین دو تاریخ را با مقایسه آنها در ابتدای روز مربوط به خودشان محاسبه میکند.
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);
// 502
تفاوت منفی
اگر 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);
// -503
تاریخ یکسان
دو تاریخ که مربوط به یک روز تقویمی باشند، مقدار صفر برمیگردانند.
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);
// 004
زمان روز نادیده گرفته میشود
قبل از محاسبه اختلاف، بخش زمانی هر دو تاریخ روی نیمهشب تنظیم میشود.
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);
// 105
اشیای 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·مستندات رسمی