SimpleDateFormat

public class SimpleDateFormat
extends DateFormat

SimpleDateFormat是用于以区域敏感的方式格式化和解析日期的具体类。 它允许格式化（日期 - >文本），解析（文本 - >日期）和规范化。

SimpleDateFormat允许您首先选择任何用户定义的日期时间格式模式。 不过，建议您创建一个日期-时间格式有两种getTimeInstance ， getDateInstance ，或getDateTimeInstance在DateFormat 。 这些类方法中的每一个都可以返回使用默认格式模式初始化的日期/时间格式化程序。 您可以根据需要使用applyPattern方法修改格式模式。 有关使用这些方法的更多信息，请参阅DateFormat 。

Date and Time Patterns

日期和时间格式由日期和时间模式字符串指定。 在日期和时间模式字符串中，从'A'到'Z'和从'a'到'z'未加引号的字母被解释为表示日期或时间字符串的组成部分的模式字母。 可以使用单引号（ ' ）引用文本以避免解释。 "''"代表一个单引号。 所有其他字符不解释; 它们只是在格式化时被复制到输出字符串中，或者在解析过程中与输入字符串匹配。

定义了以下模式字母（保留从 'A'到 'Z'和从 'a'到 'z'所有其他字符）：

Letter	Date or Time Component	Presentation	Examples
G	Era designator	Text	AD
y	Year	Year	1996; 96
Y	Week year	Year	2009; 09
M	Month in year	Month	July; Jul; 07
w	Week in year	Number	27
W	Week in month	Number	2
D	Day in year	Number	189
d	Day in month	Number	10
F	Day of week in month	Number	2
E	Day name in week	Text	Tuesday; Tue
u	Day number of week (1 = Monday, ..., 7 = Sunday)	Number	1
a	Am/pm marker	Text	PM
H	Hour in day (0-23)	Number	0
k	Hour in day (1-24)	Number	24
K	Hour in am/pm (0-11)	Number	0
h	Hour in am/pm (1-12)	Number	12
m	Minute in hour	Number	30
s	Second in minute	Number	55
S	Millisecond	Number	978
z	Time zone	General time zone	Pacific Standard Time; PST; GMT-08:00
Z	Time zone	RFC 822 time zone	-0800
X	Time zone	ISO 8601 time zone	-08; -0800; -08:00

• Text: For formatting, if the number of pattern letters is 4 or more, the full form is used; otherwise a short or abbreviated form is used if available. For parsing, both forms are accepted, independent of the number of pattern letters.
  
  
• Number: For formatting, the number of pattern letters is the minimum number of digits, and shorter numbers are zero-padded to this amount. For parsing, the number of pattern letters is ignored unless it's needed to separate two adjacent fields.
  
  
• Year: If the formatter's Calendar is the Gregorian calendar, the following rules are applied.
  
  • For formatting, if the number of pattern letters is 2, the year is truncated to 2 digits; otherwise it is interpreted as a number.
  • For parsing, if the number of pattern letters is more than 2, the year is interpreted literally, regardless of the number of digits. So using the pattern "MM/dd/yyyy", "01/11/12" parses to Jan 11, 12 A.D.
  • For parsing with the abbreviated year pattern ("y" or "yy"), SimpleDateFormat must interpret the abbreviated year relative to some century. It does this by adjusting dates to be within 80 years before and 20 years after the time the SimpleDateFormat instance is created. For example, using a pattern of "MM/dd/yy" and a SimpleDateFormat instance created on Jan 1, 1997, the string "01/11/12" would be interpreted as Jan 11, 2012 while the string "05/04/64" would be interpreted as May 4, 1964. During parsing, only strings consisting of exactly two digits, as defined by isDigit(char), will be parsed into the default century. Any other numeric string, such as a one digit string, a three or more digit string, or a two digit string that isn't all digits (for example, "-1"), is interpreted literally. So "01/02/3" or "01/02/003" are parsed, using the same pattern, as Jan 2, 3 AD. Likewise, "01/02/-3" is parsed as Jan 2, 4 BC.
  Otherwise, calendar system specific forms are applied. For both formatting and parsing, if the number of pattern letters is 4 or more, a calendar specific long form is used. Otherwise, a calendar specific short or abbreviated form is used.
  
  If week year 'Y' is specified and the calendar doesn't support any week years, the calendar year ('y') is used instead. The support of week years can be tested with a call to getCalendar().isWeekDateSupported().
  
  
