Класс DateFormatSymbols

java.lang.Object

java.text.DateFormatSymbols

Все реализованные интерфейсы:: Serializable, Cloneable

public class DateFormatSymbols extends Object implements Serializable, Cloneable

DateFormatSymbols — это общедоступный класс для инкапсуляции данных локально зависимого форматирования даты и времени, таких как названия месяцев, названия дней недели и данные о часовых поясах. SimpleDateFormat использует DateFormatSymbols для инкапсуляции этой информации.

Обычно вы не должны использовать DateFormatSymbols напрямую. Вместо этого рекомендуется создавать форматировщик дат и времени с помощью методов-фабрик класса DateFormat: getTimeInstance, getDateInstance или getDateTimeInstance. Эти методы автоматически создают DateFormatSymbols для форматировщика, поэтому вам не нужно этого делать. После создания форматировщика вы можете изменить его шаблон форматирования с помощью метода setPattern. Более подробную информацию о создании форматировщиков с помощью методов-фабрик DateFormat см. в DateFormat.

Если вы решите создать форматировщик дат и времени с определенным шаблоном форматирования для определенной локали, вы можете сделать это следующим образом:

new SimpleDateFormat(aPattern, DateFormatSymbols.getInstance(aLocale));

Если локализация содержит "rg" (переопределение региона) расширение Юникода, символы переопределяются для указанного региона.

Объекты DateFormatSymbols поддерживают клонирование. При получении объекта DateFormatSymbols вы можете изменять данные форматирования даты и времени. Например, вы можете заменить локальные символы шаблона форматирования даты и времени символами, которые вам легко запомнить. Или вы можете изменить представительные города на свои любимые.

Новые подклассы DateFormatSymbols могут быть добавлены для поддержки SimpleDateFormat форматирования даты и времени для дополнительных локалей.

С:

1.1

См. также:

Краткое описание конструкторов

Конструктор	Описание
`DateFormatSymbols()`	Создаёт объект DateFormatSymbols, загружая данные форматирования из ресурсов для локали по умолчанию `FORMAT`.
`DateFormatSymbols(Locale locale)`	Создаёт объект DateFormatSymbols, загружая данные форматирования из ресурсов для заданной локали.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Переопределяет Cloneable
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этим `DateFormatSymbols` на равенство.
`String[]`	`getAmPmStrings()`	Получает строки ам/пм.
`static Locale[]`	`getAvailableLocales()`	Возвращает массив всех локалей, для которых методы `getInstance` этого класса могут вернуть локализованные экземпляры.
`String[]`	`getEras()`	Получает строки эры.
`static final DateFormatSymbols`	`getInstance()`	Получает экземпляр `DateFormatSymbols` для локали по умолчанию.
`static final DateFormatSymbols`	`getInstance(Locale locale)`	Получает экземпляр `DateFormatSymbols` для указанной локали.
`String`	`getLocalPatternChars()`	Получает символы шаблона локально зависимого форматирования даты и времени.
`String[]`	`getMonths()`	Получает строки месяцев.
`String[]`	`getShortMonths()`	Получает короткие строки месяцев.
`String[]`	`getShortWeekdays()`	Получает короткие строки дней недели.
`String[]`	`getWeekdays()`	Получает строки дней недели.
`String[][]`	`getZoneStrings()`	Получает строки часовых поясов.
`int`	`hashCode()`	Возвращает код хэша для этого `DateFormatSymbols`.
`void`	`setAmPmStrings(String[] newAmpms)`	Устанавливает строки ам/пм.
`void`	`setEras(String[] newEras)`	Устанавливает строки эры.
`void`	`setLocalPatternChars(String newLocalPatternChars)`	Устанавливает символы локально зависимого шаблона форматирования даты и времени.
`void`	`setMonths(String[] newMonths)`	Устанавливает строки месяцев.
`void`	`setShortMonths(String[] newShortMonths)`	Устанавливает короткие строки месяцев.
`void`	`setShortWeekdays(String[] newShortWeekdays)`	Устанавливает короткие строки дней недели.
`void`	`setWeekdays(String[] newWeekdays)`	Устанавливает строки дней недели.
`void`	`setZoneStrings(String[][] newZoneStrings)`	Устанавливает строки часовых поясов.

