Класс DateFormatSymbols

DateFormatSymbols — это общедоступный класс для инкапсуляции локально-зависимых данных для форматирования даты и времени, таких как названия месяцев, названия дней недели и данные о часовых поясах. SimpleDateFormat использует DateFormatSymbols для инкапсуляции этой информации.

Как правило, вы не должны использовать DateFormatSymbols напрямую. Вместо этого рекомендуется создавать форматировщик дат и времени с помощью фабричных методов класса DateFormat: getTimeInstance, getDateInstance, или getDateTimeInstance. Эти методы автоматически создают DateFormatSymbols для форматировщика, так что вам не придётся этого делать. После создания форматировщика вы можете изменить его шаблон форматирования, используя метод setPattern. Дополнительную информацию о создании форматировщиков с помощью фабричных методов DateFormat см. в DateFormat.

Если вы решите создать форматировщик дат и времени со специфическим шаблоном форматирования для конкретной локали, вы можете сделать это с помощью:

new SimpleDateFormat(aPattern, DateFormatSymbols.getInstance(aLocale)).

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

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

Конструкторы

DateFormatSymbols

public DateFormatSymbols()

Исключение:

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.

С:

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()

Возвращает:

строки месяцев.

setMonths

public void setMonths(String[] newMonths)

Устанавливает строки месяцев. Например: "Январь", "Февраль" и т.д.

Параметры:

newMonths - новые строки месяцев.

getShortMonths

public String[] getShortMonths()

Возвращает:

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

setShortMonths

public void setShortMonths(String[] newShortMonths)

Устанавливает сокращённые строки месяцев. Например: "янв", "фев" и т.д.

Параметры:

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

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()

Возвращает:

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

См. также:

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] - краткое имя зоны в летнем времени

Параметры:

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