Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

2.3 KB
Raw Blame
/**
 * Shared locale-aware time helpers for sidebar / session lists.
 *
 * Two pieces:
 *
 * 1. `getDayGroupKey(ts)` — returns a stable token (`today` / `this_week` /
 *    `earlier`) for grouping: three buckets, so a list reads as "now, lately,
 *    a while ago" rather than a calendar. Callers map that token to a
 *    translated label via i18next so the same grouping logic works across
 *    locales.
 *
 * 2. `formatRelativeTime(ts, locale)` — wraps `Intl.RelativeTimeFormat` with
 *    the caller's active locale instead of the previously-hardcoded `"en"`.
 *    Falls back to `"en"` on unsupported locales to match Intl's own
 *    behaviour rather than throwing.
 */

export type DayGroupKey = "today" | "this_week" | "earlier";

export function getDayGroupKey(timestamp: number): DayGroupKey {
  const now = new Date();
  const date = new Date(timestamp * 1000);
  // Compare local calendar dates on a uniform UTC axis: a local day can
  // contain 23 or 25 hours when daylight-saving time changes.
  const startOfToday = Date.UTC(
    now.getFullYear(),
    now.getMonth(),
    now.getDate(),
  );
  const startOfItemDay = Date.UTC(
    date.getFullYear(),
    date.getMonth(),
    date.getDate(),
  );
  const diffDays = Math.floor((startOfToday - startOfItemDay) / 86400000);
  if (diffDays <= 0) return "today";
  if (diffDays < 7) return "this_week";
  return "earlier";
}

export function formatRelativeTime(timestamp: number, locale: string): string {
  const diffSeconds = Math.round(timestamp - Date.now() / 1000);
  const formatter = new Intl.RelativeTimeFormat(locale || "en", {
    numeric: "auto",
  });
  const abs = Math.abs(diffSeconds);
  if (abs < 60) return formatter.format(diffSeconds, "second");
  if (abs < 3600)
    return formatter.format(Math.round(diffSeconds / 60), "minute");
  if (abs < 86400)
    return formatter.format(Math.round(diffSeconds / 3600), "hour");
  if (abs < 604800)
    return formatter.format(Math.round(diffSeconds / 86400), "day");
  // Past a week, days stop being readable — "31 days ago" is worse than
  // "last month". Intl handles the plural and the wording per locale.
  if (abs < 2592000)
    return formatter.format(Math.round(diffSeconds / 604800), "week");
  if (abs < 31536000)
    return formatter.format(Math.round(diffSeconds / 2592000), "month");
  return formatter.format(Math.round(diffSeconds / 31536000), "year");
}