Spec-Zone.ru › OpenJDK 21

Класс 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
См. также:
  • DateFormat
  • SimpleDateFormat
  • SimpleTimeZone
  • Сериализованная форма

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

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

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

Модификатор и тип Метод Описание
Object clone()
Переопределяет Cloneable
boolean equals(Object obj)
Переопределяет equals
String[] getAmPmStrings()
Получает строки ampm.
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()
Переопределяет hashCode.
void setAmPmStrings(String[] newAmpms)
Устанавливает строки ampm.
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 - если ресурсы для локали по умолчанию не найдены или не могут быть загружены.
См. также:
  • getInstance()
  • Locale.getDefault(java.util.Locale.Category)
  • Locale.Category.FORMAT

DateFormatSymbols

public DateFormatSymbols(Locale locale)
Создаёт объект DateFormatSymbols, загружая данные формата из ресурсов для заданной локали. Этот конструктор может создавать экземпляры только для локалей, поддерживаемых средой выполнения Java, а не для тех, которые поддерживаются установленными реализациями DateFormatSymbolsProvider. Для полной поддержки локалей используйте метод getInstance.
Параметры:
locale - требуемая локаль
Используется:
MissingResourceException - если ресурсы для указанной локали не найдены или не могут быть загружены.
См. также:
  • getInstance(Locale)

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

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
См. также:
  • Locale.getDefault(java.util.Locale.Category)
  • Locale.Category.FORMAT

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". Подробнее см. Элементы календаря в спецификации Unicode Locale Data Markup Language (LDML).

Требования к реализации:
Этот метод возвращает 13 элементов, так как поддерживается Calendar.UNDECIMBER.
Возвращает:
строки месяцев.
Внешние спецификации
  • Unicode Locale Data Markup Language (LDML)

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.". Подробнее см. Элементы календаря в спецификации Unicode Locale Data Markup Language (LDML).

Требования к реализации:
Этот метод возвращает 13 элементов, так как поддерживается Calendar.UNDECIMBER.
Возвращает:
короткие строки месяцев.
Внешние спецификации
  • Unicode Locale Data Markup Language (LDML)

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)
Устанавливает короткие строки дней недели. Например: "Вск", "Пнд" и т.д.
Параметры:
newShortWeekdays - новые короткие строки дней недели. Массив должен быть индексирован с помощью Calendar.SUNDAY, Calendar.MONDAY и т.д.

getAmPmStrings

public String[] getAmPmStrings()
Возвращает строки AM/PM. Например: "AM" и "PM".
Возвращает:
строки AM/PM.

setAmPmStrings

public void setAmPmStrings(String[] newAmpms)
Устанавливает строки ам/пм. Например: "AM" и "PM".
Parameters:
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 runtime и установленными реализациями TimeZoneNameProvider.

Returns:
строки часовых поясов.
See Also:
  • setZoneStrings(String[][])

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:
  • getZoneStrings()

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:
  • Cloneable

hashCode

public int hashCode()
Переопределяет hashCode. Генерирует хеш-код для объекта DateFormatSymbols.
Overrides:
hashCode в классе Object
Returns:
значение хеш-кода для этого объекта.
See Also:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)
Переопределяет equals
Overrides:
equals в классе Object
Parameters:
obj - объект-ссылка для сравнения.
Returns:
true, если этот объект такой же, как аргумент obj; false в противном случае.
See Also:
  • Object.hashCode()
  • HashMap

© 1993, 2023, 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/21/docs/api/java.base/java/text/DateFormatSymbols.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API