Класс 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 DateFormatSymbols getInstance()

Возвращает экземпляр DateFormatSymbols для локали по умолчанию.
static 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.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". Дополнительные сведения см. в спецификации Calendar Elements в Unicode Locale Data Markup Language (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 Locale Data Markup Language (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, 2020, 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/11/docs/api/java.base/java/text/DateFormatSymbols.html

Spec-Zone .ru
спецификации, руководства, описания, API