/**
 * Locale-aware time formatting for scheduling tool output.
 *
 * All functions are pure — no side effects, no database access.
 * Timezone is always required (IANA format). No defaults, no fallbacks.
 *
 * DATA FLOW:
 *   Neo4j (UTC ISO) --> formatCombined(iso, tz) --> MCP tool response
 *                                │
 *                        ┌───────┴───────┐
 *                        v               v
 *               formatLocaleTime   formatRelativeDelta
 *               (Intl.DateTimeFormat)  (ms arithmetic)
 */
/**
 * Validates an IANA timezone string. Throws with a clear message if invalid.
 */
export declare function validateTimezone(tz: string): void;
/**
 * Formats a UTC ISO 8601 string into a human-readable locale string.
 *
 * Example: "2026-04-03T11:00:00.000Z" + "Europe/London"
 *       → "Thursday 3 April 2026, 12:00 BST"
 */
export declare function formatLocaleTime(isoString: string, timezone: string): string;
/**
 * Computes a human-readable relative time delta.
 *
 * Returns null for dates more than 6 days away (relative deltas
 * become less useful at that distance).
 *
 * @param isoString - UTC ISO 8601 timestamp
 * @param now       - Current time (injectable for testing)
 */
export declare function formatRelativeDelta(isoString: string, now?: Date): string | null;
/**
 * Produces the full locale-formatted string with optional relative delta.
 *
 * Examples:
 *   "Thursday 3 April 2026, 12:00 BST (in 51 minutes)"
 *   "Friday 10 April 2026, 09:00 BST"  (no relative — 7+ days away)
 *
 * @param isoString - UTC ISO 8601 timestamp
 * @param timezone  - IANA timezone identifier
 * @param now       - Current time (injectable for testing)
 */
export declare function formatCombined(isoString: string, timezone: string, now?: Date): string;
//# sourceMappingURL=time-format.d.ts.map