java.text

Класс SimpleDateFormat

java.lang. Объект

java.text. Формат

java.text. DateFormat

java.text. SimpleDateFormat

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

public class SimpleDateFormat
extends DateFormat

SimpleDateFormat реальный класс для форматирования и парсинга дат чувствительным к локали способом. Это учитывает форматирование (дата-> текст), анализируя (текст-> дата), и нормализация.

SimpleDateFormat позволяет Вам запускать, выбирая любые определяемые пользователем образцы для разового датой форматирования. Однако, Вы поощряетесь создать разовое датой средство форматирования с также getTimeInstance, getDateInstance, или getDateTimeInstance в DateFormat. Каждый из этих методов класса может возвратить средство форматирования даты/времени, инициализированное с образцом формата по умолчанию. Можно изменить образец формата, используя applyPattern методы как требующийся. Для получения дополнительной информации об использовании этих методов см. DateFormat.

Дата и Образцы Времени

Дата и форматы времени определяются по времени и строки образца времени. В пределах даты и строк образца времени, закрывших кавычки букв от 'A' к 'Z' и от 'a' к 'z' интерпретируются как буквы образца, представляющие компоненты строки времени или даты. Текст может быть заключен в кавычки, используя одинарные кавычки (') избегать интерпретации. "''" представляет одинарную кавычку. Все другие символы не интерпретируются; они просто копируются в выходную строку во время форматирования или соответствующие против строки ввода во время парсинга.

Следующие буквы образца определяются (все другие символы от 'A' к 'Z' и от 'a' к 'z' резервируются):

Буква	Дата или Компонент Времени	Представление	Примеры
G	Указатель эры	Текст	AD
y	Год	Год	1996; 96
Y	Недельный год	Год	2009; 09
M	Месяц в году	Месяц	July; Jul; 07
w	Неделя в году	Число	27
W	Неделя в месяце	Число	2
D	День в году	Число	189
d	День в месяце	Число	10
F	День недели в месяце	Число	2
E	Дневное имя на неделе	Текст	Tuesday; Tue
u	Дневное число недели (1 = в понедельник..., 7 = в воскресенье)	Число	1
a	/пополудни маркер	Текст	PM
H	Час в день (0-23)	Число	0
k	Час в день (1-24)	Число	24
K	Час в/пополудни (0-11)	Число	0
h	Час в/пополудни (1-12)	Число	12
m	Минута в час	Число	30
s	Второй в минуту	Число	55
S	Миллисекунда	Число	978
z	Часовой пояс	Общий часовой пояс	Pacific Standard Time; PST; GMT-08:00
Z	Часовой пояс	Часовой пояс RFC 822	-0800
X	Часовой пояс	Часовой пояс ISO 8601	-08; -0800; -08:00

Буквы образца обычно повторяются, поскольку их число определяет точное представление:

• Текст: Для того, чтобы отформатировать, если число букв образца 4 или больше, используется полная форма; иначе краткая форма или сокращенная форма используются при наличии. Для того, чтобы проанализировать, обе формы принимаются, независимы от числа букв образца.
  
  
• Число: Для того, чтобы отформатировать, число букв образца является минимальным числом цифр, и более короткие числа дополняются нулем к этому количеству. Для того, чтобы проанализировать, игнорируется число букв образца, если не необходимо разделить два смежных поля.
  
  
• Год: Если средство форматирования Calendar Григорианский календарь, следующие правила применяются.
  
  • Для того, чтобы отформатировать, если число букв образца 2, год является усеченным к 2 цифрам; иначе это интерпретируется как число.
  • Для того, чтобы проанализировать, если число букв образца - больше чем 2, год интерпретируется буквально, независимо от числа цифр. Так используя образец "MM/dd/yyyy", "01/11/12" анализирует Яну 11, 12 нашей эры.
  • Для того, чтобы проанализировать с сокращенным образцом года ("y" или "yy"), SimpleDateFormat должен интерпретировать сокращенный год относительно некоторого столетия. Это делает это, корректируя даты, чтобы быть в течение 80 лет прежде и спустя 20 лет после времени SimpleDateFormat экземпляр создается. Например, используя образец "MM/dd/yy" и a SimpleDateFormat экземпляр, создаваемый на Яне 1, 1997, строка "01/11/12", был бы интерпретирован как Ян 11, 2012, в то время как строка "05/04/64" будет интерпретироваться как 4 мая 1964. Во время парсинга, только строки, состоящие точно из двух цифр, как определено Character.isDigit(char), будет проанализирован в столетие по умолчанию. Любая другая числовая строка, такая как одна строка цифры, три или больше строки цифры, или две строки цифры, которые не являются всеми цифрами (например, "-1"), интерпретируется буквально. Таким образом, "01/02/3" или "01/02/003" анализируются, используя тот же самый образец, как Ян 2, 3 AD. Аналогично, "01/02/-3" анализируется как Ян 2, 4 BC.
  Иначе, календарная система определенные формы применяется. И для форматирования и для парсинга, если число букв образца 4 или больше, календарь, используется определенная подробная форма. Иначе, календарь определенная краткая форма или сокращенная форма используется.
  
  Если недельный год 'Y' определяется и календарь не поддерживает недельных лет, календарного года ('y') используется вместо этого. Поддержка недельных лет может быть протестирована со звонком getCalendar().isWeekDateSupported().
  
  
• Месяц: Если число букв образца 3 или больше, месяц интерпретируется как текст; иначе, это интерпретируется как число.
  
  
• Общий часовой пояс: Часовые пояса интерпретируются как текст, если у них есть имена. Для часовых поясов, представляющих значение смещения GMT, используется следующий синтаксис:

       GMTOffsetTimeZone:
               GMT Sign Hours : Minutes
       Sign: one of
               + -
       Hours:
               Digit
               Digit Digit
       Minutes:
               Digit Digit
       Digit: one of
               0 1 2 3 4 5 6 7 8 9

  Часы должны быть между 0 и 23, и Минуты должны быть между 00 и 59. Формат является независимой локалью, и цифры должны быть взяты от Основного латинского блока стандарта Unicode.

  Для парсинга также принимаются часовые пояса RFC 822.
  
  

• Часовой пояс RFC 822: Для того, чтобы отформатировать, RFC 822 используется 4-разрядный формат часового пояса:

       RFC822TimeZone:
               Sign TwoDigitHours Minutes
       TwoDigitHours:
               Digit Digit

  TwoDigitHours должен быть между 00 и 23. Другие определения что касается общих часовых поясов.

  Для того, чтобы проанализировать, также принимаются общие часовые пояса.

• Часовой пояс ISO 8601: число букв образца определяет формат и для форматирования и для парсинга следующим образом:

       ISO8601TimeZone:
               OneLetterISO8601TimeZone
               TwoLetterISO8601TimeZone
               ThreeLetterISO8601TimeZone
       OneLetterISO8601TimeZone:
               Sign TwoDigitHours
               Z
       TwoLetterISO8601TimeZone:
               Sign TwoDigitHours Minutes
               Z
       ThreeLetterISO8601TimeZone:
               Sign TwoDigitHours : Minutes
               Z

  Другие определения что касается общих часовых поясов или часовых поясов RFC 822.

  Для того, чтобы отформатировать, если значение смещения от GMT 0, "Z" производится. Если число букв образца 1, любая часть часа игнорируется. Например, если образец "X" и часовой пояс "GMT+05:30", "+05" производится.

  Для того, чтобы проанализировать, "Z" анализируется как указатель часового пояса UTC. Общие часовые пояса не принимаются.

  Если число букв образца 4 или больше, IllegalArgumentException бросается, создавая a SimpleDateFormat или применение образца.

SimpleDateFormat также поддерживает локализованную дату и строки образца времени. В этих строках буквы образца, описанные выше, могут быть заменены другим, зависимая локаль, буквы образца. SimpleDateFormat не имеет дело с локализацией текста кроме букв образца; это до клиента класса.

Примеры

Следующие примеры показывают, как дата и образцы времени интерпретируются в американской локали. Данная дата и время составляет 04.07.2001 местного времени 12:08:56 в американском часовом поясе Тихоокеанского времени.

Дата и Образец Времени	Результат
"yyyy.MM.dd G 'at' HH:mm:ss z"	2001.07.04 AD at 12:08:56 PDT
"EEE, MMM d, ''yy"	Wed, Jul 4, '01
"h:mm a"	12:08 PM
"hh 'o''clock' a, zzzz"	12 o'clock PM, Pacific Daylight Time
"K:mm a, z"	0:08 PM, PDT
"yyyyy.MMMMM.dd GGG hh:mm aaa"	02001.July.04 AD 12:08 PM
"EEE, d MMM yyyy HH:mm:ss Z"	Wed, 4 Jul 2001 12:08:56 -0700
"yyMMddHHmmssZ"	010704120856-0700
"yyyy-MM-dd'T'HH:mm:ss.SSSZ"	2001-07-04T12:08:56.235-0700
"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"	2001-07-04T12:08:56.235-07:00
"YYYY-'W'ww-u"	2001-W27-3

Синхронизация

Форматы даты не синхронизируются. Рекомендуется создать отдельные экземпляры формата для каждого потока. Если многократные потоки получают доступ к формату одновременно, он должен синхронизироваться внешне.

См. Также:

Учебное руководство по Java, Calendar, TimeZone, DateFormat, DateFormatSymbols, Сериализированная Форма

Вложенная Сводка Класса

Вложенные классы/интерфейсы java.text унаследованный от класса. DateFormat

DateFormat. Поле

Полевая Сводка

Поля java.text унаследованный от класса. DateFormat

AM_PM_FIELD, calendar, DATE_FIELD, DAY_OF_WEEK_FIELD, DAY_OF_WEEK_IN_MONTH_FIELD, DAY_OF_YEAR_FIELD, DEFAULT, ERA_FIELD, FULL, HOUR_OF_DAY0_FIELD, HOUR_OF_DAY1_FIELD, HOUR0_FIELD, HOUR1_FIELD, LONG, MEDIUM, MILLISECOND_FIELD, MINUTE_FIELD, MONTH_FIELD, numberFormat, SECOND_FIELD, SHORT, TIMEZONE_FIELD, WEEK_OF_MONTH_FIELD, WEEK_OF_YEAR_FIELD, YEAR_FIELD

Сводка конструктора

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

Конструктор и Описание
SimpleDateFormat() Конструкции a SimpleDateFormat использование образца по умолчанию и даты форматирует символы для локали по умолчанию.
SimpleDateFormat(String pattern) Конструкции a SimpleDateFormat использование данного образца и даты по умолчанию форматирует символы для локали по умолчанию.
SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols) Конструкции a SimpleDateFormat использование данного образца и даты форматирует символы.
SimpleDateFormat(String pattern, Locale locale) Конструкции a SimpleDateFormat использование данного образца и даты по умолчанию форматирует символы для данной локали.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	applyLocalizedPattern(String pattern) Применяет данную локализованную строку образца к этому формату даты.
void	applyPattern(String pattern) Применяет данную строку образца к этому формату даты.
Объект	clone() Создает копию этого SimpleDateFormat.
boolean	equals(Object obj) Сравнивает данный объект с этим SimpleDateFormat для равенства.
StringBuffer	format(Date date, StringBuffer toAppendTo, FieldPosition pos) Форматирует данный Date в строку даты/времени и добавляет результат к данному StringBuffer.
AttributedCharacterIterator	formatToCharacterIterator(Object obj) Форматирует Объект, производящий AttributedCharacterIterator.
Дата	get2DigitYearStart() Возвращает начинающуюся дату 100-летнего периода, в пределах которого 2-разрядные годы интерпретируются как являющийся.
DateFormatSymbols	getDateFormatSymbols() Получает копию даты и символы формата времени этого формата даты.
int	hashCode() Возвращает значение хэш-кода для этого SimpleDateFormat объект.
Дата	parse(String text, ParsePosition pos) Текст синтаксических анализов от строки, чтобы произвести a Date.
void	set2DigitYearStart(Date startDate) Устанавливает 100-летний период, в котором 2-разрядные годы будут интерпретироваться как являющийся начаться в день, пользователь определяет.
void	setDateFormatSymbols(DateFormatSymbols newFormatSymbols) Назначает дату и символы формата времени этого формата даты.
Строка	toLocalizedPattern() Возвращает локализованную строку образца, описывающую этот формат даты.
Строка	toPattern() Возвращает строку образца, описывающую этот формат даты.

