Метод JavaScript Array.toLocaleString()

Array 对象参考手册Объект Array в JavaScript


Пример

Форматирование в различные региональные форматы:

const prices = [1234.56, 7890.12, 3456.78]; const dateArray = [new Date(), new Date('2023-01-01')]; //Number-массивы используют локализованный формат console.log(prices.toLocaleString('en-US')); //Вывод примерно такой: "1,234.56,7,890.12,3,456.78" (английский формат) console.log(prices.toLocaleString('de-DE')); //Вывод примерно такой: "1.234,56,7.890,12,3.456,78" (немецкий формат) //Массивы дат используют локализованный формат console.log(dateArray.toLocaleString('en-US')); //Вывод примерно такой: "5/6/2023, 1/1/2023" (английский формат даты) console.log(dateArray.toLocaleString('ja-JP')); //Вывод примерно такой: "2023/5/6, 2023/1/1" (японский формат даты)

Попробуйте сами »

Определение и использование

Array.toLocaleString()Это встроенный метод объекта массива JavaScript, который возвращает строку, представляющую элементы массива.

Array.toLocaleString()Особенность этого метода в том, что он форматирует каждый элемент массива в соответствии с локальными настройками текущей среды.

Проще говоря, этот метод:

  • Преобразует массив в строку
  • Автоматически обрабатывает локализованные форматы (такие как даты, числа и т. д.)
  • Элементы разделяются запятыми

Базовый синтаксис

array.toLocaleString([locales[, options]])

Описание параметра

  • locales(Необязательно): строка или массив строк, представляющий языковой код (например, "en-US", "zh-CN")
  • options(Необязательно): объект конфигурации, используемый для указания параметров форматирования

Как использовать

Базовое использование

Пример

const numbers = [12345.67, 1000, 3.14159];
console.log(numbers.toLocaleString('en-US'));
// Вывод: "12,345.67,1,000,3.142"

console.log(numbers.toLocaleString('de-DE'));
// Вывод: "12.345,67,1.000,3,142"

Работа с объектами Date

Пример

const dates = [new Date(), new Date('2023-01-01')];
console.log(dates.toLocaleString('en-US'));
// Возможный вывод: "1/2/2024, 2:30:45 PM,1/1/2023, 12:00:00 AM"

Продвинутое использование

Использование параметра options

Пример

const numbers = [12345.67, 1000, 3.14159];

// Укажите формат валюты
console.log(numbers.toLocaleString('en-US', {
  style: 'currency',
  currency: 'USD'
}));
// Вывод: "$12,345.67,$1,000.00,$3.14"

// Укажите процентный формат
console.log([0.25, 0.5, 0.75].toLocaleString('en-US', {
  style: 'percent'
}));
// Вывод: "25%,50%,75%"

Отличие от toString()

Метод Обработка локализации Форматирование даты Форматирование чисел
toString() Отсутствует Преобразует в строку по умолчанию Без специальной обработки
toLocaleString() Да Согласно локальному формату Согласно локальному формату

Пример

const arr = [1000, new Date()];

console.log(arr.toString());
// Вывод: "1000,Wed Jan 03 2024 14:30:00 GMT+0800 (China Standard Time)"

console.log(arr.toLocaleString('zh-CN'));
// Вывод: "1,000,2024/1/3 14:30:00"

Практические сценарии применения

  1. Многоязычные веб-сайты: отображение форматированных данных на основе языковых предпочтений пользователя
  2. Финансовые приложения: корректное отображение форматов валют для разных регионов
  3. Анализ данных: отображение чисел и дат в привычных форматах
  4. Отображение форм: отображение данных в локализованных форматах в полях ввода

Примечания

  1. Вопросы производительности: частые вызовы могут влиять на производительность, особенно на больших массивах
  2. Совместимость с браузерами: хотя современные браузеры это поддерживают, некоторые параметры могут отличаться
  3. Поведение по умолчанию: Если параметр locales не указан, используются языковые настройки среды выполнения по умолчанию
  4. Обработка элементов: Для объектов, не являющихся датами/числами, будет вызван его метод toString()

Итог

Array.toLocaleString()Это мощный инструмент локализации, особенно подходящий для сценариев, где отформатированные данные должны отображаться в соответствии с регионом пользователя. Он упрощает реализацию интернационализации (i18n), позволяя разработчикам легко справляться с различиями в форматах чисел и дат в разных регионах.

Помните, когда ваше приложение должно обслуживать пользователей по всему миру, использование этого метода может значительно улучшить пользовательский опыт!

Array 对象参考手册Объект Array в JavaScript

Другие расширения