vremel/src/datetime/compareDesc.ts

JavaScript date utility library for Temporal API

import type { Temporal } from "../types.js";
import { compare } from "./_compare.js";

/**
 * Compares two datetime objects in reverse chronological order and returns -1, 0, or 1.
 * @param a datetime object
 * @param b datetime object
 * @returns the result of the comparison
 */
export function compareDesc<
	DateTime extends
		| Temporal.Instant
		| Temporal.ZonedDateTime
		| Temporal.PlainDate
		| Temporal.PlainTime
		| Temporal.PlainDateTime
		| Temporal.PlainYearMonth,
>(a: DateTime, b: DateTime): -1 | 0 | 1 {
	return compare(b, a);
}