Методы java.text унаследованный от класса. DateFormat

format, format, getAvailableLocales, getCalendar, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getNumberFormat, getTimeInstance, getTimeInstance, getTimeInstance, getTimeZone, isLenient, parse, parseObject, setCalendar, setLenient, setNumberFormat, setTimeZone

Методы java.text унаследованный от класса. Формат

format, parseObject

Методы java.lang унаследованный от класса. Объект

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

SimpleDateFormat

public SimpleDateFormat()

Конструкции a SimpleDateFormat использование образца по умолчанию и даты форматирует символы для локали по умолчанию. Отметьте: Этот конструктор, возможно, не поддерживает все локали. Для полного охвата используйте методы фабрики в DateFormat класс.

SimpleDateFormat

public SimpleDateFormat(String pattern)

Конструкции a SimpleDateFormat использование данного образца и даты по умолчанию форматирует символы для локали по умолчанию. Отметьте: Этот конструктор, возможно, не поддерживает все локали. Для полного охвата используйте методы фабрики в DateFormat класс.

Параметры:

pattern - образец, описывающий дату и формат времени

Броски:

NullPointerException - если данный образец является нулем

IllegalArgumentException - если данный образец недопустим

SimpleDateFormat

public SimpleDateFormat(String pattern,
                Locale locale)

