Function formatDateForStorage

src/utils/dateUtils.ts:1520–1549

(date: Date)

 * @returns YYYY-MM-DD string representing the UTC calendar date
 */
export function formatDateForStorage(date: Date): string {
	try {
		// Validate input
		if (!date || !(date instanceof Date) || isNaN(date.getTime())) {
			tasknotesLogger.warn("formatDateForStorage received invalid date:", {
				category: "validation",
				operation: "formatdateforstorage-received-invalid-date",
				details: { value: date },
			});
			return "";
		}

		// Use UTC methods to extract date components
		// This ensures the same date string regardless of user timezone
		const year = date.getUTCFullYear();
		const month = String(date.getUTCMonth() + 1).padStart(2, "0");
		const day = String(date.getUTCDate()).padStart(2, "0");

		return `${year}-${month}-${day}`;
	} catch (error) {
		tasknotesLogger.error("Error formatting date for storage:", {
			category: "validation",
			operation: "formatting-date-storage",
			details: { date },
			error: error,
		});
		// Return empty string for invalid dates rather than potentially incorrect fallback
		return "";
	}
}

/**
 * Generate UTC dates for calendar display, avoiding timezone issues