• Month: If the number of pattern letters is 3 or more, the month is interpreted as text; otherwise, it is interpreted as a number.
  
  
• General time zone: Time zones are interpreted as text if they have names. For time zones representing a GMT offset value, the following syntax is used:

       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

  Hours must be between 0 and 23, and Minutes must be between 00 and 59. The format is locale independent and digits must be taken from the Basic Latin block of the Unicode standard.

  对于解析， RFC 822 time zones也被接受。
  
  

• RFC 822 time zone: For formatting, the RFC 822 4-digit time zone format is used:

       RFC822TimeZone:
               Sign TwoDigitHours Minutes
       TwoDigitHours:
               Digit Digit

  TwoDigitHours must be between 00 and 23. Other definitions are as for general time zones.

  为了解析，也接受 general time zones 。

• ISO 8601 Time zone: The number of pattern letters designates the format for both formatting and parsing as follows:

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

  Other definitions are as for general time zones or RFC 822 time zones.

  格式化时，如果GMT的偏移量值为0，则生成"Z" 。 如果模式字母的数量是1，则忽略一小时的任何一小部分。 例如，如果模式为"X" ，时区为"GMT+05:30" ，则生成"+05" 。

  为了解析， "Z"被解析为UTC时区指示符。 不接受General time zones 。

  如果模式字母的数目是4或更多， IllegalArgumentException被构建时抛出 SimpleDateFormat或 applying a pattern 。

Examples

Date and Time Pattern	Result
"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

Synchronization

日期格式不同步。 建议为每个线程创建单独的格式实例。 如果多个线程同时访问一个格式，它必须在外部同步。

Summary

Inherited constants

From class java.text.DateFormat int AM_PM_FIELD AM_PM字段对齐的常用常量。 int DATE_FIELD DATE字段对齐的常用常量。 int DAY_OF_WEEK_FIELD DAY_OF_WEEK字段对齐的常用常量。 int DAY_OF_WEEK_IN_MONTH_FIELD DAY_OF_WEEK_IN_MONTH字段对齐的常用常量。 int DAY_OF_YEAR_FIELD DAY_OF_YEAR字段对齐的常用常量。 int DEFAULT 常量默认样式模式。 int ERA_FIELD ERA字段对齐的常用常数。 int FULL 不变的全样式模式。 int HOUR0_FIELD 基于零的HOUR字段对齐的有用常量。 int HOUR1_FIELD 基于一个小时字段对齐的有用常量。 int HOUR_OF_DAY0_FIELD 基于零的HOUR_OF_DAY字段对齐的有用常量。 int HOUR_OF_DAY1_FIELD 一种基于HOUR_OF_DAY字段对齐的有用常量。 int LONG 用于长型图案的常量。 int MEDIUM 中等风格模式的常量。 int MILLISECOND_FIELD MILLISECOND字段对齐的有用常量。 int MINUTE_FIELD MINUTE字段对齐的常用常量。 int MONTH_FIELD MONTH字段对齐的常用常量。 int SECOND_FIELD SECOND字段对齐的有用常量。 int SHORT 用于短样式的常量。 int TIMEZONE_FIELD TIMEZONE字段对齐的常用常量。 int WEEK_OF_MONTH_FIELD WEEK_OF_MONTH字段对齐的常用常量。 int WEEK_OF_YEAR_FIELD WEEK_OF_YEAR字段对齐的常用常量。 int YEAR_FIELD YEAR字段对齐的常用常量。

Inherited fields
From class java.text.DateFormat protected Calendar calendar 用于计算日期时间字段和时间的 Calendar实例。 protected NumberFormat numberFormat DateFormat用于在日期和时间格式化数字的数字格式器。