Конструкции a SimpleDateFormat использование данного образца и даты по умолчанию форматирует символы для данной локали. Отметьте: Этот конструктор, возможно, не поддерживает все локали. Для полного охвата используйте методы фабрики в DateFormat класс.

Параметры:

pattern - образец, описывающий дату и формат времени

locale - локаль, символы формата даты которой должны использоваться

Броски:

NullPointerException - если данный образец или локаль являются нулем

IllegalArgumentException - если данный образец недопустим

SimpleDateFormat

public SimpleDateFormat(String pattern,
                DateFormatSymbols formatSymbols)

Конструкции a SimpleDateFormat использование данного образца и даты форматирует символы.

Параметры:

pattern - образец, описывающий дату и формат времени

formatSymbols - символы формата даты, которые будут использоваться для того, чтобы отформатировать

Броски:

NullPointerException - если данный образец или formatSymbols являются нулем

IllegalArgumentException - если данный образец недопустим

Деталь метода

set2DigitYearStart

public void set2DigitYearStart(Date startDate)

Устанавливает 100-летний период, в котором 2-разрядные годы будут интерпретироваться как являющийся начаться в день, пользователь определяет.

Параметры:

startDate - Во время парсинга два года цифры будут помещены в диапазон startDate к startDate + 100 years.

