Настройка Форматов

Предыдущий раздел, Используя Предопределенные Форматы, описал стили форматирования, обеспеченные DateFormat class. В большинстве случаев эти предопределенные форматы соответствуют. Однако, если Вы хотите создать свои собственные специализированные форматы, можно использовать SimpleDateFormat class.

Примеры кода, которые следуют, демонстрируют методы SimpleDateFormat class. Можно счесть полный исходный код для примеров в файле названным SimpleDateFormatDemo.

Об Образцах

Когда Вы создаете a SimpleDateFormat объект, Вы определяете образец String. Содержание образца String определите формат даты и время. Для полного описания синтаксиса образца см. таблицы в Синтаксисе Образца Формата Даты.

Следующий код форматирует дату и время согласно образцу String переданный к SimpleDateFormat конструктор. String возвращенный format метод содержит отформатированную дату и время, которые должны быть выведены на экран.

Date today;
String output;
SimpleDateFormat formatter;

formatter = new SimpleDateFormat(pattern, currentLocale);
today = new Date();
output = formatter.format(today);
System.out.println(pattern + " " + output);

Следующая таблица показывает вывод, сгенерированный предыдущим примером кода когда США. Locale определяется:

Образцы и Локаль

SimpleDateFormat class чувствителен к локали. Если Вы инстанцируете SimpleDateFormat без a Locale параметр, это отформатирует дату и время согласно значению по умолчанию Locale. И образец и Locale определите формат. Для того же самого образца, SimpleDateFormat может отформатировать дату и время по-другому если Locale изменяется.

В примере кода, который следует, образец является hardcoded в операторе, который создает SimpleDateFormat объект:

Date today;
String result;
SimpleDateFormat formatter;

formatter = new SimpleDateFormat("EEE d MMM yy", currentLocale);
today = new Date();
result = formatter.format(today);
System.out.println("Locale: " + currentLocale.toString());
System.out.println("Result: " + result);

Когда currentLocale устанавливается в различные значения, предыдущий пример кода генерирует этот вывод:

Locale: fr_FR
Result: mar. 30 juin 09
Locale: de_DE
Result: Di 30 Jun 09
Locale: en_US
Result: Tue 30 Jun 09

Синтаксис Образца Формата даты

Можно разработать свои собственные образцы формата для дат и времена от списка символов в следующей таблице:

Символы, которые не являются буквами, обрабатываются как заключенный в кавычки текст. Таким образом, они появятся в отформатированном тексте, даже если они не будут включены в пределах одинарных кавычек.

Число букв символа, которые Вы определяете также, определяет формат. Например, если "zz" результаты образца в "PDT", то "zzzz" образец генерирует "Тихоокеанское Летнее время." Следующая таблица суммирует эти правила: