:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import {
formatClockTime,
formatDaySeparatorLabel,
formatRelativeTimeLong,
formatRelativeTimeShort,
formatShortDayLabel,
getLocalDayDiff,
getLocalDayKey,
getRelativeDateGroup,
} from "./time";
const NOW = new Date("2026-06-15T12:00:00.000Z").getTime();
const MINUTE = 60_000;
const HOUR = 3_600_000;
const DAY = 86_400_000;
describe("formatClockTime", () => {
it.each([
["00:00", "12:00 AM"],
["08:15", "8:15 AM"],
["11:00", "11:00 AM"],
["17:30", "5:30 PM"],
])("formats %s as %s", (time, expected) => {
expect(formatClockTime(time)).toBe(expected);
});
});
beforeEach(() => {
vi.useFakeTimers();
vi.setSystemTime(NOW);
});
afterEach(() => {
vi.useRealTimers();
});
describe("formatRelativeTimeShort", () => {
it("returns 'now' for sub-minute differences", () => {
expect(formatRelativeTimeShort(NOW - 30_000)).toBe("now");
});
it.each([
[5 * MINUTE, "5m"],
[2 * HOUR, "2h"],
[3 * DAY, "3d"],
[8 * DAY, "1w"],
[35 * DAY, "1mo"],
[400 * DAY, "1y"],
])("formats a difference of %dms as %s", (ago, expected) => {
expect(formatRelativeTimeShort(NOW - ago)).toBe(expected);
});
it("accepts an ISO string timestamp", () => {
expect(
formatRelativeTimeShort(new Date(NOW - 5 * MINUTE).toISOString()),
).toBe("5m");
});
});
describe("formatRelativeTimeLong", () => {
it("returns 'just now' under a minute", () => {
expect(formatRelativeTimeLong(NOW - 30_000)).toBe("just now");
});
it("uses singular and plural minute phrasing", () => {
expect(formatRelativeTimeLong(NOW - MINUTE)).toBe("1 minute ago");
expect(formatRelativeTimeLong(NOW - 5 * MINUTE)).toBe("5 minutes ago");
});
it("uses singular and plural hour phrasing", () => {
expect(formatRelativeTimeLong(NOW - HOUR)).toBe("1 hour ago");
expect(formatRelativeTimeLong(NOW - 3 * HOUR)).toBe("3 hours ago");
});
it("uses singular and plural day phrasing within a week", () => {
expect(formatRelativeTimeLong(NOW - DAY)).toBe("1 day ago");
expect(formatRelativeTimeLong(NOW - 3 * DAY)).toBe("3 days ago");
});
it("falls back to a locale date older than a week", () => {
expect(formatRelativeTimeLong(NOW - 400 * DAY)).toContain("2025");
});
});
describe("getLocalDayDiff", () => {
it("returns 0 for any moment on the same local day", () => {
expect(getLocalDayDiff(NOW - 2 * HOUR)).toBe(0);
});
it("counts calendar days, not 24h windows", () => {
// 1h ago but across the local midnight boundary is still "yesterday".
const justAfterMidnight = new Date(NOW);
justAfterMidnight.setHours(0, 30, 0, 0);
vi.setSystemTime(justAfterMidnight);
expect(getLocalDayDiff(justAfterMidnight.getTime() - HOUR)).toBe(1);
});
it("accepts an ISO string and an explicit now", () => {
const now = new Date(NOW);
expect(getLocalDayDiff(new Date(NOW - 3 * DAY).toISOString(), now)).toBe(3);
});
it("returns negative for future days", () => {
expect(getLocalDayDiff(NOW + 2 * DAY)).toBe(-2);
});
});
describe("getRelativeDateGroup", () => {
it("returns null for today", () => {
expect(getRelativeDateGroup(NOW - 2 * HOUR)).toBeNull();
});
it("groups one calendar day back as Yesterday", () => {
expect(getRelativeDateGroup(NOW - DAY)).toBe("Yesterday");
});
it("groups a few days back as This week", () => {
expect(getRelativeDateGroup(NOW - 3 * DAY)).toBe("This week");
});
it("groups within the month as This month", () => {
expect(getRelativeDateGroup(NOW - 10 * DAY)).toBe("This month");
});
it("groups older dates as Earlier", () => {
expect(getRelativeDateGroup(NOW - 40 * DAY)).toBe("Earlier");
});
});
describe("getLocalDayKey", () => {
it("gives two times on the same local day one key", () => {
expect(getLocalDayKey(new Date(2026, 5, 15, 0, 1))).toBe(
getLocalDayKey(new Date(2026, 5, 15, 23, 59)),
);
});
it("separates adjacent days", () => {
expect(getLocalDayKey(new Date(2026, 5, 15))).not.toBe(
getLocalDayKey(new Date(2026, 5, 16)),
);
});
});
describe("formatDaySeparatorLabel", () => {
const now = new Date(2026, 5, 15, 12);
it.each([
["today", new Date(2026, 5, 15, 9), "Today"],
["yesterday", new Date(2026, 5, 14, 9), "Yesterday"],
// Within the week the weekday alone is unambiguous.
["earlier this week", new Date(2026, 5, 11), "Thursday 11th"],
// Past a week it needs the month, and past a year the year too.
["last month", new Date(2026, 4, 20), "Wednesday, May 20th"],
["last year", new Date(2025, 11, 3), "Wednesday, December 3rd, 2025"],
])("labels %s", (_case, date: Date, expected) => {
expect(formatDaySeparatorLabel(date, now)).toBe(expected);
});
it("labels a future timestamp as today rather than counting backwards", () => {
expect(formatDaySeparatorLabel(new Date(2026, 5, 16), now)).toBe("Today");
});
});
describe("formatShortDayLabel", () => {
const now = new Date(2026, 5, 15, 12);
it.each([
["today", new Date(2026, 5, 15, 9), "Today"],
["yesterday", new Date(2026, 5, 14, 9), "Yesterday"],
// Inside the week the weekday alone places it, with no date to read.
["earlier this week", new Date(2026, 5, 11), "Thursday"],
// Past the week the weekday stops narrowing it down, so it takes a date.
["last month", new Date(2026, 4, 20), "May 20"],
["last year", new Date(2025, 11, 3), "Dec 3, 2025"],
// A tomorrow — a clock skew, or a session filed in another timezone — is
// still today's news rather than a day of its own.
["a future day", new Date(2026, 5, 16), "Today"],
])("labels %s", (_case, date: Date, expected) => {
expect(formatShortDayLabel(date, now)).toBe(expected);
});
});