Spec-Zone.ru › OpenJDK 17

Класс 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.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 (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.". Подробнее см. Спецификацию элементов календаря в языке разметки данных локали 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)
Устанавливает короткие строки дней недели. Например: "Вск", "Пнд" и т.д.
Параметры:
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(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, не являющийся пользовательским идентификатором.
Параметры:
newZoneStrings — новые строки часовых поясов.
Исключения:
IllegalArgumentException — если длина любой строки в newZoneStrings меньше 5
NullPointerException — если newZoneStrings равно null
См. также:
  • getZoneStrings()

getLocalPatternChars

public String getLocalPatternChars()
Получает локализованные символы шаблонов даты и времени. Например: 'u', 't' и т. д.
Возвращает:
локализованные символы шаблонов даты и времени.

setLocalPatternChars

public void setLocalPatternChars(String newLocalPatternChars)
Устанавливает локализованные символы шаблонов даты и времени. Например: 'u', 't' и т. д.
Параметры:
newLocalPatternChars — новые локализованные символы шаблонов даты и времени.

clone

public Object clone()
Переопределяет Cloneable
Переопределяет:
clone в классе Object
Возвращает:
клонированный экземпляр.
См. также:
  • Cloneable

hashCode

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

equals

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

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

Spec-Zone.ru

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