С тех пор:

1.2

См. Также:

get2DigitYearStart()

get2DigitYearStart

public Date get2DigitYearStart()

Возвращает начинающуюся дату 100-летнего периода, в пределах которого 2-разрядные годы интерпретируются как являющийся.

Возвраты:

запуск 100-летнего периода, в который анализируются два года цифры

С тех пор:

1.2

См. Также:

set2DigitYearStart(java.util.Date)

формат

public StringBuffer format(Date date,
                  StringBuffer toAppendTo,
                  FieldPosition pos)

Форматирует данный Date в строку даты/времени и добавляет результат к данному StringBuffer.

Определенный:

format в классе DateFormat

Параметры:

date - разовое датой значение, которое будет отформатировано в разовую датой строку.

toAppendTo - где новый разовый датой текст должен быть добавлен.

pos - позиция форматирования. На вводе: поле выравнивания, при желании. На выводе: смещения поля выравнивания.

Возвраты:

отформатированная разовая датой строка.

Броски:

NullPointerException - если данный date null.

formatToCharacterIterator

public AttributedCharacterIterator formatToCharacterIterator(Object obj)

Форматирует Объект, производящий AttributedCharacterIterator. Можно использовать возвращенный AttributedCharacterIterator создать получающуюся Строку, так же как определить информацию о получающейся Строке.

Каждый ключ атрибута AttributedCharacterIterator будет иметь тип DateFormat.Field, с соответствующим значением атрибута, являющимся тем же самым как ключ атрибута.

Переопределения:

formatToCharacterIterator в классе Format

Параметры:

obj - Объект отформатировать

