public class SimpleDateFormat extends DateFormat
SimpleDateFormatis a concrete class for formatting and parsing dates in a locale-sensitive manner. It allows for formatting (date → text), parsing (text → date), and normalization.
SimpleDateFormat allows you to start by choosing any user-defined patterns for date-time formatting.
However, you are encouraged to create a date-time formatter with either
DateFormat. Each of these class
methods can return a date/time formatter initialized with a default format pattern. You may modify the format pattern
applyPattern methods as desired. For more information on using these methods, see
Date and time formats are specified by date and time pattern strings. Within date and time pattern strings,
unquoted letters from
'Z' and from
interpreted as pattern letters representing the components of a date or time string. Text can be quoted using single
') to avoid interpretation.
"''" represents a single quote. All other characters
are not interpreted; they're simply copied into the output string during formatting or matched against the input
string during parsing.
The following pattern letters are defined (all other characters from
'Z' and from
'z' are reserved):
Pattern letters are usually repeated, as their number determines the exact presentation:
Letter Date or Time Component Presentation Examples
Era designator Text
Week year Year
Month in year Month
Week in year Number
Week in month Number
Day in year Number
Day in month Number
Day of week in month Number
Day name in week Text
Day number of week (1 = Monday, ..., 7 = Sunday) Number
Am/pm marker Text
Hour in day (0-23) Number
Hour in day (1-24) Number
Hour in am/pm (0-11) Number
Hour in am/pm (1-12) Number
Minute in hour Number
Second in minute Number
Calendaris the Gregorian calendar, the following rules are applied.
SimpleDateFormatmust 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
SimpleDateFormatinstance is created. For example, using a pattern of "MM/dd/yy" and a
SimpleDateFormatinstance 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
Character.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.
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
"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
Date formats are not synchronized. It is recommended to create separate format instances for each thread. If multiple threads access a format concurrently, it must be synchronized externally.
|Constructor and Description|
|Modifier and Type||Method and Description|
Applies the given pattern string to this date format.
Formats a Date into a date/time string.
Gets a copy of the date and time format symbols of this date format.
Sets the date and time format symbols of this date format.
Returns a pattern string describing this date format.
getCalendar, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getTimeInstance, getTimeInstance, setCalendar
SimpleDateFormatusing the default pattern and date format symbols. Note: This constructor may not support all locales. For full coverage, use the factory methods in the
public SimpleDateFormat(String pattern)
SimpleDateFormatusing the given pattern and the default date format symbols. For full coverage, use the factory methods in the
This is equivalent to calling.
public SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols)
SimpleDateFormatusing the given pattern and date format symbols.
public void applyPattern(String pattern)
public DateFormatSymbols getDateFormatSymbols()
public void setDateFormatSymbols(DateFormatSymbols newFormatSymbols)
public String toPattern()