Locale

Multi-language formatting with 40+ locales

Edit and run examples against `ts-time-utils@4.4.1` in your browser.

Localized Formatting

Format dates and relative times in different languages

index.ts

import { formatRelativeTime, formatDateLocale, detectLocale } from 'ts-time-utils/locale';

const pastDate = new Date(Date.now() - 2 * 60 * 60 * 1000); // 2 hours ago

// Relative time in different languages
console.log(formatRelativeTime(pastDate, { locale: 'en' }));
// "2 hours ago"

console.log(formatRelativeTime(pastDate, { locale: 'es' }));
// "hace 2 horas"

console.log(formatRelativeTime(pastDate, { locale: 'de' }));
// "vor 2 Stunden"

console.log(formatRelativeTime(pastDate, { locale: 'fr' }));
// "il y a 2 heures"

console.log(formatRelativeTime(pastDate, { locale: 'ja' }));
// "2時間前"

// Format dates in locale
const date = new Date('2025-01-15');
console.log(formatDateLocale(date, 'en', 'long'));
// "January 15, 2025"

console.log(formatDateLocale(date, 'fr', 'long'));
// "15 janvier 2025"

console.log(formatDateLocale(date, 'zh', 'long'));
// "2025年1月15日"

// Auto-detect system locale
console.log('Detected locale:', detectLocale());

Console

Press Run to execute the example.