Методы, объявленные в классе java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

DateFormatSymbols

public DateFormatSymbols()

Создаёт объект DateFormatSymbols, загружая данные форматирования из ресурсов для локального языка по умолчанию (FORMAT). Этот конструктор может создавать экземпляры только для локалей, поддерживаемых средой выполнения Java, а не для локалей, поддерживаемых установленными реализациями DateFormatSymbolsProvider. Для полной поддержки локалей используйте метод getInstance.

Это эквивалентно вызову DateFormatSymbols(Locale.getDefault(Locale.Category.FORMAT)).

Исключение:

MissingResourceException - если ресурсы для локального языка по умолчанию не найдены или не могут быть загружены.

См. также:

DateFormatSymbols

public DateFormatSymbols(Locale locale)

Создаёт объект DateFormatSymbols, загружая данные форматирования из ресурсов для заданного локального языка. Этот конструктор может создавать экземпляры только для локалей, поддерживаемых средой выполнения Java, а не для локалей, поддерживаемых установленными реализациями DateFormatSymbolsProvider. Для полной поддержки локалей используйте метод getInstance.

Параметры:

locale - требуемый локальный язык

Исключение:

MissingResourceException - если ресурсы для заданного локального языка не найдены или не могут быть загружены.

См. также:

Подробное описание методов

getAvailableLocales

public static Locale[] getAvailableLocales()

Возвращает массив всех локалей, для которых методы этого класса могут возвращать локализованные экземпляры. Возвращаемый массив представляет собой объединение локалей, поддерживаемых средой выполнения Java, и установленными реализациями DateFormatSymbolsProvider. Как минимум, возвращаемый массив должен содержать экземпляр Locale, равный Locale.ROOT, и экземпляр Locale, равный Locale.US.

Возвращает:: Массив локалей, для которых доступны локализованные экземпляры DateFormatSymbols.
С:: 1.6

getInstance

public static final DateFormatSymbols getInstance()

Получает экземпляр DateFormatSymbols для локального языка по умолчанию. Этот метод предоставляет доступ к экземплярам DateFormatSymbols для локалей, поддерживаемых самим исполняемым окружением Java, а также для локалей, поддерживаемых установленными реализациями DateFormatSymbolsProvider.

