snapshot of https://github.com/RocketChat/Rocket.Chat.git (develop, 2026-09-16; blobs > 131072B omitted)

apps/meteor/client/lib/utils/dateFormat.ts

@@ -0,0 +1,262 @@
+import { format, formatDistanceToNow, formatDuration, intervalToDuration, differenceInCalendarDays, parse } from 'date-fns';
+import type { Locale } from 'date-fns';
+
+export type DateInput = string | Date | number;
+
+const FALLBACK_FORMAT = 'PPP p'; // date-fns equivalent of moment's LLL
+
+const MOMENT_TO_DATE_FNS_TOKENS: ReadonlyArray<readonly [moment: string, dateFns: string]> = (
+	[
+		// Locale formats
+		['LLLL', 'EEEE, PPP p'],
+		['LTS', 'pp'],
+		['LLL', 'PPP p'],
+		['LL', 'PPP'],
+		['LT', 'p'],
+		['L', 'P'],
+		// Locale formats — short variants (Moment lowercase l = no zero-padding;
+		// date-fns has no equivalent without zero-padding, so PP/P is the closest match)
+		['llll', 'EEE, PP p'],
+		['lll', 'PP p'],
+		['ll', 'PP'],
+		['l', 'P'],
+		// Year
+		['YYYYYY', 'yyyyyy'], // 6-digit padded; Moment includes a +/- sign that date-fns omits
+		['YYYY', 'yyyy'],
+		['YY', 'yy'],
+		['Y', 'yyyy'],
+		['y', 'y'], // Moment lowercase y = era year (always positive); equivalent to calendar year for AD dates
+		// Era — Moment N/NN/NNN are abbreviated, NNNN wide, NNNNN narrow
+		['NNNNN', 'GGGGG'],
+		['NNNN', 'GGGG'],
+		['NNN', 'GGG'],
+		['NN', 'GG'],
+		['N', 'G'],
+		// Month
+		['MMMM', 'MMMM'],
+		['MMM', 'MMM'],
+		['MM', 'MM'],
+		['Mo', 'Mo'],
+		['M', 'M'],
+		// Day of month
+		['Do', 'do'],
+		['DD', 'dd'],
+		['D', 'd'],
+		// Day of year — needs `useAdditionalDayOfYearTokens` on date-fns
+		['DDDD', 'DDD'],
+		['DDDo', 'Do'],
+		['DDD', 'D'],
+		// Day of week
+		['dddd', 'EEEE'],
+		['ddd', 'EEE'],
+		['dd', 'EEEEEE'],
+		// Numeric day of week — semantics shift: Moment d/e produce 0-6 (Sun=0),
+		// date-fns i/c produce 1-7. No exact equivalent exists.
+		['do', 'io'],
+		['d', 'i'],
+		['e', 'c'],
+		// ISO week of year
+		['WW', 'II'],
+		['Wo', 'Io'],
+		['W', 'I'],
+		// Week-numbering year — Moment gg/gggg = locale, GG/GGGG = ISO.
+		// date-fns Y/YY/YYYY (locale) requires `useAdditionalWeekYearTokens`.
+		['gggg', 'YYYY'],
+		['gg', 'YY'],
+		['GGGG', 'RRRR'],
+		['GG', 'RR'],
+		// Hour (H = 0-23, h = 1-12, k = 1-24)
+		['HH', 'HH'],
+		['H', 'H'],
+		['hh', 'hh'],
+		['h', 'h'],
+		['kk', 'kk'],
+		['k', 'k'],
+		// Minute
+		['mm', 'mm'],
+		['m', 'm'],
+		// Second
+		['ss', 'ss'],
+		['s', 's'],
+		// Fractional second — JS Date only has ms precision; SSSS+ pad with zeros in both
+		['SSSSSSSSS', 'SSSSSSSSS'],
+		['SSSSSSSS', 'SSSSSSSS'],
+		['SSSSSSS', 'SSSSSSS'],
+		['SSSSSS', 'SSSSSS'],
+		['SSSSS', 'SSSSS'],
+		['SSSS', 'SSSS'],
+		['SSS', 'SSS'],
+		['SS', 'SS'],
+		['S', 'S'],
+		// AM/PM — date-fns `a`/`aa` are always uppercase (AM/PM); `aaa` is lowercase (am/pm)
+		['A', 'a'],
+		['a', 'aaa'],
+		// Quarter
+		['QQQQ', 'QQQQ'],
+		['QQQ', 'QQQ'],
+		['QQ', 'QQ'],
+		['Qo', 'Qo'],
+		['Q', 'Q'],
+		// Week of year (locale)
+		['ww', 'ww'],
+		['wo', 'wo'],
+		['w', 'w'],
+		// ISO day of week (Moment E = 1-7 → date-fns i)
+		['E', 'i'],
+		// Timezone offset (Moment Z = +05:00, ZZ = +0500)
+		['ZZ', 'xx'],
+		['Z', 'xxx'],
+		// Timezone abbreviated name (Moment z/zz = "EST"). date-fns has no
+		// real abbreviation; zzz produces "GMT-3" in browsers. Closest available.
+		['zz', 'zzz'],
+		['z', 'zzz'],
+		// Unix timestamp (Moment X = seconds, x = milliseconds)
+		['X', 't'],
+		['x', 'T'],
+	] as Array<[moment: string, dateFns: string]>
+).sort((a, b) => b[0].length - a[0].length);
+
+const LITERAL_LETTER = /[a-zA-Z]/;
+
+/**
+ * Translate a Moment.js format string to a date-fns format string.
+ *
+ * The two libraries diverge in two important ways that this function bridges:
+ *  1. Moment treats unrecognized letters as literals (so `T` in `YYYY-MM-DDTHH:mm:ss`
+ *     prints as a literal `T`); date-fns reserves every letter as a token, so an
+ *     unmapped letter either produces wrong output (`T` = ms timestamp) or throws.
+ *  2. Moment uses `Z`/`ZZ` for timezone offsets; date-fns has no `Z` token at all.
+ *
+ * The translator tokenizes left-to-right: it recognizes Moment's `[literal]` escape
+ * syntax, longest-matches a known Moment token, and quotes any other letter as a
+ * date-fns literal so admin-configured formats keep working after the moment→date-fns
+ * migration. Used by Message_DateFormat / Message_TimeFormat / Message_TimeAndDateFormat.
+ */
+export const momentFormatToDateFns = (momentFormat: string): string => {
+	let out = '';
+	let literal = '';
+	let i = 0;
+
+	const flushLiteral = () => {
+		if (literal) {
+			out += `'${literal.replace(/'/g, "''")}'`;
+			literal = '';
+		}
+	};
+
+	while (i < momentFormat.length) {
+		const ch = momentFormat[i];
+
+		if (ch === '[') {
+			const end = momentFormat.indexOf(']', i + 1);
+			if (end !== -1) {
+				literal += momentFormat.slice(i + 1, end);
+				i = end + 1;
+				continue;
+			}
+		}
+
+		let matched = false;
+		for (const [mom, df] of MOMENT_TO_DATE_FNS_TOKENS) {
+			if (momentFormat.startsWith(mom, i)) {
+				flushLiteral();
+				out += df;
+				i += mom.length;
+				matched = true;
+				break;
+			}
+		}
+		if (matched) continue;
+
+		if (LITERAL_LETTER.test(ch)) {
+			literal += ch;
+		} else {
+			flushLiteral();
+			out += ch;
+		}
+		i++;
+	}
+
+	flushLiteral();
+	return out;
+};
+
+const DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
+
+/**
+ * Normalize a date input to a Date.
+ *
+ * Calendar-date-only strings (`yyyy-MM-dd`, e.g. produced by an `<input type="date">`)
+ * are parsed in LOCAL time, the way Moment.js did before the date-fns migration.
+ * `new Date('2026-07-02')` instead parses as UTC midnight, which renders as the
+ * previous day in negative-offset timezones (e.g. UTC-3 shows "Jul 1"). Full ISO
+ * datetimes, numbers and Date objects keep their original instant semantics.
+ */
+export const toDate = (date: DateInput): Date => {
+	if (date instanceof Date) {
+		return date;
+	}
+	if (typeof date === 'string' && DATE_ONLY_RE.test(date)) {
+		return parse(date, 'yyyy-MM-dd', new Date());
+	}
+	return new Date(date);
+};
+
+const safeFormat = (d: Date, momentFormat: string, locale?: Locale): string => {
+	const options = {
+		...(locale && { locale }),
+		useAdditionalWeekYearTokens: true,
+		useAdditionalDayOfYearTokens: true,
+	};
+	try {
+		return format(d, momentFormatToDateFns(momentFormat), options);
+	} catch {
+		return format(d, FALLBACK_FORMAT, options);
+	}
+};
+
+export const formatDate = (date: DateInput, formatStr: string, locale?: Locale): string => {
+	return safeFormat(toDate(date), formatStr, locale);
+};
+
+export const formatTimeAgo = (
+	date: DateInput,
+	options: {
+		yesterdayLabel: string;
+		sameDayFormat: string;
+		lastDayFormat?: string; // if set, show "Yesterday" + format(time, lastDayFormat)
+		lastWeekFormat: string;
+		otherFormat: string;
+		otherYearFormat: string;
+	},
+	locale?: Locale,
+): string => {
+	const d = toDate(date);
+	const now = new Date();
+	const diffDays = differenceInCalendarDays(now, d);
+
+	if (diffDays === 0) {
+		return safeFormat(d, options.sameDayFormat, locale);
+	}
+	if (diffDays === 1) {
+		if (options.lastDayFormat) {
+			return `${options.yesterdayLabel} ${safeFormat(d, options.lastDayFormat, locale)}`;
+		}
+		return options.yesterdayLabel;
+	}
+	if (diffDays > 1 && diffDays < 7) {
+		return safeFormat(d, options.lastWeekFormat, locale);
+	}
+	const diffYears = now.getFullYear() - d.getFullYear();
+	const fmt = diffYears !== 0 ? options.otherYearFormat : options.otherFormat;
+	return safeFormat(d, fmt, locale);
+};
+
+export const formatFromNow = (date: DateInput, addSuffix: boolean, locale?: Locale): string => {
+	return formatDistanceToNow(toDate(date), { addSuffix, locale });
+};
+
+export const formatDurationMs = (timeMs: number, locale?: Locale): string => {
+	const duration = intervalToDuration({ start: 0, end: timeMs });
+	return formatDuration(duration, { locale });
+};