@gguf/claw
Version:
Multi-channel AI gateway with extensible messaging integrations
55 lines (54 loc) • 2.13 kB
JavaScript
//#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 };