isFuture

Signature

isFuture(value: string): boolean

import { isFuture } from "@northguild/gmt/plain/compare";

Return true when value is strictly after today, per the system clock

• and system timeZone.
• value === today returns false — “future” means strictly after, not on-or-after.
• Compares against getToday(), so this depends on the system clock and system timeZone. A caller needing determinism should use isZonedFuture with an explicit timeZone, or compare against an explicit reference with isAfterDate.
• Returns false if value is invalid or the system timeZone is unavailable.

Parameters

Parameter	Type	Description
value	string	ISO PlainDate string

Returns

true if value is after today, false on invalid input

Examples

isFuture("2024-03-16") // true, if today is 2024-03-15
isFuture("2024-03-15") // false, if today is 2024-03-15 (equal is not future)
isFuture("2024-03-14") // false, if today is 2024-03-15
isFuture("invalid") // false

Source

plain/compare/isFuture.ts