Класс 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));

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

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

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

Начиная с:

1.1

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Переопределяет Cloneable
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этим `DateFormatSymbols` на равенство.
`String[]`	`getAmPmStrings()`	Возвращает строки AM/PM.
`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)`	Задаёт строки AM/PM.
`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)`	Задаёт строки часовых поясов.

Методы, объявленные в классе 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()

Возвращает массив всех локалей, для которых методы getInstance этого класса могут возвращать локализованные экземпляры. Возвращённый массив представляет собой объединение локалей, поддерживаемых средой выполнения 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()

Возвращает строки названий месяцев. Например: "January", "February" и т. д. В зависимости от того, поддерживается ли Calendar.UNDECIMBER, будет возвращён массив из 12 или 13 элементов. Для индексации массива результатов используйте Calendar.JANUARY, Calendar.FEBRUARY и т. д.

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

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

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

Возвращает:

строки названий месяцев.

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

setMonths

public void setMonths(String[] newMonths)

Задаёт строки названий месяцев. Например: "January", "February" и т. д.

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

getShortMonths

public String[] getShortMonths()

Возвращает сокращённые строки названий месяцев. Например: "Jan", "Feb" и т. д. В зависимости от того, поддерживается ли Calendar.UNDECIMBER, будет возвращён массив из 12 или 13 элементов. Для индексации массива результатов используйте Calendar.JANUARY, Calendar.FEBRUARY и т. д.

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

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

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

Возвращает:

сокращённые строки названий месяцев.

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

setShortMonths

public void setShortMonths(String[] newShortMonths)

Задаёт сокращённые строки названий месяцев. Например: "Jan", "Feb" и т. д.

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

getWeekdays

public String[] getWeekdays()

Возвращает строки названий дней недели. Например: "Sunday", "Monday" и т. д.

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

setWeekdays

public void setWeekdays(String[] newWeekdays)

Задаёт строки названий дней недели. Например: "Sunday", "Monday" и т. д.

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

getShortWeekdays

public String[] getShortWeekdays()

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

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

setShortWeekdays

public void setShortWeekdays(String[] newShortWeekdays)

Задаёт сокращённые строки названий дней недели. Например: "Sun", "Mon" и т. д.

Параметры:: newShortWeekdays — новые сокращённые строки названий дней недели. Индексы массива должны соответствовать Calendar.SUNDAY, Calendar.MONDAY и т. д.

getAmPmStrings

public String[] getAmPmStrings()

Возвращает строки AM/PM. Например: "AM" и "PM".

Возвращает:: строки AM/PM.

setAmPmStrings

public void setAmPmStrings(String[] newAmpms)

Задаёт строки AM/PM. Например: "AM" и "PM".

Параметры:: 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, не являющийся пользовательским идентификатором. Все остальные элементы — локализованные названия. Если в часовом поясе не используется летнее время, названия для летнего времени применять не следует.

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

Возвращает:

строки часовых поясов.

См. также:

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] — краткое название часового пояса для летнего времени

Параметры:

newZoneStrings — новые строки часовых поясов.

Выбрасывает:

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

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

См. также:

getLocalPatternChars

public String getLocalPatternChars()

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

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

setLocalPatternChars

public void setLocalPatternChars(String newLocalPatternChars)

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

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

clone

public Object clone()

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

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

clone в классе Object

Возвращает:

клона этого экземпляра.

См. также:

hashCode

public int hashCode()

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

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

hashCode в классе Object

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

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

Возвращает:

хеш-код этого DateFormatSymbols

См. также:

equals

public boolean equals(Object obj)

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

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

equals в классе Object

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

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

Параметры:

obj — объект, сравниваемый на равенство

Возвращает:

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

См. также:

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/DateFormatSymbols.html