تاریخ/از نسخه 1.38.0

isValidDate

بررسی می‌کند که آیا یک مقدار یک شیء Date معتبر در جاوااسکریپت است یا خیر.

isValidDate(value):value is Date

پارامترها

valueunknownالزامی

مقداری که باید بررسی شود.

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

value is Date

اگر مقدار یک نمونه از Date با timestamp معتبر باشد true و در غیر این صورت false برمی‌گرداند. نوع بازگشتی همچنین به‌عنوان Type Guard در TypeScript عمل می‌کند.

مثال‌ها

استفاده پایه

بررسی می‌کند که آیا یک مقدار Date معتبر است یا خیر.

TypeScript

import { isValidDate } from "@cyref/js";

const value = new Date("2026-01-15");

const result = isValidDate(value);

console.log(result);
// true

تاریخ نامعتبر

یک شیء Date نامعتبر مقدار false برمی‌گرداند، زیرا timestamp آن برابر NaN است.

TypeScript

import { isValidDate } from "@cyref/js";

const value = new Date("invalid");

const result = isValidDate(value);

console.log(result);
// false

مقادیر غیر Date

مقادیر غیر از نمونه Date مقدار false برمی‌گردانند.

TypeScript

import { isValidDate } from "@cyref/js";

console.log(isValidDate("2026-01-15"));
// false

console.log(isValidDate(123456789));
// false

console.log(isValidDate(null));
// false

Type Guard در TypeScript

درون شرط، TypeScript مقدار را به Date محدود می‌کند.

TypeScript

import { isValidDate } from "@cyref/js";

const value: unknown = new Date("2026-05-20");

if (isValidDate(value)) {
  console.log(value.getFullYear());
  // 2026
}

شیء Date معتبر

یک شیء Date با timestamp معتبر مقدار true برمی‌گرداند.

TypeScript

import { isValidDate } from "@cyref/js";

const value = new Date("2026-08-25T12:30:00");

console.log(isValidDate(value));
// true

ساخته شده با@cyref/js·مستندات رسمی