تاریخ/از نسخه
1.38.0endOfDay
یک 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.99902
تاریخ بدون زمان
تابع زمان را روی آخرین میلیثانیه همان روز تنظیم میکند.
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.99903
تاریخ اصلی بدون تغییر میماند
تابع 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.99904
تاریخ در انتهای روز
زمان 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());
// 99905
تاریخ از قبل در انتهای روز
اگر تاریخ از قبل در انتهای روز باشد، 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·مستندات رسمی