Function isBeforeDateTimeAware

src/utils/dateUtils.ts:1128–1180

(date1: string, date2: string)

 * Uses UTC anchoring for all date-only strings to ensure timezone-independent comparisons
 */
export function isBeforeDateTimeAware(date1: string, date2: string): boolean {
	try {
		// Step 1: Parse all dates to UTC anchors for consistency
		const d1UTC = parseDateToUTC(date1);
		const d2UTC = parseDateToUTC(date2);

		// Step 2: For datetime strings, add time component to UTC anchor
		let d1Final = d1UTC;
		let d2Final = d2UTC;

		if (hasTimeComponent(date1)) {
			// Extract time and apply it to UTC anchor
			const timeInfo = getTimePart(date1);
			if (timeInfo) {
				const [hours, minutes] = timeInfo.split(":").map(Number);
				d1Final = new Date(d1UTC);
				d1Final.setUTCHours(hours, minutes, 0, 0);
			}
		}

		if (hasTimeComponent(date2)) {
			// Extract time and apply it to UTC anchor
			const timeInfo = getTimePart(date2);
			if (timeInfo) {
				const [hours, minutes] = timeInfo.split(":").map(Number);
				d2Final = new Date(d2UTC);
				d2Final.setUTCHours(hours, minutes, 0, 0);
			}
		}

		// Step 3: Handle mixed case by treating date-only as end-of-day
		if (hasTimeComponent(date1) && !hasTimeComponent(date2)) {
			// date2 is date-only, treat as end of day for sorting
			d2Final = new Date(d2UTC);
			d2Final.setUTCHours(23, 59, 59, 999);
		} else if (!hasTimeComponent(date1) && hasTimeComponent(date2)) {
			// date1 is date-only, treat as end of day for sorting
			d1Final = new Date(d1UTC);
			d1Final.setUTCHours(23, 59, 59, 999);
		}

		// Step 4: Direct comparison with consistent UTC timestamps
		return d1Final.getTime() < d2Final.getTime();
	} catch (error) {
		tasknotesLogger.error("Error comparing dates time-aware:", {
			category: "validation",
			operation: "comparing-dates-time-aware",
			details: { date1, date2 },
			error: error,
		});
		return false;
	}
}

/**
 * Check if a date/datetime is overdue (past current date/time)