Function formatTimestampForDisplay

src/utils/dateUtils.ts:828–855

(
	timestampString: string,
	formatString?: string,
	timeFormat: "12" | "24" = "24"
)

 * @param timeFormat - The user's time format preference ('12' or '24')
 */
export function formatTimestampForDisplay(
	timestampString: string,
	formatString?: string,
	timeFormat: "12" | "24" = "24"
): string {
	if (!timestampString) {
		return timestampString;
	}

	try {
		const parsed = parseTimestamp(timestampString);
		if (isValid(parsed)) {
			// Use custom format if provided, otherwise use time format preference
			const finalFormat =
				formatString || (timeFormat === "12" ? "MMM d, yyyy h:mm a" : "MMM d, yyyy HH:mm");
			return format(parsed, finalFormat);
		}
		return timestampString;
	} catch (error) {
		tasknotesLogger.error("Error formatting timestamp for display:", {
			category: "validation",
			operation: "formatting-timestamp-display",
			details: { timestampString },
			error: error,
		});
		return timestampString; // Return original if formatting fails
	}
}

// ==========================================
// TIME-AWARE DATE UTILITIES