← 返回首页
Date.prototype.toLocaleString() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. Дата
  6. Date.prototype.toLocaleString()
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Date.prototype.toLocaleString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

Метод toLocaleString() экземпляров Date возвращает строку, содержащую зависимое от языка представление этой даты в локальном часовом поясе. В реализациях, поддерживающих Intl.DateTimeFormat API, этот метод просто вызывает Intl.DateTimeFormat.

При каждом вызове toLocaleString происходит поиск по большой базе локализованных строк, что может быть неэффективным. Когда метод вызывается много раз с одинаковыми параметрами, лучше создать объект Intl.DateTimeFormat и использовать его метод format(), потому что объект DateTimeFormat запоминает переданные ему параметры и может кешировать данные, чтобы последующие вызовы format могли выполнять поиск с более определённым контекстом.

In this article

Интерактивный пример

const event = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // British English uses day-month-year order and 24-hour time without AM/PM console.log(event.toLocaleString("en-GB", { timeZone: "UTC" })); // Expected output: "20/12/2012, 03:00:00" // Korean uses year-month-day order and 12-hour time with AM/PM console.log(event.toLocaleString("ko-KR", { timeZone: "UTC" })); // Expected output: "2012. 12. 20. 오전 3:00:00"

Синтаксис

js
toLocaleString() toLocaleString(locales) toLocaleString(locales, options)

Параметры

Параметры locales и options изменяют поведение функции и позволяют приложениям определять язык, правила форматирования которого, следует использовать.

В реализациях, поддерживающих Intl.DateTimeFormat API, эти параметры соответствуют параметрам конструктора Intl.DateTimeFormat(). Реализации без поддержки Intl.DateTimeFormat должны игнорировать оба параметра, используя локаль и формат возвращаемой строки определяемые самой реализацией.

locales Необязательный