Inherited methods
From class java.text.DateFormat Object clone() 覆盖可复制 boolean equals(Object obj) 覆盖等于 final StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition) 覆盖格式。 abstract StringBuffer format(Date date, StringBuffer toAppendTo, FieldPosition fieldPosition) 将日期格式化为日期/时间字符串。 final String format(Date date) 将日期格式化为日期/时间字符串。 static Locale[] getAvailableLocales() 返回 get*Instance方法可返回本地化实例的所有语言环境的数组。 Calendar getCalendar() 获取与此日期/时间格式化程序关联的日历。 static final DateFormat getDateInstance(int style, Locale aLocale) 使用给定语言环境的给定格式样式获取日期格式程序。 static final DateFormat getDateInstance(int style) 获取默认语言环境的给定格式样式的日期格式化程序。 static final DateFormat getDateInstance() 获取默认语言环境的默认格式设置的日期格式化程序。 static final DateFormat getDateTimeInstance(int dateStyle, int timeStyle) 使用默认语言环境的给定日期和时间格式化样式获取日期/时间格式化程序。 static final DateFormat getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale) 使用给定语言环境的给定格式样式获取日期/时间格式器。 static final DateFormat getDateTimeInstance() 获取默认语言环境的默认格式样式的日期/时间格式化程序。 static final DateFormat getInstance() 获取日期和时间都使用SHORT样式的默认日期/时间格式器。 NumberFormat getNumberFormat() 获取此日期/时间格式化程序用于格式化和解析时间的数字格式化程序。 static final DateFormat getTimeInstance(int style) 使用默认语言环境的给定格式样式获取时间格式器。 static final DateFormat getTimeInstance(int style, Locale aLocale) 使用给定语言环境的给定格式样式获取时间格式器。 static final DateFormat getTimeInstance() 获取默认语言环境的默认格式样式的时间格式化程序。 TimeZone getTimeZone() 获取时区。 int hashCode() 重写hashCode boolean isLenient() 告诉日期/时间解析是否宽松。 Date parse(String source) 从给定字符串的开头解析文本以生成日期。 abstract Date parse(String source, ParsePosition pos) 根据给定的解析位置解析日期/时间字符串。 Object parseObject(String source, ParsePosition pos) 分析字符串中的文本以生成 Date 。 void setCalendar(Calendar newCalendar) 设置该日期格式使用的日历。 void setLenient(boolean lenient) 指定日期/时间解析是否是宽松的。 void setNumberFormat(NumberFormat newNumberFormat) 允许您设置数字格式器。 void setTimeZone(TimeZone zone) 设置此 DateFormat对象的日历的时区。
From class java.text.Format Object clone() 创建并返回此对象的副本。 final String format(Object obj) 格式化一个对象来产生一个字符串。 abstract StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition pos) 格式化对象并将结果文本附加到给定的字符串缓冲区。 AttributedCharacterIterator formatToCharacterIterator(Object obj) 格式化产生 AttributedCharacterIterator的对象。 Object parseObject(String source) 从给定字符串的开头解析文本以生成一个对象。 abstract Object parseObject(String source, ParsePosition pos) 分析字符串中的文本以生成对象。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

SimpleDateFormat ()

SimpleDateFormat (String pattern)

SimpleDateFormat (String pattern, 
                Locale locale)

SimpleDateFormat (String pattern, 
                DateFormatSymbols formatSymbols)

Public methods

void applyLocalizedPattern (String pattern)

void applyPattern (String pattern)

Object clone ()

boolean equals (Object obj)

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

AttributedCharacterIterator formatToCharacterIterator (Object obj)

Date get2DigitYearStart ()

DateFormatSymbols getDateFormatSymbols ()

int hashCode ()

Date parse (String text, 
                ParsePosition pos)

void set2DigitYearStart (Date startDate)

void setDateFormatSymbols (DateFormatSymbols newFormatSymbols)

String toLocalizedPattern ()

String toPattern ()