Это эквивалентно вызову getInstance(Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

экземпляр DateFormatSymbols.

С:

1.6

См. также:

getInstance

public static final DateFormatSymbols getInstance(Locale locale)

Получает экземпляр DateFormatSymbols для заданного локального языка. Этот метод предоставляет доступ к экземплярам DateFormatSymbols для локалей, поддерживаемых самим исполняемым окружением Java, а также для локалей, поддерживаемых установленными реализациями DateFormatSymbolsProvider.

Параметры:: locale - заданный локальный язык.
Возвращает:: экземпляр DateFormatSymbols.
Исключение:: NullPointerException - если locale равно null
С:: 1.6

getEras

public String[] getEras()

Получает строки эр. Например: "AD" и "BC".

Возвращает:: строки эр.

setEras

public void setEras(String[] newEras)

Устанавливает строки эр. Например: "AD" и "BC".

Параметры:: newEras - новые строки эр.

getMonths

public String[] getMonths()

Получает строки месяцев. Например: "Январь", "Февраль" и т. д. Возвращается массив из 12 или 13 элементов, в зависимости от того, поддерживается ли Calendar.UNDECIMBER. Используйте Calendar.JANUARY, Calendar.FEBRUARY и т. д. для индексации массива результатов.

Если язык требует разных форм для форматирования и самостоятельного использования, этот метод возвращает имена месяцев в форме форматирования. Например, предпочтительное название января на чешском языке — ledna в форме форматирования, а leden — в форме самостоятельного использования. В этом случае этот метод возвращает "ledna". Подробнее см. Спецификацию Calendar Elements в языке разметки данных Unicode (LDML).

Требования к реализации:

Этот метод возвращает 13 элементов, так как поддерживается Calendar.UNDECIMBER.

Возвращает:

строки месяцев.

Внешние спецификации

setMonths

public void setMonths(String[] newMonths)

Устанавливает строки месяцев. Например: "Январь", "Февраль" и т. д.

Параметры:: newMonths - новые строки месяцев. Индексирование должно соответствовать Calendar.JANUARY, Calendar.FEBRUARY и т. д.

getShortMonths

public String[] getShortMonths()

Получает короткие строки месяцев. Например: "Янв", "Фев" и т. д. Возвращается массив из 12 или 13 элементов, в зависимости от того, поддерживается ли Calendar.UNDECIMBER. Используйте Calendar.JANUARY, Calendar.FEBRUARY и т. д. для индексации массива результатов.

Если язык требует разных форм для форматирования и самостоятельного использования, этот метод возвращает короткие имена месяцев в форме форматирования. Например, предпочтительное сокращение для января на каталонском языке — de gen. в форме форматирования, а gen. — в форме самостоятельного использования. В этом случае этот метод возвращает "de gen.". Подробнее см. Спецификацию Calendar Elements в языке разметки данных Unicode (LDML).

Требования к реализации:

Этот метод возвращает 13 элементов, так как поддерживается Calendar.UNDECIMBER.

Возвращает:

короткие строки месяцев.

Внешние спецификации

setShortMonths

public void setShortMonths(String[] newShortMonths)

Устанавливает короткие строки месяцев. Например: "Янв", "Фев" и т. д.

Параметры:: newShortMonths - новые короткие строки месяцев. Индексирование должно соответствовать Calendar.JANUARY, Calendar.FEBRUARY и т. д.

getWeekdays

public String[] getWeekdays()

Получает строки дней недели. Например: "Воскресенье", "Понедельник" и т. д.

Возвращает:: строки дней недели. Используйте Calendar.SUNDAY, Calendar.MONDAY и т. д. для индексации массива результатов.

setWeekdays

public void setWeekdays(String[] newWeekdays)

Устанавливает строки дней недели. Например: "Воскресенье", "Понедельник" и т. д.

Параметры:: newWeekdays - новые строки дней недели. Индексирование должно соответствовать Calendar.SUNDAY, Calendar.MONDAY и т. д.

getShortWeekdays

public String[] getShortWeekdays()

Получает короткие строки дней недели. Например: "Вск", "Пнд" и т. д.

Возвращает:: короткие строки дней недели. Используйте Calendar.SUNDAY, Calendar.MONDAY и т. д. для индексации массива результатов.

setShortWeekdays

public void setShortWeekdays(String[] newShortWeekdays)

Устанавливает сокращенные названия дней недели. Например: "Вс", "Пн" и т. д.

Parameters:: newShortWeekdays - новые сокращенные названия дней недели. Массив должен быть индексирован по Calendar.SUNDAY, Calendar.MONDAY и т. д.

getAmPmStrings

public String[] getAmPmStrings()

Возвращает строки для обозначения AM и PM. Например: "AM" и "PM".

Returns:: строки для обозначения AM и PM.

setAmPmStrings

public void setAmPmStrings(String[] newAmpms)

Устанавливает строки для обозначения AM и PM. Например: "AM" и "PM".

Parameters:: newAmpms - новые строки для обозначения AM и PM.

getZoneStrings

public String[][] getZoneStrings()

Возвращает строки для обозначения часовых поясов. Использование этого метода не рекомендуется; используйте TimeZone.getDisplayName() вместо него.

Возвращаемое значение — двумерный массив строк размером n × m, где m не менее 5. Каждая из n строк содержит локализованные имена для одного TimeZone. Каждая такая строка содержит (с i от 0 до n-1):

zoneStrings[i][0] — идентификатор часового пояса
zoneStrings[i][1] — полное имя часового пояса в стандартном времени
zoneStrings[i][2] — краткое имя часового пояса в стандартном времени
zoneStrings[i][3] — полное имя часового пояса в летнем времени
zoneStrings[i][4] — краткое имя часового пояса в летнем времени

Идентификатор часового пояса не локализован; это один из допустимых идентификаторов класса TimeZone, которые не являются пользовательскими идентификаторами. Все остальные записи — локализованные имена. Если часовой пояс не поддерживает летнее время, имена летнего времени не должны использоваться.

Если метод setZoneStrings был вызван для этого экземпляра DateFormatSymbols, то возвращаются строки, предоставленные этим вызовом. В противном случае возвращаемый массив содержит имена, предоставленные Java runtime и установленными реализациями TimeZoneNameProvider.

Returns:

строки для обозначения часовых поясов.

See Also:

setZoneStrings

public void setZoneStrings(String[][] newZoneStrings)

Устанавливает строки для обозначения часовых поясов. Аргумент должен быть двумерным массивом строк размером n × m, где m не менее 5. Каждая из n строк содержит локализованные имена для одного TimeZone. Каждая такая строка содержит (с i от 0 до n-1):

zoneStrings[i][0] — идентификатор часового пояса
zoneStrings[i][1] — полное имя часового пояса в стандартном времени
zoneStrings[i][2] — краткое имя часового пояса в стандартном времени
zoneStrings[i][3] — полное имя часового пояса в летнем времени
zoneStrings[i][4] — краткое имя часового пояса в летнем времени

Идентификатор часового пояса не локализован; это один из допустимых идентификаторов класса TimeZone, которые не являются пользовательскими идентификаторами.

Parameters:

newZoneStrings - новые строки для обозначения часовых поясов.

Throws:

IllegalArgumentException - если длина любой строки в newZoneStrings меньше 5

NullPointerException - если newZoneStrings равно null

See Also:

getLocalPatternChars

public String getLocalPatternChars()

Возвращает локализованные символы шаблонов даты и времени. Например: 'u', 't' и т. д.

Returns:: локализованные символы шаблонов даты и времени.

setLocalPatternChars

public void setLocalPatternChars(String newLocalPatternChars)

Устанавливает локализованные символы шаблонов даты и времени. Например: 'u', 't' и т. д.

Parameters:: newLocalPatternChars - новые локализованные символы шаблонов даты и времени.

clone

public Object clone()

Переопределяет Cloneable

Overrides:

clone в классе Object

Returns:

клонированный экземпляр.

See Also:

hashCode

public int hashCode()

Возвращает хэш-код для этого DateFormatSymbols.

Overrides:

hashCode в классе Object

Implementation Requirements:

Для вычисления хэш-кода используются не транзиентные поля этого класса, соответствующие контракту, определенному в Objects.hashCode(java.lang.Object).

Returns:

хэш-код для этого DateFormatSymbols

See Also:

equals

public boolean equals(Object obj)

Сравнивает указанный объект с этим DateFormatSymbols на предмет равенства. Возвращает true, если объект также является DateFormatSymbols и два объекта DateFormatSymbols представляют одни и те же данные форматирования даты и времени.

Overrides:

equals в классе Object

Implementation Requirements:

Этот метод выполняет проверку равенства с учетом идентичности класса, основанной на getClass(), а не на instanceof. Поэтому в методах equals в подклассах ни один экземпляр этого класса не должен считаться равным экземпляру подкласса.

Parameters:

obj - объект для сравнения на равенство

Returns:

true, если указанный объект равен этому DateFormatSymbols

See Also:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/text/DateFormatSymbols.html