تاریخ/از نسخه
1.38.0startOfDay
یک Date جدید ایجاد میکند که روی اولین میلیثانیه از روز دادهشده تنظیم شده است.
startOfDay(date):Dateپارامترها
dateDateالزامیتاریخی که ابتدای روز آن باید محاسبه شود.
مقدار بازگشتی
Dateیک Date جدید که روی ساعت 00:00:00.000 همان روز تنظیم شده است.
مثالها
01
استفاده پایه
ابتدای یک روز مشخص را دریافت میکند.
TypeScript
import { startOfDay } from "@cyref/js";
const date = new Date("2026-01-15T10:30:00");
const result = startOfDay(date);
console.log(result);
// 2026-01-15T00:00:00.00002
تاریخ بدون زمان
تابع زمان را روی اولین میلیثانیه همان روز تنظیم میکند.
TypeScript
import { startOfDay } from "@cyref/js";
const date = new Date("2026-03-20");
const result = startOfDay(date);
console.log(result);
// 2026-03-20T00:00:00.00003
تاریخ اصلی بدون تغییر میماند
تابع startOfDay یک Date جدید ایجاد میکند، بنابراین تاریخ اصلی تغییر نمیکند.
TypeScript
import { startOfDay } from "@cyref/js";
const date = new Date("2026-05-10T14:30:00");
const result = startOfDay(date);
console.log(date);
// 2026-05-10T14:30:00
console.log(result);
// 2026-05-10T00:00:00.00004
بخشهای زمانی صفر میشوند
ساعت، دقیقه، ثانیه و میلیثانیه همگی روی صفر تنظیم میشوند.
TypeScript
import { startOfDay } from "@cyref/js";
const date = new Date("2026-08-25T18:45:32.500");
const result = startOfDay(date);
console.log(result.getHours());
// 0
console.log(result.getMinutes());
// 0
console.log(result.getSeconds());
// 0
console.log(result.getMilliseconds());
// 005
تاریخ از قبل در ابتدای روز
اگر تاریخ از قبل در ابتدای روز باشد، Date برگشتی همان مقدار تاریخ و زمان را خواهد داشت.
TypeScript
import { startOfDay } from "@cyref/js";
const date = new Date("2026-09-10T00:00:00.000");
const result = startOfDay(date);
console.log(result);
// 2026-09-10T00:00:00.000ساخته شده با@cyref/js·مستندات رسمی