В чем смысл локали в DateTimeFormatter?

Я просто собираюсь быстро суммировать то, что @sotirios-delimanolis и @user85421 сказали в комментариях.

Вопросы и Ответы

• Первое: (связанное с локалью) Что случилось с отсутствием стран/языков? Они очень ограничены. Не совсем понимаю, почему не все языки доступны как переменные класса Locale. однако вы можете просто обойти это ограничение с помощью Locale.forLanguageTag("fa") (например).
• Второе: (связано с локалью) Почему существуют локали для языков/стран (например, французского и Франции)? Упоминается здесь Но TLDR: такие языки, как французский и немецкий, имеют дочерние компании, поэтому для fr-CA (канадский французский) следует использовать специальный французский язык, который по сути не совсем совпадает с французским французским.
• Третий: Что это вообще дает? Предоставляет альтернативный способ хранения дат. Судя по моему тестированию, это изменяет параметр «Месяц», который вы могли бы использовать localizedBy Для цифровых букв. По крайней мере, на персидском языке этот разговор был английским представлением, а не названием месяца, указанным в календаре.

вр; доктор

Просто игнорируйте устаревшие константы, такие как Locale.CANADA и Locale.CANADA_FRENCH.

Вместо этого используйте статические фабричные методы.

Locale.of( "fr" , "FR" )  // French, France
Locale.of( "fr" , "CA" )  // French, Canada

Подробности

В чем смысл локали в DateTimeFormatter?

Языковой стандарт определяет две вещи, необходимые для локализации:

• Человеческий язык
  (французский, фарси, кантонский диалект и т. д.)
• Культурные нормы
  (аббревиатура, пунктуация, порядок элементов и т.д.)

КЛДР

Современная Java по умолчанию получает информацию о локали из Common Locale Data Repository (CLDR) , опубликованного Консорциумом Unicode . Копия CLDR включена в состав JDK / JRE. Обновления JDK/JRE часто сопровождаются обновлениями CLDR. Правила внутри CLDR меняются по мере развития человеческого языка и культурных норм.

Более старые версии Java имели более простой ограниченный набор информации/правил локали. CLDR обеспечивает почти всемирный охват, а также определяет многие субкультуры.

Что касается Locale.of, локаль используется при переводе названия месяца, дня и т. д. И локаль определяет, как сокращать эти имена, если это необходимо. Кроме того, в языковом стандарте есть правила использования знаков препинания, например, в некоторых языках для завершения аббревиатуры используется ТОЧКА (DateTimeFormatter), а в других языках — нет.

Не обращайте внимания на константы .

Что случилось с отсутствием стран/языков?

Видимо, вы имеете в виду краткий список из пары десятков констант , определенных в Locale.

Эти константы были определены на заре истории Java . Они были предназначены для удобства. Но я сомневаюсь, что сегодня они будут добавлены в Java API по нескольким причинам. Позже команда Java рекомендовала игнорировать эти константы. Здесь задан еще один вопрос: Как были выбраны константы локали?. Но удовлетворительного ответа там не было. Я бы посоветовал вам помнить, что Java спешно выходила на рынок во времена веб-мании, и некоторые сомнительные решения были приняты в спешке. К счастью, сегодня Java развивается с гораздо большим вниманием.

См. Учебные пособия по Java от Oracle (бесплатно) для получения информации о создании экземпляра объекта Locale: Создание локали . И прочитайте Javadoc для локали. Обратите внимание, что Java 19+ предлагает методы Locale в качестве статических фабрик для объектов of.

Почему существуют локали для языков/стран (например, французского и Франции)?

(A) Как отмечалось выше, вам следует игнорировать особенности констант Locale.

(Б) Указывая страну, вы получаете не только язык, но и определенный набор культурных норм. Например, жители Франции и Квебека используют французский язык, но у них сложились разные культурные нормы.

Пример кода

Вы сказали:

Locale

Не жестко закодируйте формат при локализации. Весь формат может варьироваться в зависимости от культуры. Вместо этого позвольте java.time определить подходящий формат для каждой локали.

Чтобы программно запрограммировать форматы при локализации, вызовите методы DateTimeFormatter.ofPattern("d-MMM-yyyy", Locale.FRENCH).

System.out.println( Runtime.version( ) );

List < Locale > locales =
        List.of(
                Locale.of( "fr" , "FR" ) ,  // French, France
                Locale.of( "fr" , "CA" ) ,  // French, Canada
                Locale.of( "en" , "US" ) ,  // English, United States
                Locale.of( "fa" , "IR" )    // Farsi, Iran
        );

LocalDate today = LocalDate.now( ZoneId.of( "America/Edmonton" ) );
DateTimeFormatter formatter = DateTimeFormatter.ofLocalizedDate( FormatStyle.MEDIUM );
for ( Locale locale : locales )
{
    String output = today.format( formatter.withLocale( locale ) );
    System.out.println( locale + " = " + output );
}

При запуске обратите внимание, что французская локализация для Канады сокращает название июля месяца иначе, чем французская локализация для Франции.

Обратите внимание, как в английской локализации для США переупорядочиваются элементы. А в фарси-иранской локализации используется еще третий порядок.

22.0.1+10
fr_FR = 2 juil. 2024
fr_CA = 2 juill. 2024
en_US = Jul 2, 2024
fa_IR = 2 ژوئیه 2024

Кстати, в примерах здесь используется ISO 8601 версия Григорианского календаря , определенная в IsoChronology в комплекте с инфраструктурой java.time в Java. Возможно, вашему приложению потребуется использовать другую хронологию. Например, для реальной работы на фарси Ирана вы можете использовать Хронологию , реализующую исламский календарь. В комплекте с Java вы найдете пять реализаций DateTimeFormatter.ofLocalized…. Еще десять вы можете найти в библиотеке ThreeTen-Extra. Также могут существовать дополнительные сторонние реализации.

Ваши ошибки в коде

java.time.format.DateTimeParseException: текст «01 января 2017 г.» не удалось проанализировать по индексу 3

Ваш текстовый ввод включает в себя начальный нуль для дня месяца. Но ваш шаблон форматирования использует код Chronology. Этот одиночный d указывает на то, что для однозначных чисел, таких как d, не будет начального заполняющего нуля. Итак, ваш вклад 1 нарушает ваше обещание 01-.

Ваш шаблон форматирования не соответствует введенным вами данным другим способом.

1-

В текстовом поле есть "01-Jan-2017", DateTimeFormatter.ofPattern("d-MMM-yyyy", Locale.FRENCH) для названия месяца. А вот по-французски название месяца будет Jan. Если бы синтаксический анализ перешел к этой части входных данных, вы бы столкнулись с еще одним исключением синтаксического анализа .

Избегайте анализа локализованного текста. Для текстового обмена значениями даты и времени используйте только стандартные форматы ISO 8601. Эти форматы были специально созданы для обмена данными, чтобы их было легко анализировать машинам, а также легко читать людям разных культур.

Удобно, что классы java.time по умолчанию используют стандартные форматы ISO 8601 при синтаксическом анализе/генерации текста. Поэтому нет необходимости определять какой-либо шаблон форматирования для стандартных вводов/выводов.