Function parseDateToUTC

src/utils/dateUtils.ts:234–310

(dateString: string)

 * @returns A Date object representing the UTC anchor for that date
 */
export function parseDateToUTC(dateString: string): Date {
	if (!dateString) {
		const error = new Error("Date string cannot be empty");
		tasknotesLogger.error("Date parsing error:", {
			category: "validation",
			operation: "date-parsing",
			details: { dateString },
			error: error.message,
		});
		throw error;
	}

	// Trim whitespace
	const trimmed = dateString.trim();

	try {
		// Handle date with day name format (e.g., "2024-01-26 Fri")
		const dateWithDayNameMatch = trimmed.match(
			/^(\d{4}-\d{2}-\d{2})\s+(Mon|Tue|Wed|Thu|Fri|Sat|Sun|Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday)$/i
		);
		if (dateWithDayNameMatch) {
			// Extract just the date part and continue with normal parsing
			const dateOnly = dateWithDayNameMatch[1];
			return parseDateToUTC(dateOnly);
		}

		// For date-only strings (YYYY-MM-DD), create a Date at UTC midnight
		const dateOnlyMatch = trimmed.match(/^(\d{4})-(\d{2})-(\d{2})$/);
		if (dateOnlyMatch) {
			const [, year, month, day] = dateOnlyMatch;
			const yearNum = parseInt(year, 10);
			const monthNum = parseInt(month, 10);
			const dayNum = parseInt(day, 10);

			// Validate date components
			if (monthNum < 1 || monthNum > 12) {
				throw new Error(`Invalid month in date: ${dateString}`);
			}

			if (dayNum < 1 || dayNum > 31) {
				throw new Error(`Invalid day in date: ${dateString}`);
			}

			// Create Date object at UTC midnight for this calendar day
			const parsed = new Date(Date.UTC(yearNum, monthNum - 1, dayNum));

			// Validate that the date didn't roll over (e.g., Feb 31 -> March 3)
			if (
				parsed.getUTCFullYear() !== yearNum ||
				parsed.getUTCMonth() !== monthNum - 1 ||
				parsed.getUTCDate() !== dayNum
			) {
				throw new Error(`Invalid date values: ${dateString}`);
			}

			return parsed;
		}