UNPKG

@gguf/claw

Version:

Multi-channel AI gateway with extensible messaging integrations

55 lines (54 loc) 2.13 kB
//#region src/infra/format-time/format-relative.ts /** * Format a duration (in ms) as a human-readable relative time. * * Input: how many milliseconds ago something happened. * * With suffix (default): "just now", "5m ago", "3h ago", "2d ago" * Without suffix: "0s", "5m", "3h", "2d" */ function formatTimeAgo(durationMs, options) { const suffix = options?.suffix !== false; const fallback = options?.fallback ?? "unknown"; if (durationMs == null || !Number.isFinite(durationMs) || durationMs < 0) return fallback; const totalSeconds = Math.round(durationMs / 1e3); const minutes = Math.round(totalSeconds / 60); if (minutes < 1) return suffix ? "just now" : `${totalSeconds}s`; if (minutes < 60) return suffix ? `${minutes}m ago` : `${minutes}m`; const hours = Math.round(minutes / 60); if (hours < 48) return suffix ? `${hours}h ago` : `${hours}h`; const days = Math.round(hours / 24); return suffix ? `${days}d ago` : `${days}d`; } /** * Format an epoch timestamp relative to now. * * Handles both past ("5m ago") and future ("in 5m") timestamps. * Optionally falls back to a short date for timestamps older than 7 days. */ function formatRelativeTimestamp(timestampMs, options) { const fallback = options?.fallback ?? "n/a"; if (timestampMs == null || !Number.isFinite(timestampMs)) return fallback; const diff = Date.now() - timestampMs; const absDiff = Math.abs(diff); const isPast = diff >= 0; const sec = Math.round(absDiff / 1e3); if (sec < 60) return isPast ? "just now" : "in <1m"; const min = Math.round(sec / 60); if (min < 60) return isPast ? `${min}m ago` : `in ${min}m`; const hr = Math.round(min / 60); if (hr < 48) return isPast ? `${hr}h ago` : `in ${hr}h`; const day = Math.round(hr / 24); if (!options?.dateFallback || day <= 7) return isPast ? `${day}d ago` : `in ${day}d`; try { return new Intl.DateTimeFormat("en-US", { month: "short", day: "numeric", ...options.timezone ? { timeZone: options.timezone } : {} }).format(new Date(timestampMs)); } catch { return `${day}d ago`; } } //#endregion export { formatTimeAgo as n, formatRelativeTimestamp as t };