Function parseDateToLocalInternal

src/utils/dateUtils.ts:23–221

(dateString: string)

const tasknotesLogger = createTaskNotesLogger({ tag: "Utils/DateUtils" });

function parseDateToLocalInternal(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 parseDateToLocalInternal(dateOnly);
		}

		// Handle incomplete time format (e.g., "T00:00" without date)
		if (trimmed.startsWith("T") && /^T\d{2}:\d{2}(:\d{2})?/.test(trimmed)) {
			const error = new Error(`Invalid date format - time without date: ${dateString}`);
			tasknotesLogger.warn("Date parsing error - incomplete time format:", {
				category: "validation",
				operation: "date-parsing-incomplete-time-format",
				details: { original: dateString, trimmed },
				error: error.message,
			});
			throw error;
		}

		// Handle ISO week format (e.g., "2025-W02")
		if (/^\d{4}-W\d{2}$/.test(trimmed)) {
			const [year, week] = trimmed.split("-W");
			const yearNum = parseInt(year, 10);
			const weekNum = parseInt(week, 10);

			if (isNaN(yearNum) || isNaN(weekNum)) {
				const error = new Error(`Invalid numeric values in ISO week format: ${dateString}`);
				tasknotesLogger.warn("Date parsing error - invalid ISO week numbers:", {
					category: "validation",
					operation: "date-parsing-invalid-iso-week-numbers",
					details: { original: dateString, year, week, yearNum, weekNum },
				});
				throw error;
			}

			if (weekNum < 1 || weekNum > 53) {
				const error = new Error(
					`Invalid week number in ISO week format: ${dateString} (week must be 1-53)`
				);