Locale
Try in Playground →Multi-language formatting with 40+ locales
Import
import { ... } from 'ts-time-utils/locale'; Examples
Localized Formatting
Format dates and relative times in different languages
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());