mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-11-20 11:06:06 +00:00
13376d560f
Road trip day tiles still wrote numeric dates from the clock setting and dates in the medium style kept the language's numbers. A poll deadline whose time was cleared was read as UTC midnight.
228 lines
11 KiB
TypeScript
228 lines
11 KiB
TypeScript
// FE-UTIL-DATEFMT-001 to FE-UTIL-DATEFMT-023
|
|
import { describe, expect, it } from 'vitest';
|
|
import {
|
|
dateFieldOrder,
|
|
dateFormatOptions,
|
|
dateLayout,
|
|
formatDisplayDate,
|
|
formatDisplayDateTime,
|
|
isNumericDate,
|
|
} from './dateFormat';
|
|
|
|
// 31 December 2026, 15:04 UTC: no day of it reads as a month, so every layout is unambiguous.
|
|
const NYE = new Date(Date.UTC(2026, 11, 31, 15, 4));
|
|
const UTC = { timeZone: 'UTC' } as const;
|
|
const NUMERIC: Intl.DateTimeFormatOptions = { day: '2-digit', month: '2-digit', year: 'numeric', timeZone: 'UTC' };
|
|
|
|
describe('dateFormat (#2971)', () => {
|
|
describe('formatDisplayDate', () => {
|
|
it('FE-UTIL-DATEFMT-001: auto, an unknown value or none is exactly toLocaleDateString', () => {
|
|
const cases: [string, Intl.DateTimeFormatOptions | undefined][] = [
|
|
['en-US', undefined],
|
|
['en-US', NUMERIC],
|
|
['de-DE', NUMERIC],
|
|
['ko-KR', { day: 'numeric', month: 'short', year: 'numeric', timeZone: 'UTC' }],
|
|
['en-GB', { day: '2-digit', month: '2-digit', year: '2-digit', timeZone: 'UTC' }],
|
|
];
|
|
for (const [locale, opts] of cases) {
|
|
const expected = NYE.toLocaleDateString(locale, opts);
|
|
expect(formatDisplayDate(NYE, locale, opts, 'auto')).toBe(expected);
|
|
expect(formatDisplayDate(NYE, locale, opts, 'DD-MM-YY')).toBe(expected);
|
|
expect(formatDisplayDate(NYE, locale, opts, null)).toBe(expected);
|
|
expect(formatDisplayDate(NYE, locale, opts)).toBe(expected);
|
|
}
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-002: each format writes 31 December 2026 in its own layout', () => {
|
|
expect(formatDisplayDate(NYE, 'en-US', UTC, 'YYYY-MM-DD')).toBe('2026-12-31');
|
|
expect(formatDisplayDate(NYE, 'en-US', UTC, 'YYYY/MM/DD')).toBe('2026/12/31');
|
|
expect(formatDisplayDate(NYE, 'en-US', UTC, 'DD.MM.YYYY')).toBe('31.12.2026');
|
|
expect(formatDisplayDate(NYE, 'en-US', UTC, 'DD/MM/YYYY')).toBe('31/12/2026');
|
|
expect(formatDisplayDate(NYE, 'de-DE', UTC, 'MM/DD/YYYY')).toBe('12/31/2026');
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-003: the language does not change a chosen format', () => {
|
|
for (const locale of ['en-US', 'de-DE', 'ko-KR', 'ar', 'fr-FR']) {
|
|
expect(formatDisplayDate(NYE, locale, NUMERIC, 'YYYY-MM-DD')).toBe('2026-12-31');
|
|
}
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-004: single-digit days and months are padded', () => {
|
|
const march = new Date(Date.UTC(2026, 2, 5));
|
|
expect(
|
|
formatDisplayDate(
|
|
march,
|
|
'en-US',
|
|
{ day: 'numeric', month: 'numeric', year: 'numeric', timeZone: 'UTC' },
|
|
'DD.MM.YYYY'
|
|
)
|
|
).toBe('05.03.2026');
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-005: year 2-digit keeps two digits of the year', () => {
|
|
const opts: Intl.DateTimeFormatOptions = { day: '2-digit', month: '2-digit', year: '2-digit', timeZone: 'UTC' };
|
|
expect(formatDisplayDate(NYE, 'en-US', opts, 'DD.MM.YYYY')).toBe('31.12.26');
|
|
expect(formatDisplayDate(NYE, 'en-US', opts, 'YYYY-MM-DD')).toBe('26-12-31');
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-006: day and month without a year write only those two, in layout order', () => {
|
|
const opts: Intl.DateTimeFormatOptions = { day: 'numeric', month: 'numeric', timeZone: 'UTC' };
|
|
expect(formatDisplayDate(NYE, 'en-US', opts, 'DD.MM.YYYY')).toBe('31.12');
|
|
expect(formatDisplayDate(NYE, 'en-US', opts, 'YYYY-MM-DD')).toBe('12-31');
|
|
expect(formatDisplayDate(NYE, 'en-US', opts, 'MM/DD/YYYY')).toBe('12/31');
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-007: a month name or a long dateStyle is left to Intl', () => {
|
|
const named: Intl.DateTimeFormatOptions[] = [
|
|
{ weekday: 'short', day: 'numeric', month: 'short', timeZone: 'UTC' },
|
|
{ day: 'numeric', month: 'short', year: 'numeric', timeZone: 'UTC' },
|
|
{ month: 'long', year: 'numeric', timeZone: 'UTC' },
|
|
{ dateStyle: 'long', timeZone: 'UTC' },
|
|
{ dateStyle: 'full', timeZone: 'UTC' },
|
|
];
|
|
for (const opts of named) {
|
|
expect(formatDisplayDate(NYE, 'de-DE', opts, 'YYYY-MM-DD')).toBe(NYE.toLocaleDateString('de-DE', opts));
|
|
}
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-022: dateStyle medium follows the format where the language writes it in numbers', () => {
|
|
const opts: Intl.DateTimeFormatOptions = { dateStyle: 'medium', timeZone: 'UTC' };
|
|
// German "31.12.2026", Japanese "2026/12/31", Czech "31. 12. 2026", Korean "2026. 12. 31.".
|
|
for (const locale of ['de-DE', 'ja-JP', 'cs-CZ', 'ko-KR']) {
|
|
expect(formatDisplayDate(NYE, locale, opts, 'YYYY-MM-DD')).toBe('2026-12-31');
|
|
}
|
|
// English and French name the month, Chinese writes words between the numbers.
|
|
for (const locale of ['en-US', 'fr-FR', 'zh-CN']) {
|
|
expect(formatDisplayDate(NYE, locale, opts, 'YYYY-MM-DD')).toBe(NYE.toLocaleDateString(locale, opts));
|
|
}
|
|
expect(formatDisplayDate(NYE, 'de-DE', opts, 'auto')).toBe(NYE.toLocaleDateString('de-DE', opts));
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-021: a weekday beside a numeric date keeps the language, the date takes the format', () => {
|
|
const opts: Intl.DateTimeFormatOptions = {
|
|
weekday: 'short',
|
|
day: '2-digit',
|
|
month: '2-digit',
|
|
year: 'numeric',
|
|
timeZone: 'UTC',
|
|
};
|
|
expect(formatDisplayDate(NYE, 'de-DE', opts, 'YYYY-MM-DD')).toBe(
|
|
`${NYE.toLocaleDateString('de-DE', { weekday: 'short', timeZone: 'UTC' })}, 2026-12-31`
|
|
);
|
|
expect(formatDisplayDate(NYE, 'de-DE', opts, 'auto')).toBe(NYE.toLocaleDateString('de-DE', opts));
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-008: dateStyle short counts as numeric', () => {
|
|
expect(formatDisplayDate(NYE, 'en-US', { dateStyle: 'short', timeZone: 'UTC' }, 'DD/MM/YYYY')).toBe('31/12/2026');
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-009: an invalid date falls back to toLocaleDateString', () => {
|
|
const invalid = new Date('nope');
|
|
expect(formatDisplayDate(invalid, 'en-US', NUMERIC, 'YYYY-MM-DD')).toBe(
|
|
invalid.toLocaleDateString('en-US', NUMERIC)
|
|
);
|
|
});
|
|
});
|
|
|
|
describe('formatDisplayDateTime', () => {
|
|
it('FE-UTIL-DATEFMT-010: auto, an unknown value or none is exactly toLocaleString', () => {
|
|
const opts: Intl.DateTimeFormatOptions = { ...NUMERIC, hour: '2-digit', minute: '2-digit' };
|
|
for (const locale of ['en-US', 'de-DE']) {
|
|
expect(formatDisplayDateTime(NYE, locale, opts, 'auto')).toBe(NYE.toLocaleString(locale, opts));
|
|
expect(formatDisplayDateTime(NYE, locale, opts, 'nope')).toBe(NYE.toLocaleString(locale, opts));
|
|
expect(formatDisplayDateTime(NYE, locale, UTC)).toBe(NYE.toLocaleString(locale, UTC));
|
|
}
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-011: the date follows the format, the time of day stays Intl', () => {
|
|
const opts: Intl.DateTimeFormatOptions = { ...NUMERIC, hour: '2-digit', minute: '2-digit' };
|
|
const time = NYE.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', timeZone: 'UTC' });
|
|
expect(formatDisplayDateTime(NYE, 'en-US', opts, 'YYYY-MM-DD')).toBe(`2026-12-31 ${time}`);
|
|
const hour12 = { ...opts, hour12: false };
|
|
const time24 = NYE.toLocaleTimeString('en-US', {
|
|
hour: '2-digit',
|
|
minute: '2-digit',
|
|
hour12: false,
|
|
timeZone: 'UTC',
|
|
});
|
|
expect(formatDisplayDateTime(NYE, 'en-US', hour12, 'DD.MM.YYYY')).toBe(`31.12.2026 ${time24}`);
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-012: without options it writes the date and the default time', () => {
|
|
expect(formatDisplayDateTime(NYE, 'en-US', UTC, 'DD/MM/YYYY')).toBe(
|
|
`31/12/2026 ${NYE.toLocaleTimeString('en-US', UTC)}`
|
|
);
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-013: time-only options are passed through untouched', () => {
|
|
const opts: Intl.DateTimeFormatOptions = { hour: '2-digit', minute: '2-digit', timeZone: 'UTC' };
|
|
expect(formatDisplayDateTime(NYE, 'de-DE', opts, 'YYYY-MM-DD')).toBe(NYE.toLocaleString('de-DE', opts));
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-014: date-only options give just the date, named dates stay Intl', () => {
|
|
expect(formatDisplayDateTime(NYE, 'en-US', NUMERIC, 'YYYY/MM/DD')).toBe('2026/12/31');
|
|
const named: Intl.DateTimeFormatOptions = {
|
|
weekday: 'short',
|
|
day: 'numeric',
|
|
month: 'short',
|
|
hour: '2-digit',
|
|
timeZone: 'UTC',
|
|
};
|
|
expect(formatDisplayDateTime(NYE, 'en-US', named, 'YYYY-MM-DD')).toBe(NYE.toLocaleString('en-US', named));
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-023: dateStyle medium with a time puts the numeric date in the format', () => {
|
|
const opts: Intl.DateTimeFormatOptions = { dateStyle: 'medium', timeStyle: 'short', timeZone: 'UTC' };
|
|
const time = NYE.toLocaleTimeString('de-DE', { timeStyle: 'short', timeZone: 'UTC' });
|
|
expect(formatDisplayDateTime(NYE, 'de-DE', opts, 'DD/MM/YYYY')).toBe(`31/12/2026 ${time}`);
|
|
expect(formatDisplayDateTime(NYE, 'en-US', opts, 'DD/MM/YYYY')).toBe(NYE.toLocaleString('en-US', opts));
|
|
});
|
|
});
|
|
|
|
describe('dateFieldOrder, dateLayout and isNumericDate', () => {
|
|
it('FE-UTIL-DATEFMT-018: a chosen format sets the order, auto asks the language', () => {
|
|
expect(dateFieldOrder('en-US', 'DD.MM.YYYY')).toEqual(['day', 'month', 'year']);
|
|
expect(dateFieldOrder('de-DE', 'MM/DD/YYYY')).toEqual(['month', 'day', 'year']);
|
|
expect(dateFieldOrder('en-US', 'YYYY/MM/DD')).toEqual(['year', 'month', 'day']);
|
|
expect(dateFieldOrder('de-DE', 'auto')).toEqual(['day', 'month', 'year']);
|
|
expect(dateFieldOrder('en-US')).toEqual(['month', 'day', 'year']);
|
|
expect(dateFieldOrder('ko-KR', null)).toEqual(['year', 'month', 'day']);
|
|
});
|
|
|
|
it('FE-UTIL-DATEFMT-019: dateLayout knows the five formats only, isNumericDate spots names', () => {
|
|
expect(dateLayout('DD/MM/YYYY')).toEqual({ order: ['day', 'month', 'year'], separator: '/' });
|
|
expect(dateLayout('auto')).toBeNull();
|
|
expect(dateLayout('nope')).toBeNull();
|
|
expect(dateLayout(undefined)).toBeNull();
|
|
expect(isNumericDate()).toBe(true);
|
|
expect(isNumericDate({ month: '2-digit' })).toBe(true);
|
|
expect(isNumericDate({ month: 'short' })).toBe(false);
|
|
expect(isNumericDate({ weekday: 'long' })).toBe(false);
|
|
expect(isNumericDate({ era: 'short' })).toBe(false);
|
|
expect(isNumericDate({ dateStyle: 'short' })).toBe(true);
|
|
expect(isNumericDate({ dateStyle: 'long' })).toBe(false);
|
|
expect(isNumericDate({ dateStyle: 'medium' }, 'de-DE')).toBe(true);
|
|
expect(isNumericDate({ dateStyle: 'medium' }, 'ja-JP')).toBe(true);
|
|
expect(isNumericDate({ dateStyle: 'medium' }, 'en-US')).toBe(false);
|
|
expect(isNumericDate({ dateStyle: 'long' }, 'de-DE')).toBe(false);
|
|
});
|
|
});
|
|
|
|
describe('dateFormatOptions', () => {
|
|
it('FE-UTIL-DATEFMT-020: every choice is labelled by how it writes 31 December, auto with its example', () => {
|
|
expect(dateFormatOptions('en-US', 'Automatic')).toEqual([
|
|
{ value: 'auto', label: 'Automatic (12/31/2026)' },
|
|
{ value: 'YYYY-MM-DD', label: '2026-12-31' },
|
|
{ value: 'YYYY/MM/DD', label: '2026/12/31' },
|
|
{ value: 'DD.MM.YYYY', label: '31.12.2026' },
|
|
{ value: 'DD/MM/YYYY', label: '31/12/2026' },
|
|
{ value: 'MM/DD/YYYY', label: '12/31/2026' },
|
|
]);
|
|
expect(dateFormatOptions('de-DE', 'Automatisch')[0]).toEqual({
|
|
value: 'auto',
|
|
label: 'Automatisch (31.12.2026)',
|
|
});
|
|
});
|
|
});
|
|
});
|