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

isBefore

بررسی می‌کند که آیا تاریخ اول قبل از تاریخ دوم قرار دارد یا خیر.

isBefore(dateLeft, dateRight):boolean

پارامترها

dateLeftDateالزامی

تاریخی که به‌عنوان مقدار اول برای مقایسه استفاده می‌شود.

dateRightDateالزامی

تاریخی که dateLeft با آن مقایسه می‌شود.

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

boolean

اگر dateLeft قبل از dateRight باشد true و در غیر این صورت false برمی‌گرداند.

مثال‌ها

01

استفاده پایه

بررسی می‌کند که آیا یک تاریخ قبل از تاریخ دیگر است یا خیر.

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

const dateLeft = new Date("2026-01-05");
const dateRight = new Date("2026-01-10");

const result = isBefore(dateLeft, dateRight);

console.log(result);
// true
02

تاریخ قبل از تاریخ دیگر نیست

اگر dateLeft بعد از dateRight باشد، مقدار false برمی‌گرداند.

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

const dateLeft = new Date("2026-01-10");
const dateRight = new Date("2026-01-05");

const result = isBefore(dateLeft, dateRight);

console.log(result);
// false
03

تاریخ‌های برابر

برای تاریخ‌های برابر مقدار false برمی‌گردد، زیرا تابع فقط قبل‌تر بودن را بررسی می‌کند.

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

const dateLeft = new Date("2026-03-15T12:00:00");
const dateRight = new Date("2026-03-15T12:00:00");

const result = isBefore(dateLeft, dateRight);

console.log(result);
// false
04

زمان نیز در مقایسه در نظر گرفته می‌شود

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

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

const dateLeft = new Date("2026-06-10T09:30:00");
const dateRight = new Date("2026-06-10T15:30:00");

const result = isBefore(dateLeft, dateRight);

console.log(result);
// true
05

یک روز، زمان متفاوت

دو تاریخ در یک روز تقویمی می‌توانند بر اساس زمان خود نتیجه متفاوتی داشته باشند.

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

const morning = new Date("2026-08-20T09:00:00");
const evening = new Date("2026-08-20T18:00:00");

console.log(isBefore(morning, evening));
// true

console.log(isBefore(evening, morning));
// false
ساخته شده با@cyref/js·مستندات رسمی