Класс 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()`	Возвращает строки для обозначения времени до и после полудня.
`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)`	Задает строки с названиями часовых поясов.

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

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

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно после вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно после вызова метода notify или interrupt либо до истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно после вызова метода notify или interrupt либо до истечения определенного промежутка реального времени.

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

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 — если ресурсы для указанной локали не найдены или не могут быть загружены.

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

См. также:

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

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" и т. д. Возвращается массив из 12 или 13 элементов в зависимости от того, поддерживается ли Calendar.UNDECIMBER. Для индексации результирующего массива используйте 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" и т. д. Возвращается массив из 12 или 13 элементов в зависимости от того, поддерживается ли Calendar.UNDECIMBER. Для индексации результирующего массива используйте 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".

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

setAmPmStrings

public void setAmPmStrings(String[] newAmpms)

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

Параметры:: newAmpms — новые строки для обозначения времени до и после полудня.

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.