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

endOfDay

یک Date جدید ایجاد می‌کند که روی آخرین میلی‌ثانیه از روز داده‌شده تنظیم شده است.

endOfDay(date):Date

پارامترها

dateDateالزامی

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

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

Date

یک Date جدید که روی ساعت 23:59:59.999 همان روز تنظیم شده است.

مثال‌ها

01

استفاده پایه

انتهای یک روز مشخص را دریافت می‌کند.

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

const date = new Date("2026-01-15T10:30:00");

const result = endOfDay(date);

console.log(result);
// 2026-01-15T23:59:59.999
02

تاریخ بدون زمان

تابع زمان را روی آخرین میلی‌ثانیه همان روز تنظیم می‌کند.

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

const date = new Date("2026-03-20");

const result = endOfDay(date);

console.log(result);
// 2026-03-20T23:59:59.999
03

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

تابع endOfDay یک Date جدید ایجاد می‌کند، بنابراین تاریخ اصلی تغییر نمی‌کند.

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

const date = new Date("2026-05-10T14:30:00");

const result = endOfDay(date);

console.log(date);
// 2026-05-10T14:30:00

console.log(result);
// 2026-05-10T23:59:59.999
04

تاریخ در انتهای روز

زمان Date برگشتی همیشه برابر با 23:59:59.999 است.

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

const date = new Date("2026-08-25T06:45:12");

const result = endOfDay(date);

console.log(result.getHours());
// 23

console.log(result.getMinutes());
// 59

console.log(result.getSeconds());
// 59

console.log(result.getMilliseconds());
// 999
05

تاریخ از قبل در انتهای روز

اگر تاریخ از قبل در انتهای روز باشد، Date برگشتی همان مقدار تاریخ و زمان را خواهد داشت.

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

const date = new Date("2026-09-10T23:59:59.999");

const result = endOfDay(date);

console.log(result);
// 2026-09-10T23:59:59.999
ساخته شده با@cyref/js·مستندات رسمی