Возвраты:

AttributedCharacterIterator, описывающий отформатированное значение.

Броски:

NullPointerException - если obj является нулем.

IllegalArgumentException - если Формат не может отформатировать данный объект, или если строка образца Формата недопустима.

С тех пор:

1.4

синтаксический анализ

public Date parse(String text,
         ParsePosition pos)

Текст синтаксических анализов от строки, чтобы произвести a Date.

Метод пытается проанализировать текст, запускающийся по индексу, данному pos. Если парсинг успешно выполняется, то индекс pos обновляется к индексу после используемого последнего знака (парсинг не обязательно израсходовал все символы до конца строки), и проанализированная дата возвращается. Обновленный pos может использоваться, чтобы указать на начальную точку для следующего звонка в этот метод. Если ошибка происходит, то индекс pos не изменяется, ошибочный индекс pos устанавливается в индекс символа, где ошибка произошла, и нуль возвращается.

Эта работа парсинга использует calendar произвести a Date. Весь из calendar's разовые датой поля очищаются перед парсингом, и calendar's значения по умолчанию разовых датой полей используются для любой недостающей разовой датой информации. Например, значение года проанализированного Date 1970 с GregorianCalendar если никакое значение года не дается от работы парсинга. TimeZone значение может быть перезаписано, в зависимости от поданного образца и значения часового пояса text. Любой TimeZone значение, которое было ранее установлено звонком setTimeZone возможно, должен быть восстановлен для дальнейших операций.

Определенный:

parse в классе DateFormat

Параметры:

text - A String, часть которого должна быть проанализирована.

pos - A ParsePosition объект с индексом и ошибкой индексирует информацию как описано выше.

Возвраты:

A Date проанализированный от строки. В случае ошибки, нуля возвратов.

Броски:

NullPointerException - если text или pos нуль.

toPattern

public String toPattern()

Возвращает строку образца, описывающую этот формат даты.

Возвраты:

строка образца, описывающая этот формат даты.

toLocalizedPattern

public String toLocalizedPattern()

Возвращает локализованную строку образца, описывающую этот формат даты.

Возвраты:

локализованная строка образца, описывающая этот формат даты.

applyPattern

public void applyPattern(String pattern)

Применяет данную строку образца к этому формату даты.

Параметры:

pattern - новая дата и образец времени для этого формата даты

Броски:

NullPointerException - если данный образец является нулем

IllegalArgumentException - если данный образец недопустим

applyLocalizedPattern

public void applyLocalizedPattern(String pattern)

Применяет данную локализованную строку образца к этому формату даты.

Параметры:

pattern - Строка, которая будет отображена на новую дату и время, форматирует образец для этого формата

Броски:

NullPointerException - если данный образец является нулем

IllegalArgumentException - если данный образец недопустим

getDateFormatSymbols

public DateFormatSymbols getDateFormatSymbols()

Получает копию даты и символы формата времени этого формата даты.

Возвраты:

дата и время форматирует символы этого формата даты

См. Также:

setDateFormatSymbols(java.text.DateFormatSymbols)

setDateFormatSymbols

public void setDateFormatSymbols(DateFormatSymbols newFormatSymbols)

Назначает дату и символы формата времени этого формата даты.

Параметры:

newFormatSymbols - новая дата и время форматирует символы

Броски:

NullPointerException - если данный newFormatSymbols является нулем

См. Также:

getDateFormatSymbols()

клон

public Object clone()

Создает копию этого SimpleDateFormat. Это также клонирует символы формата даты формата.

Переопределения:

clone в классе DateFormat

Возвраты:

клон этого SimpleDateFormat

См. Также:

Cloneable

хэш-код

public int hashCode()

Возвращает значение хэш-кода для этого SimpleDateFormat объект.

Переопределения:

hashCode в классе DateFormat

Возвраты:

значение хэш-кода для этого SimpleDateFormat объект.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

равняется

public boolean equals(Object obj)

Сравнивает данный объект с этим SimpleDateFormat для равенства.

Переопределения:

equals в классе DateFormat

Параметры:

obj - ссылочный объект, с которым можно сравниться.

Возвраты:

истина, если данный объект равен этому SimpleDateFormat

См. Также:

Object.hashCode(), HashMap