★ wanayoo — archive 1999 https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormatNouvelle recherche | Portail wanayoo

Check out Firefox Developer Edition, the first browser built for developers like you. http://mzl.la/112VrtT

mozilla
Your Search Results

    Intl.DateTimeFormat

    Сводка

    Объект Intl.DateTimeFormat является конструктором объектов, включающих языко-зависимое форматирование даты и времени.

    Синтаксис

    new Intl.DateTimeFormat([locales[, options]])
    Intl.DateTimeFormat.call(this[, locales[, options]])

    Параметры

    locales

    Необязательный параметр. Строка с языковой меткой BCP 47, либо массив таких строк. Описание общей формы и интерпретации аргумента locales смотрите на странице, посвящённой объекту Intl. Разрешены следующие ключи расширения Unicode:

    nu
    Используемая система нумерации. Возможные значения включают в себя: "arab", "arabext", "bali", "beng", "deva", "fullwide", "gujr", "guru", "hanidec", "khmr", "knda", "laoo", "latn", "limb", "mlym", "mong", "mymr", "orya", "tamldec", "telu", "thai", "tibt".
    ca
    Используемый календарь. Возможные значения включают в себя: "buddhist", "chinese", "coptic", "ethioaa", "ethiopic", "gregory", "hebrew", "indian", "islamic", "islamicc", "iso8601", "japanese", "persian", "roc".
    options

    Необязательный параметр. Объект с некоторыми или всеми из следующих свойств:

    localeMatcher
    Используемый алгоритм сопоставления локалей. Возможными значениями являются "lookup" и "best fit"; значением по умолчанию является "best fit". Информацию по этой опции смотрите на странице, посвящённой объекту Intl.
    timeZone
    Используемый часовой пояс. Единственным значением, которые реализации обязаны распознавать, является "UTC"; значением по умолчанию является часовой пояс по умолчанию среды выполнения. Реализации также могут распознавать названия часовых поясов из базы даных часовых поясов IANA, например "Asia/Shanghai", "Asia/Kolkata" или "America/New_York".
    hour12
    Определяет, использовать ли 12-ти часовой формат времени (в противовес 24-х часовому). Возможными значениями являются true и false; значение по умолчанию зависит от локали.
    formatMatcher
    Используемый алгоритм сопоставления форматов. Возможными значениями являются "basic" и "best fit"; значением по умолчанию является "best fit". Смотрите следующий абзац, объясняющий, как использовать это свойство.

    Следующие свойства описывают компоненты даты/времени, используемые в форматированном выводе, и их желаемые представления. Реализации должны поддерживать, как минимум, следующие подмножества:

    • weekday, year, month, day, hour, minute, second
    • weekday, year, month, day
    • year, month, day
    • year, month
    • month, day
    • hour, minute, second
    • hour, minute

    Также реализации могут поддерживать другие подмножества и запросы будут сравниваться со всеми доступными подмножествами представлений для поиска наилучшего соответствия. Для такого сравнения доступно два алгоритма, нужный из которых выбирается свойством formatMatcher: чётко определённый алгоритм "basic" и зависящий от реализации алгоритм "best fit".

    weekday
    Представление дней недели. Возможными значениями являются "narrow", "short" и "long".
    era
    Представление эр. Возможными значениями являются "narrow", "short" и "long".
    year
    Представление лет. Возможными значениями являются "numeric" и "2-digit".
    month
    Представление месяцев. Возможными значениями являются "numeric", "2-digit", "narrow", "short" и "long".
    day
    Представление дней. Возможными значениями являются "numeric" и "2-digit".
    hour
    Представление часов. Возможными значениями являются "numeric" и "2-digit".
    minute
    Представление минут. Возможными значениями являются "numeric" и "2-digit".
    second
    Представление секунд. Возможными значениями являются "numeric" и "2-digit".
    timeZoneName
    Представление названий часовых поясов. Возможными значениями являются "short" и "long".

    Значение по умолчанию для всех свойств компонентов даты/времени является значение undefined,но если все свойства компонентов будут равны undefined, то будет предполагаться, что значением свойств year, month и day является "numeric".

    Описание

    Свойства

    Intl.DateTimeFormat.prototype
    Позволяет добавлять свойства ко всем объектам.

    Методы

    Intl.DateTimeFormat.supportedLocalesOf()
    Возвращает массив, содержащий те из предоставленных локалей, которые поддерживаются без отката к локали по умолчанию среды выполнения.

    Экземпляры объекта DateTimeFormat

    Свойства

    Экземпляры DateTimeFormat наследуют следующие свойства из своего прототипа:

    Intl.DateTimeFormat.prototype.constructor
    Ссылка на Intl.DateTimeFormat.
    Intl.DateTimeFormat.prototype.format
    Геттер; возвращает функцию, форматирующую дату согласно локали и опциям форматирования этого объекта DateTimeFormat.

    Методы

    Экземпляры DateTimeFormat наследуют следующие методы из своего прототипа:

    Intl.DateTimeFormat.prototype.resolvedOptions()
    Возвращает новый объект со свойствами, отражающими локаль и опции форматирования, вычисленные при инициализации объекта.

    Примеры

    Пример: использование DateTimeFormat

    При базовом использовании без определения локали DateTimeFormat использует локаль и опции по умолчанию.

    var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
    
    // Вывод format без аргументов зависит от реализации,
    // локали по умолчанию и часового пояса по умолчанию
    console.log(new Intl.DateTimeFormat().format(date));
    // → "12/19/2012", если код запущен с локалью en-US и часовым поясом America/Los_Angeles
    

    Пример: использование аргумента locales

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

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

    Пример: использование аргумента options

    Формат даты и времени может быть настроен с помощью аргумента options:

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

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

    Спецификация Статус Комментарии
    ECMAScript Internationalization API 1.0 (ECMA-402)
    Определение 'Intl.DateTimeFormat' в этой спецификации.
    Стандарт Изначальное определение.

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

    Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
    Базовая поддержка 24 29 (29) 11 15 Не поддерживается
    Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
    Базовая поддержка Не поддерживается 26 Не поддерживается
    bug 864843
    Не поддерживается Не поддерживается Не поддерживается

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

    Метки документа и участники

    На данную страницу внесли свой вклад: Mingun
    Обновлялась последний раз: Mingun,