shared/utils/date.test.ts
Rama main · réplica de lectura del repositorio original.
import {
dateRangeToReadable,
dateToReadable,
dateToRelativeReadable,
dateToTimestamp,
hasTimeComponent,
parseISODate,
toISODate,
toISODateTime,
} from "./date";
describe("toISODate / parseISODate", () => {
it("round-trips a date through its ISO representation", () => {
const date = new Date(2024, 1, 3); // Feb 3, 2024
const iso = toISODate(date);
expect(iso).toBe("2024-02-03");
expect(parseISODate(iso)).toEqual(date);
});
it("returns null for an invalid ISO string", () => {
expect(parseISODate("not-a-date")).toBeNull();
});
it("rejects strings carrying seconds or a timezone", () => {
expect(parseISODate("2024-02-03T10:00:00Z")).toBeNull();
expect(parseISODate("2024-02-03T10:00:00")).toBeNull();
});
it("parses a date-only string to local midnight", () => {
const date = parseISODate("2024-02-03");
expect(date?.getHours()).toBe(0);
expect(date?.getMinutes()).toBe(0);
});
});
describe("toISODateTime / hasTimeComponent", () => {
it("round-trips a date and time through its ISO representation", () => {
const date = new Date(2024, 1, 3, 13, 5); // Feb 3, 2024 at 1:05pm
const iso = toISODateTime(date);
expect(iso).toBe("2024-02-03T13:05");
expect(parseISODate(iso)).toEqual(date);
});
it("detects whether a value is time-specific", () => {
expect(hasTimeComponent("2024-02-03T13:05")).toBe(true);
expect(hasTimeComponent("2024-02-03")).toBe(false);
expect(hasTimeComponent("nonsense")).toBe(false);
});
});
// ICU builds differ in where they emit no-break spaces, e.g. before the day
// period or a year suffix, so locale output is compared on regular spaces.
const normalize = (value: string) => value.replace(/[\u00a0\u202f]/g, " ");
describe("dateToReadable", () => {
it("includes the year outside the current year", () => {
expect(normalize(dateToReadable("2020-02-03"))).toBe("February 3, 2020");
});
it("omits the year within the current year", () => {
const date = new Date();
date.setMonth(date.getMonth() === 0 ? 6 : 0);
date.setDate(15);
const result = dateToReadable(toISODate(date));
expect(result).not.toContain(`${date.getFullYear()}`);
});
it("returns the original string when invalid", () => {
expect(dateToReadable("nonsense")).toBe("nonsense");
});
it("appends the time when the value is time-specific", () => {
expect(normalize(dateToReadable("2020-02-03T13:00"))).toBe(
"February 3, 2020 at 1:00 PM"
);
});
it("follows the word order of the locale", () => {
expect(normalize(dateToReadable("2020-02-03", "de_DE"))).toBe(
"3. Februar 2020"
);
expect(normalize(dateToReadable("2020-02-03", "fr_FR"))).toBe(
"3 février 2020"
);
expect(normalize(dateToReadable("2020-02-03", "ja_JP"))).toBe(
"2020年2月3日"
);
});
it("uses the clock convention of the locale", () => {
expect(normalize(dateToReadable("2020-02-03T13:00", "de_DE"))).toBe(
"3. Februar 2020 um 13:00"
);
});
it("separates the time using the locale's own connector", () => {
expect(dateToReadable("2020-02-03T13:00", "de_DE")).toContain(" um ");
expect(dateToReadable("2020-02-03T13:00", "ja_JP")).not.toContain(" at ");
});
it("keeps the date's own suffix out of the separator", () => {
// Ukrainian places "р." (an abbreviation of "року") after the year, which
// must not be mistaken for part of the separator.
expect(normalize(dateToReadable("2020-02-03T13:00", "uk_UA"))).toBe(
"3 лютого 2020 р. о 13:00"
);
const today = new Date();
today.setHours(13, 0);
const t = (key: string) => key;
expect(
normalize(dateToRelativeReadable(toISODateTime(today), t, "uk_UA"))
).toBe("Today о 13:00");
});
});
describe("dateToRelativeReadable", () => {
const t = (key: string) => key;
it("returns Today for the current date", () => {
const iso = toISODate(new Date());
expect(normalize(dateToRelativeReadable(iso, t))).toBe("Today");
});
it("returns Tomorrow for the next day", () => {
const tomorrow = new Date();
tomorrow.setDate(tomorrow.getDate() + 1);
expect(normalize(dateToRelativeReadable(toISODate(tomorrow), t))).toBe(
"Tomorrow"
);
});
it("returns Yesterday for the previous day", () => {
const yesterday = new Date();
yesterday.setDate(yesterday.getDate() - 1);
expect(normalize(dateToRelativeReadable(toISODate(yesterday), t))).toBe(
"Yesterday"
);
});
it("omits the year within the current year", () => {
const date = new Date();
date.setMonth(date.getMonth() === 0 ? 6 : 0); // a different month, same year
date.setDate(15);
const result = dateToRelativeReadable(toISODate(date), t);
expect(result).not.toContain(`${date.getFullYear()}`);
});
it("includes the year for a date in a different year", () => {
expect(normalize(dateToRelativeReadable("2020-02-03", t))).toBe(
"February 3, 2020"
);
});
it("appends the time when the value is time-specific", () => {
const today = new Date();
today.setHours(13, 0);
expect(normalize(dateToRelativeReadable(toISODateTime(today), t))).toBe(
"Today at 1:00 PM"
);
expect(normalize(dateToRelativeReadable("2020-02-03T13:00", t))).toBe(
"February 3, 2020 at 1:00 PM"
);
});
it("joins the relative label and time with the locale's connector", () => {
const today = new Date();
today.setHours(13, 0);
expect(
normalize(dateToRelativeReadable(toISODateTime(today), t, "de_DE"))
).toBe("Today um 13:00");
});
});
describe("dateToTimestamp", () => {
const iso = new Date(2026, 10, 5, 19, 48, 12).toISOString();
it("includes the year and seconds", () => {
const result = dateToTimestamp(iso, "en_US");
expect(result).toContain("Nov 5, 2026");
expect(result).toMatch(/7:48:12\sPM/);
});
it("follows the word order and hour cycle of the language", () => {
const german = dateToTimestamp(iso, "de_DE");
expect(german).toContain("05.11.2026");
expect(german).toContain("19:48:12");
const british = dateToTimestamp(iso, "en_GB");
expect(british).toContain("5 Nov 2026");
expect(british).toContain("19:48:12");
});
it("includes the time zone", () => {
const zone = new Intl.DateTimeFormat("en-US", { timeZoneName: "short" })
.formatToParts(new Date(iso))
.find((part) => part.type === "timeZoneName")?.value;
expect(dateToTimestamp(iso, "en_US")).toContain(zone);
});
it("falls back to English without a language", () => {
expect(dateToTimestamp(iso)).toEqual(dateToTimestamp(iso, "en_US"));
});
it("returns the original string when invalid", () => {
expect(dateToTimestamp("not a date", "en_US")).toEqual("not a date");
});
});
describe("dateRangeToReadable", () => {
const start = new Date(2026, 10, 2);
const end = new Date(2026, 10, 3);
it("collapses the parts shared between the dates", () => {
expect(dateRangeToReadable(start, end, "en_US")).toMatch(
/^Nov 2\s–\s3, 2026$/
);
});
it("follows the language", () => {
expect(dateRangeToReadable(start, end, "de_DE")).toContain("2026");
expect(dateRangeToReadable(start, end, "de_DE")).toContain("03.11");
});
it("uses a single date for the same day", () => {
expect(dateRangeToReadable(start, start, "en_US")).toEqual("Nov 2, 2026");
});
it("uses a single date when only one bound is set", () => {
expect(dateRangeToReadable(start, null, "en_US")).toEqual("Nov 2, 2026");
expect(dateRangeToReadable(null, end, "en_US")).toEqual("Nov 3, 2026");
});
it("is empty without bounds", () => {
expect(dateRangeToReadable(null, null, "en_US")).toEqual("");
});
});