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

startOfDay

یک 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.000
02

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

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

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.000
03

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

تابع 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.000
04

بخش‌های زمانی صفر می‌شوند

ساعت، دقیقه، ثانیه و میلی‌ثانیه همگی روی صفر تنظیم می‌شوند.

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());
// 0
05

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

اگر تاریخ از قبل در ابتدای روز باشد، 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·مستندات رسمی