@burglekitt/gmt
Version:
Temporal-based date and time utilities with timezone support and polyfill integration
25 lines (24 loc) • 1.02 kB
TypeScript
/**
* Return true if `value1` and `value2` form a valid time range — both parseable as
* ISO PlainTime strings and `value1 <= value2`.
*
* - Both inputs must be ISO 8601 time strings (e.g. `"14:30:00"`).
* - Equal `value1 === value2` is valid when `options.allowEqual` is true.
* - Invalid input, malformed strings, or leap-second strings return `false`.
*
* @param value1 first ISO PlainTime string
* @param value2 second ISO PlainTime string
* @param options optional allowEqual flag
* @returns boolean indicating whether the time range is valid
*
* @example isValidTimeRange({ value1: "09:00:00", value2: "17:00:00" }) // true
* @example isValidTimeRange({ value1: "17:00:00", value2: "09:00:00" }) // false
* @example isValidTimeRange({ value1: "12:00:00", value2: "12:00:00", options: { allowEqual: true } }) // true
*/
export declare function isValidTimeRange({ value1, value2, options, }: {
value1: string;
value2: string;
options?: {
allowEqual?: boolean;
};
}): boolean;