Строка с языковым тегом BCP 47 или массив таких строк. Соответствует параметру locales конструктора `Intl.DateTimeFormat().

В реализациях без поддержки Intl.DateTimeFormat этот параметр игнорируется и обычно используется локаль устройства.

options Необязательный

Объект определяющий выходной формат. Соответствует параметру options конструктора Intl.DateTimeFormat(). Опция timeStyle должна быть undefined или будет возникать TypeError. Если weekday, year, month и day одновременно равны undefined, то year, month и day будут установлены в "numeric".

В реализациях без поддержки Intl.DateTimeFormat этот параметр игнорируется.

Смотрите описание конструктора Intl.DateTimeFormat() для подробностей использования этих параметров.

Возвращаемое значение

Строка, представляющая указанную дату в соответствии с языковыми требованиями.

В реализациях с поддержкой Intl.DateTimeFormat результат будет эквивалентным new Intl.DateTimeFormat(locales, options).format(date).

Примечание: В большинстве случаев форматирование, возвращаемое toLocaleString(), единообразно. Однако результат может быть разным в зависимости от времени, языка и реализации — это допускается спецификацией. Не следует сравнивать результат toLocaleString() со статическими значениями.

Примеры

Использование toLocaleString()

При использовании без указания локали возвращается строка, отформатированная в соответствии с локалью и настройками по умолчанию.

js
const date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); // Вывод toLocaleString() без параметров зависит от реализации, // локали по умолчанию и часового пояса по умолчанию console.log(date.toLocaleString()); // "12/11/2012, 7:00:00 PM", если код запущен с локалью en-US и часовым поясом America/Los_Angeles

Проверка поддержки параметров locales и options

Параметры locales и options могут поддерживаться не во всех реализациях. В реализациях без поддержки интернационализации toLocaleString() всегда использует системную локаль, что может оказаться не тем, что вам нужно. Поскольку любая реализация, поддерживающая параметры locales и options, должна поддерживать Intl API, проверить наличие последней можно таким способом:

js
function toLocaleStringSupportsLocales() { return ( typeof Intl === "object" && !!Intl && typeof Intl.DateTimeFormat === "function" ); }

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

Этот пример показывает некоторые локализованные форматы даты и времени. Для получения формата языка, используемого в пользовательском интерфейсе вашего приложения, убедитесь, что вы указали этот язык (и, возможно, несколько запасных языков) используя параметр locales:

js
const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // Форматирование ниже предполагает, что местный часовой пояс равен // America/Los_Angeles для локали США // В американском английском используется порядок месяц-день-год // и 12-часовой формат времени console.log(date.toLocaleString("en-US")); // "12/19/2012, 7:00:00 PM" // В британском английском используется порядок день-месяц-год // и 24-часовой формат времени console.log(date.toLocaleString("en-GB")); // "20/12/2012 03:00:00" // В корейском используется порядок год-месяц-день // и 12-часовой формат времени console.log(date.toLocaleString("ko-KR")); // "2012. 12. 20. 오후 12:00:00" // В большинстве арабоязычных стран используют настоящие арабские цифры console.log(date.toLocaleString("ar-EG")); // "٢٠‏/١٢‏/٢٠١٢ ٥:٠٠:٠٠ ص" // В Японии приложения могут захотеть использовать японский календарь, // в котором 2012 год является 24-м годом эры Хейсей console.log(date.toLocaleString("ja-JP-u-ca-japanese")); // "24/12/20 12:00:00" // Если запрашиваемый язык может не поддерживаться, например // балийский, откатываемся на запасной язык, в данном случае индонезийский console.log(date.toLocaleString(["ban", "id"])); // "20/12/2012 11.00.00"

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

Результат, предоставляемый методом toLocaleString(), может быть настроен с помощью параметра options:

js
const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // Запрашиваем день недели вместе с длинным форматом даты var options = { weekday: "long", year: "numeric", month: "long", day: "numeric", }; console.log(date.toLocaleString("de-DE", options)); // "Donnerstag, 20. Dezember 2012" // Приложение может захотеть использовать UTC и показать это options.timeZone = "UTC"; options.timeZoneName = "short"; console.log(date.toLocaleString("en-US", options)); // "Thursday, December 20, 2012, GMT" // Иногда даже в США нужен 24-х часовой формат времени console.log(date.toLocaleString("en-US", { hour12: false })); // "12/19/2012, 19:00:00"

Спецификации

Specification
ECMAScript® 2027 Language Specification
# sec-date.prototype.tolocalestring
ECMAScript® 2027 Internationalization API Specification
# sup-date.prototype.tolocalestring

Совместимость с браузерами

Enable JavaScript to view this browser compatibility table.

Смотрите также

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 24 июн. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. Date
  3. Конструктор
    1. Date()
  4. Статические методы
    1. Date.now()
    2. Date.parse()
    3. Date.UTC()
  5. Методы экземпляра
    1. Date.prototype.getDate()
    2. Date.prototype.getDay()
    3. Date.prototype.getFullYear()
    4. Date.prototype.getHours()
    5. Date.prototype.getMilliseconds()
    6. Date.prototype.getMinutes()
    7. Date.prototype.getMonth()
    8. Date.prototype.getSeconds()
    9. Date.prototype.getTime()
    10. Date.prototype.getTimezoneOffset()
    11. Date.prototype.getUTCDate()
    12. Date.prototype.getUTCDay()
    13. Date.prototype.getUTCFullYear()
    14. Date.prototype.getUTCHours()
    15. Date.prototype.getUTCMilliseconds()
    16. Date.prototype.getUTCMinutes()
    17. Date.prototype.getUTCMonth()
    18. Date.prototype.getUTCSeconds()
    19. Date.prototype.getYear()
    20. Date.prototype.setDate()
    21. Date.prototype.setFullYear()
    22. Date.prototype.setHours()
    23. Date.prototype.setMilliseconds()
    24. Date.prototype.setMinutes()
    25. Date.prototype.setMonth()
    26. Date.prototype.setSeconds()
    27. Date.prototype.setTime()
    28. Date.prototype.setUTCDate()
    29. Date.prototype.setUTCFullYear()
    30. Date.prototype.setUTCHours()
    31. Date.prototype.setUTCMilliseconds()
    32. Date.prototype.setUTCMinutes()
    33. Date.prototype.setUTCMonth()
    34. Date.prototype.setUTCSeconds()
    35. Date.prototype.setYear()
    36. Date.prototype.toDateString()
    37. Date.prototype.toISOString()
    38. Date.prototype.toJSON()
    39. Date.prototype.toLocaleDateString()
    40. Date.prototype.toLocaleString()
    41. Date.prototype.toLocaleTimeString()
    42. Date.prototype.toString()
    43. toTemporalInstant()
    44. Date.prototype.toTimeString()
    45. Date.prototype.toUTCString()
    46. Date.prototype.valueOf()
    47. [Symbol.toPrimitive]()
  6. Наследование
  7. Object/Function
  8. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  9. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  10. Методы экземпляра
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  11. Свойства экземпляра
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.