Function formatDateTimeForDisplay

src/utils/dateUtils.ts:1073–1122

(
	dateString: string,
	options: {
		dateFormat?: string;
		timeFormat?: string;
		showTime?: boolean;
		userTimeFormat?: "12" | "24"; // User's time format preference
	} = {}
)

 * Format a date/datetime string for display, showing time if available
 */
export function formatDateTimeForDisplay(
	dateString: string,
	options: {
		dateFormat?: string;
		timeFormat?: string;
		showTime?: boolean;
		userTimeFormat?: "12" | "24"; // User's time format preference
	} = {}
): string {
	if (!dateString) return "";

	const {
		dateFormat = "MMM d, yyyy",
		timeFormat,
		showTime = true,
		userTimeFormat = "24",
	} = options;

	// Use userTimeFormat if no specific timeFormat is provided
	const finalTimeFormat = timeFormat || (userTimeFormat === "12" ? "h:mm a" : "HH:mm");

	try {
		const parsed = parseDateToLocalInternal(dateString);
		const hasTime = hasTimeComponent(dateString);

		if (hasTime && showTime) {
			// Handle empty dateFormat case (e.g., for "Today at" scenarios)
			if (!dateFormat || dateFormat.trim() === "") {
				return format(parsed, finalTimeFormat);
			} else {
				return format(parsed, `${dateFormat} ${finalTimeFormat}`);
			}
		} else {
			// For date-only, return the dateFormat or fallback
			if (!dateFormat || dateFormat.trim() === "") {
				return ""; // Return empty for time-only requests when no time available
			} else {
				return format(parsed, dateFormat);
			}
		}
	} catch (error) {
		tasknotesLogger.error("Error formatting datetime for display:", {
			category: "validation",
			operation: "formatting-datetime-display",
			details: { dateString },
			error: error,
		});
		return dateString;
	}
}

/**
 * Time-aware comparison for before/after relationships with consistent UTC parsing