File	Doc	Category	Size	Date	Package
SimpleDateFormat.java	API Doc	Java SE 6 API	78569	Tue Jun 10 00:25:52 BST 2008	java.text

SimpleDateFormat

• java.lang.Object
  • java.text.Format
    • java.text.DateFormat

Fields Summary
static final long	serialVersionUID
static final int	currentSerialVersion
private int	serialVersionOnStream The version of the serialized data on the stream. Possible values: 0 or not present on stream: JDK 1.1.3. This version has no defaultCenturyStart on stream. 1 JDK 1.1.4 or later. This version adds defaultCenturyStart. When streaming out this class, the most recent format and the highest allowable serialVersionOnStream is written.
private String	pattern The pattern string of this formatter. This is always a non-localized pattern. May not be null. See class documentation for details.
private transient char[]	compiledPattern The compiled pattern.
private static final int	TAG_QUOTE_ASCII_CHAR Tags for the compiled pattern.
private static final int	TAG_QUOTE_CHARS
private transient char	zeroDigit Locale dependent digit zero.
private DateFormatSymbols	formatData The symbols used by this formatter for week names, month names, etc. May not be null.
private Date	defaultCenturyStart We map dates with two-digit years into the century starting at defaultCenturyStart, which may be any date. May not be null.
private transient int	defaultCenturyStartYear
private static final int	millisPerHour
private static final int	millisPerMinute
private static final String	GMT
private static Hashtable	cachedLocaleData Cache to hold the DateTimePatterns of a Locale.
private static Hashtable	cachedNumberFormatData Cache NumberFormat instances with Locale key.
private Locale	locale The Locale used to instantiate this SimpleDateFormat. The value may be null if this object has been created by an older SimpleDateFormat and deserialized.
transient boolean	useDateFormatSymbols Indicates whether this SimpleDateFormat should use the DateFormatSymbols. If true, the format and parse methods use the DateFormatSymbols values. If false, the format and parse methods call Calendar.getDisplayName or Calendar.getDisplayNames.
private static final int[]	PATTERN_INDEX_TO_CALENDAR_FIELD
private static final int[]	PATTERN_INDEX_TO_DATE_FORMAT_FIELD
private static final Field[]	PATTERN_INDEX_TO_DATE_FORMAT_FIELD_ID

Constructors Summary
public SimpleDateFormat() Constructs a SimpleDateFormat using the default pattern and date format symbols for the default locale. Note: This constructor may not support all locales. For full coverage, use the factory methods in the {@link DateFormat} class. this(SHORT, SHORT, Locale.getDefault());
public SimpleDateFormat(String pattern) Constructs a SimpleDateFormat using the given pattern and the default date format symbols for the default locale. Note: This constructor may not support all locales. For full coverage, use the factory methods in the {@link DateFormat} class. param pattern the pattern describing the date and time format exception NullPointerException if the given pattern is null exception IllegalArgumentException if the given pattern is invalid this(pattern, Locale.getDefault());
public SimpleDateFormat(String pattern, Locale locale) Constructs a SimpleDateFormat using the given pattern and the default date format symbols for the given locale. Note: This constructor may not support all locales. For full coverage, use the factory methods in the {@link DateFormat} class. param pattern the pattern describing the date and time format param locale the locale whose date format symbols should be used exception NullPointerException if the given pattern or locale is null exception IllegalArgumentException if the given pattern is invalid if (pattern == null || locale == null) { throw new NullPointerException(); } initializeCalendar(locale); this.pattern = pattern; this.formatData = DateFormatSymbols.getInstance(locale); this.locale = locale; initialize(locale);
public SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols) Constructs a SimpleDateFormat using the given pattern and date format symbols. param pattern the pattern describing the date and time format param formatSymbols the date format symbols to be used for formatting exception NullPointerException if the given pattern or formatSymbols is null exception IllegalArgumentException if the given pattern is invalid if (pattern == null || formatSymbols == null) { throw new NullPointerException(); } this.pattern = pattern; this.formatData = (DateFormatSymbols) formatSymbols.clone(); this.locale = Locale.getDefault(); initializeCalendar(this.locale); initialize(this.locale); useDateFormatSymbols = true;
SimpleDateFormat(int timeStyle, int dateStyle, Locale loc) if (loc == null) { throw new NullPointerException(); } this.locale = loc; // initialize calendar and related fields initializeCalendar(loc); /* try the cache first */ String key = getKey(); String[] dateTimePatterns = cachedLocaleData.get(key); if (dateTimePatterns == null) { /* cache miss */ ResourceBundle r = LocaleData.getDateFormatData(loc); if (!isGregorianCalendar()) { try { dateTimePatterns = r.getStringArray(getCalendarName() + ".DateTimePatterns"); } catch (MissingResourceException e) { } } if (dateTimePatterns == null) { dateTimePatterns = r.getStringArray("DateTimePatterns"); } /* update cache */ cachedLocaleData.put(key, dateTimePatterns); } formatData = DateFormatSymbols.getInstance(loc); if ((timeStyle >= 0) && (dateStyle >= 0)) { Object[] dateTimeArgs = {dateTimePatterns[timeStyle], dateTimePatterns[dateStyle + 4]}; pattern = MessageFormat.format(dateTimePatterns[8], dateTimeArgs); } else if (timeStyle >= 0) { pattern = dateTimePatterns[timeStyle]; } else if (dateStyle >= 0) { pattern = dateTimePatterns[dateStyle + 4]; } else { throw new IllegalArgumentException("No date or time style specified"); } initialize(loc);

Methods Summary
public void	applyLocalizedPattern(java.lang.String pattern) Applies the given localized pattern string to this date format. param pattern a String to be mapped to the new date and time format pattern for this format exception NullPointerException if the given pattern is null exception IllegalArgumentException if the given pattern is invalid String p = translatePattern(pattern, formatData.getLocalPatternChars(), DateFormatSymbols.patternChars); compiledPattern = compile(p); this.pattern = p;
public void	applyPattern(java.lang.String pattern) Applies the given pattern string to this date format. param pattern the new date and time pattern for this date format exception NullPointerException if the given pattern is null exception IllegalArgumentException if the given pattern is invalid compiledPattern = compile(pattern); this.pattern = pattern;
public java.lang.Object	clone() Creates a copy of this SimpleDateFormat. This also clones the format's date format symbols. return a clone of this SimpleDateFormat SimpleDateFormat other = (SimpleDateFormat) super.clone(); other.formatData = (DateFormatSymbols) formatData.clone(); return other;
private char[]	compile(java.lang.String pattern) Returns the compiled form of the given pattern. The syntax of the compiled pattern is: CompiledPattern: EntryList EntryList: Entry EntryList Entry Entry: TagField TagField data TagField: Tag Length TaggedData Tag: pattern_char_index TAG_QUOTE_CHARS Length: short_length long_length TaggedData: TAG_QUOTE_ASCII_CHAR ascii_char where `short_length' is an 8-bit unsigned integer between 0 and 254. `long_length' is a sequence of an 8-bit integer 255 and a 32-bit signed integer value which is split into upper and lower 16-bit fields in two char's. `pattern_char_index' is an 8-bit integer between 0 and 18. `ascii_char' is an 7-bit ASCII character value. `data' depends on its Tag value. If Length is short_length, Tag and short_length are packed in a single char, as illustrated below. char[0] = (Tag << 8) | short_length; If Length is long_length, Tag and 255 are packed in the first char and a 32-bit integer, as illustrated below. char[0] = (Tag << 8) | 255; char[1] = (char) (long_length >>> 16); char[2] = (char) (long_length & 0xffff); If Tag is a pattern_char_index, its Length is the number of pattern characters. For example, if the given pattern is "yyyy", Tag is 1 and Length is 4, followed by no data. If Tag is TAG_QUOTE_CHARS, its Length is the number of char's following the TagField. For example, if the given pattern is "'o''clock'", Length is 7 followed by a char sequence of o&nbs;'&nbs;c&nbs;l&nbs;o&nbs;c&nbs;k. TAG_QUOTE_ASCII_CHAR is a special tag and has an ASCII character in place of Length. For example, if the given pattern is "'o'", the TaggedData entry is ((TAG_QUOTE_ASCII_CHAR&nbs;<<&nbs;8)&nbs;|&nbs;'o'). exception NullPointerException if the given pattern is null exception IllegalArgumentException if the given pattern is invalid int length = pattern.length(); boolean inQuote = false; StringBuilder compiledPattern = new StringBuilder(length * 2); StringBuilder tmpBuffer = null; int count = 0; int lastTag = -1; for (int i = 0; i < length; i++) { char c = pattern.charAt(i); if (c == '\'") { // '' is treated as a single quote regardless of being // in a quoted section. if ((i + 1) < length) { c = pattern.charAt(i + 1); if (c == '\'") { i++; if (count != 0) { encode(lastTag, count, compiledPattern); lastTag = -1; count = 0; } if (inQuote) { tmpBuffer.append(c); } else { compiledPattern.append((char)(TAG_QUOTE_ASCII_CHAR << 8 | c)); } continue; } } if (!inQuote) { if (count != 0) { encode(lastTag, count, compiledPattern); lastTag = -1; count = 0; } if (tmpBuffer == null) { tmpBuffer = new StringBuilder(length); } else { tmpBuffer.setLength(0); } inQuote = true; } else { int len = tmpBuffer.length(); if (len == 1) { char ch = tmpBuffer.charAt(0); if (ch < 128) { compiledPattern.append((char)(TAG_QUOTE_ASCII_CHAR << 8 | ch)); } else { compiledPattern.append((char)(TAG_QUOTE_CHARS << 8 | 1)); compiledPattern.append(ch); } } else { encode(TAG_QUOTE_CHARS, len, compiledPattern); compiledPattern.append(tmpBuffer); } inQuote = false; } continue; } if (inQuote) { tmpBuffer.append(c); continue; } if (!(c >= 'a" && c <= 'z" || c >= 'A" && c <= 'Z")) { if (count != 0) { encode(lastTag, count, compiledPattern); lastTag = -1; count = 0; } if (c < 128) { // In most cases, c would be a delimiter, such as ':'. compiledPattern.append((char)(TAG_QUOTE_ASCII_CHAR << 8 | c)); } else { // Take any contiguous non-ASCII alphabet characters and // put them in a single TAG_QUOTE_CHARS. int j; for (j = i + 1; j < length; j++) { char d = pattern.charAt(j); if (d == '\'" || (d >= 'a" && d <= 'z" || d >= 'A" && d <= 'Z")) { break; } } compiledPattern.append((char)(TAG_QUOTE_CHARS << 8 | (j - i))); for (; i < j; i++) { compiledPattern.append(pattern.charAt(i)); } i--; } continue; } int tag; if ((tag = DateFormatSymbols.patternChars.indexOf(c)) == -1) { throw new IllegalArgumentException("Illegal pattern character " + "'" + c + "'"); } if (lastTag == -1 || lastTag == tag) { lastTag = tag; count++; continue; } encode(lastTag, count, compiledPattern); lastTag = tag; count = 1; } if (inQuote) { throw new IllegalArgumentException("Unterminated quote"); } if (count != 0) { encode(lastTag, count, compiledPattern); } // Copy the compiled pattern to a char array int len = compiledPattern.length(); char[] r = new char[len]; compiledPattern.getChars(0, len, r, 0); return r;
private static final void	encode(int tag, int length, java.lang.StringBuilder buffer) Encodes the given tag and length and puts encoded char(s) into buffer. if (length < 255) { buffer.append((char)(tag << 8 | length)); } else { buffer.append((char)((tag << 8) | 0xff)); buffer.append((char)(length >>> 16)); buffer.append((char)(length & 0xffff)); }
public boolean	equals(java.lang.Object obj) Compares the given object with this SimpleDateFormat for equality. return true if the given object is equal to this SimpleDateFormat if (!super.equals(obj)) return false; // super does class check SimpleDateFormat that = (SimpleDateFormat) obj; return (pattern.equals(that.pattern) && formatData.equals(that.formatData));
public java.lang.StringBuffer	format(java.util.Date date, java.lang.StringBuffer toAppendTo, java.text.FieldPosition pos) Formats the given Date into a date/time string and appends the result to the given StringBuffer. param date the date-time value to be formatted into a date-time string. param toAppendTo where the new date-time text is to be appended. param pos the formatting position. On input: an alignment field, if desired. On output: the offsets of the alignment field. return the formatted date-time string. exception NullPointerException if the given date is null pos.beginIndex = pos.endIndex = 0; return format(date, toAppendTo, pos.getFieldDelegate());
private java.lang.StringBuffer	format(java.util.Date date, java.lang.StringBuffer toAppendTo, FieldDelegate delegate) // Convert input date to time field list calendar.setTime(date); boolean useDateFormatSymbols = useDateFormatSymbols(); for (int i = 0; i < compiledPattern.length; ) { int tag = compiledPattern[i] >>> 8; int count = compiledPattern[i++] & 0xff; if (count == 255) { count = compiledPattern[i++] << 16; count |= compiledPattern[i++]; } switch (tag) { case TAG_QUOTE_ASCII_CHAR: toAppendTo.append((char)count); break; case TAG_QUOTE_CHARS: toAppendTo.append(compiledPattern, i, count); i += count; break; default: subFormat(tag, count, delegate, toAppendTo, useDateFormatSymbols); break; } } return toAppendTo;
public java.text.AttributedCharacterIterator	formatToCharacterIterator(java.lang.Object obj) Formats an Object producing an AttributedCharacterIterator. You can use the returned AttributedCharacterIterator to build the resulting String, as well as to determine information about the resulting String. Each attribute key of the AttributedCharacterIterator will be of type DateFormat.Field, with the corresponding attribute value being the same as the attribute key. exception NullPointerException if obj is null. exception IllegalArgumentException if the Format cannot format the given object, or if the Format's pattern string is invalid. param obj The object to format return AttributedCharacterIterator describing the formatted value. since 1.4 StringBuffer sb = new StringBuffer(); CharacterIteratorFieldDelegate delegate = new CharacterIteratorFieldDelegate(); if (obj instanceof Date) { format((Date)obj, sb, delegate); } else if (obj instanceof Number) { format(new Date(((Number)obj).longValue()), sb, delegate); } else if (obj == null) { throw new NullPointerException( "formatToCharacterIterator must be passed non-null object"); } else { throw new IllegalArgumentException( "Cannot format given Object as a Date"); } return delegate.getIterator(sb.toString());
public java.util.Date	get2DigitYearStart() Returns the beginning date of the 100-year period 2-digit years are interpreted as being within. return the start of the 100-year period into which two digit years are parsed see #set2DigitYearStart since 1.2 return defaultCenturyStart;
private final java.lang.String	getCalendarName() return calendar.getClass().getName();
public java.text.DateFormatSymbols	getDateFormatSymbols() Gets a copy of the date and time format symbols of this date format. return the date and time format symbols of this date format see #setDateFormatSymbols return (DateFormatSymbols)formatData.clone();
private java.lang.String	getKey() StringBuilder sb = new StringBuilder(); sb.append(getCalendarName()).append('."); sb.append(locale.getLanguage()).append('_").append(locale.getCountry()).append('_").append(locale.getVariant()); return sb.toString();
public int	hashCode() Returns the hash code value for this SimpleDateFormat object. return the hash code value for this SimpleDateFormat object. return pattern.hashCode(); // just enough fields for a reasonable distribution
private void	initialize(java.util.Locale loc) // Verify and compile the given pattern. compiledPattern = compile(pattern); /* try the cache first */ numberFormat = cachedNumberFormatData.get(loc); if (numberFormat == null) { /* cache miss */ numberFormat = NumberFormat.getIntegerInstance(loc); numberFormat.setGroupingUsed(false); /* update cache */ cachedNumberFormatData.put(loc, numberFormat); } numberFormat = (NumberFormat) numberFormat.clone(); initializeDefaultCentury();
private void	initializeCalendar(java.util.Locale loc) if (calendar == null) { assert loc != null; // The format object must be constructed using the symbols for this zone. // However, the calendar should use the current default TimeZone. // If this is not contained in the locale zone strings, then the zone // will be formatted using generic GMT+/-H:MM nomenclature. calendar = Calendar.getInstance(TimeZone.getDefault(), loc); }
private void	initializeDefaultCentury() calendar.setTime( new Date() ); calendar.add( Calendar.YEAR, -80 ); parseAmbiguousDatesAsAfter(calendar.getTime());
private boolean	isGregorianCalendar() return "java.util.GregorianCalendar".equals(getCalendarName());
private boolean	matchDSTString(java.lang.String text, int start, int zoneIndex, int standardIndex) int index = standardIndex + 2; String[][] zoneStrings = formatData.getZoneStringsWrapper(); String zoneName = zoneStrings[zoneIndex][index]; if (text.regionMatches(true, start, zoneName, 0, zoneName.length())) { return true; } return false;
private int	matchString(java.lang.String text, int start, int field, java.lang.String[] data) Private code-size reduction function used by subParse. param text the time text being parsed. param start where to start parsing. param field the date field being parsed. param data the string array to parsed. return the new start position if matching succeeded; a negative number indicating matching failure, otherwise. int i = 0; int count = data.length; if (field == Calendar.DAY_OF_WEEK) i = 1; // There may be multiple strings in the data[] array which begin with // the same prefix (e.g., Cerven and Cervenec (June and July) in Czech). // We keep track of the longest match, and return that. Note that this // unfortunately requires us to test all array elements. int bestMatchLength = 0, bestMatch = -1; for (; i<count; ++i) { int length = data[i].length(); // Always compare if we have no match yet; otherwise only compare // against potentially better matches (longer strings). if (length > bestMatchLength && text.regionMatches(true, start, data[i], 0, length)) { bestMatch = i; bestMatchLength = length; } } if (bestMatch >= 0) { calendar.set(field, bestMatch); return start + bestMatchLength; } return -start;
private int	matchString(java.lang.String text, int start, int field, java.util.Map data) Performs the same thing as matchString(String, int, int, String[]). This method takes a Map instead of String[]. if (data != null) { String bestMatch = null; for (String name : data.keySet()) { int length = name.length(); if (bestMatch == null || length > bestMatch.length()) { if (text.regionMatches(true, start, name, 0, length)) { bestMatch = name; } } } if (bestMatch != null) { calendar.set(field, data.get(bestMatch)); return start + bestMatch.length(); } } return -start;
private int	matchZoneString(java.lang.String text, int start, int zoneIndex) for (int j = 1; j <= 4; ++j) { // Checking long and short zones [1 & 2], // and long and short daylight [3 & 4]. String[][] zoneStrings = formatData.getZoneStringsWrapper(); String zoneName = zoneStrings[zoneIndex][j]; if (text.regionMatches(true, start, zoneName, 0, zoneName.length())) { return j; } } return -1;
public java.util.Date	parse(java.lang.String text, java.text.ParsePosition pos) Parses text from a string to produce a Date. The method attempts to parse text starting at the index given by pos. If parsing succeeds, then the index of pos is updated to the index after the last character used (parsing does not necessarily use all characters up to the end of the string), and the parsed date is returned. The updated pos can be used to indicate the starting point for the next call to this method. If an error occurs, then the index of pos is not changed, the error index of pos is set to the index of the character where the error occurred, and null is returned. param text A String, part of which should be parsed. param pos A ParsePosition object with index and error index information as described above. return A Date parsed from the string. In case of error, returns null. exception NullPointerException if text or pos is null. int start = pos.index; int oldStart = start; int textLength = text.length(); calendar.clear(); // Clears all the time fields boolean[] ambiguousYear = {false}; for (int i = 0; i < compiledPattern.length; ) { int tag = compiledPattern[i] >>> 8; int count = compiledPattern[i++] & 0xff; if (count == 255) { count = compiledPattern[i++] << 16; count |= compiledPattern[i++]; } switch (tag) { case TAG_QUOTE_ASCII_CHAR: if (start >= textLength || text.charAt(start) != (char)count) { pos.index = oldStart; pos.errorIndex = start; return null; } start++; break; case TAG_QUOTE_CHARS: while (count-- > 0) { if (start >= textLength || text.charAt(start) != compiledPattern[i++]) { pos.index = oldStart; pos.errorIndex = start; return null; } start++; } break; default: // Peek the next pattern to determine if we need to // obey the number of pattern letters for // parsing. It's required when parsing contiguous // digit text (e.g., "20010704") with a pattern which // has no delimiters between fields, like "yyyyMMdd". boolean obeyCount = false; if (i < compiledPattern.length) { int nextTag = compiledPattern[i] >>> 8; if (!(nextTag == TAG_QUOTE_ASCII_CHAR || nextTag == TAG_QUOTE_CHARS)) { obeyCount = true; } } start = subParse(text, start, tag, count, obeyCount, ambiguousYear, pos); if (start < 0) { pos.index = oldStart; return null; } } } // At this point the fields of Calendar have been set. Calendar // will fill in default values for missing fields when the time // is computed. pos.index = start; // This part is a problem: When we call parsedDate.after, we compute the time. // Take the date April 3 2004 at 2:30 am. When this is first set up, the year // will be wrong if we're parsing a 2-digit year pattern. It will be 1904. // April 3 1904 is a Sunday (unlike 2004) so it is the DST onset day. 2:30 am // is therefore an "impossible" time, since the time goes from 1:59 to 3:00 am // on that day. It is therefore parsed out to fields as 3:30 am. Then we // add 100 years, and get April 3 2004 at 3:30 am. Note that April 3 2004 is // a Saturday, so it can have a 2:30 am -- and it should. [LIU] /* Date parsedDate = calendar.getTime(); if( ambiguousYear[0] && !parsedDate.after(defaultCenturyStart) ) { calendar.add(Calendar.YEAR, 100); parsedDate = calendar.getTime(); } */ // Because of the above condition, save off the fields in case we need to readjust. // The procedure we use here is not particularly efficient, but there is no other // way to do this given the API restrictions present in Calendar. We minimize // inefficiency by only performing this computation when it might apply, that is, // when the two-digit year is equal to the start year, and thus might fall at the // front or the back of the default century. This only works because we adjust // the year correctly to start with in other cases -- see subParse(). Date parsedDate; try { if (ambiguousYear[0]) // If this is true then the two-digit year == the default start year { // We need a copy of the fields, and we need to avoid triggering a call to // complete(), which will recalculate the fields. Since we can't access // the fields[] array in Calendar, we clone the entire object. This will // stop working if Calendar.clone() is ever rewritten to call complete(). Calendar savedCalendar = (Calendar)calendar.clone(); parsedDate = calendar.getTime(); if (parsedDate.before(defaultCenturyStart)) { // We can't use add here because that does a complete() first. savedCalendar.set(Calendar.YEAR, defaultCenturyStartYear + 100); parsedDate = savedCalendar.getTime(); } } else parsedDate = calendar.getTime(); } // An IllegalArgumentException will be thrown by Calendar.getTime() // if any fields are out of range, e.g., MONTH == 17. catch (IllegalArgumentException e) { pos.errorIndex = start; pos.index = oldStart; return null; } return parsedDate;
private void	parseAmbiguousDatesAsAfter(java.util.Date startDate) defaultCenturyStart = startDate; calendar.setTime(startDate); defaultCenturyStartYear = calendar.get(Calendar.YEAR);
private void	readObject(java.io.ObjectInputStream stream) After reading an object from the input stream, the format pattern in the object is verified. exception InvalidObjectException if the pattern is invalid stream.defaultReadObject(); try { compiledPattern = compile(pattern); } catch (Exception e) { throw new InvalidObjectException("invalid pattern"); } if (serialVersionOnStream < 1) { // didn't have defaultCenturyStart field initializeDefaultCentury(); } else { // fill in dependent transient field parseAmbiguousDatesAsAfter(defaultCenturyStart); } serialVersionOnStream = currentSerialVersion; // If the deserialized object has a SimpleTimeZone, try // to replace it with a ZoneInfo equivalent in order to // be compatible with the SimpleTimeZone-based // implementation as much as possible. TimeZone tz = getTimeZone(); if (tz instanceof SimpleTimeZone) { String id = tz.getID(); TimeZone zi = TimeZone.getTimeZone(id); if (zi != null && zi.hasSameRules(tz) && zi.getID().equals(id)) { setTimeZone(zi); } }
public void	set2DigitYearStart(java.util.Date startDate) Sets the 100-year period 2-digit years will be interpreted as being in to begin on the date the user specifies. param startDate During parsing, two digit years will be placed in the range startDate to startDate + 100 years. see #get2DigitYearStart since 1.2 parseAmbiguousDatesAsAfter(startDate);
public void	setDateFormatSymbols(java.text.DateFormatSymbols newFormatSymbols) Sets the date and time format symbols of this date format. param newFormatSymbols the new date and time format symbols exception NullPointerException if the given newFormatSymbols is null see #getDateFormatSymbols this.formatData = (DateFormatSymbols)newFormatSymbols.clone(); useDateFormatSymbols = true;
private void	subFormat(int patternCharIndex, int count, FieldDelegate delegate, java.lang.StringBuffer buffer, boolean useDateFormatSymbols) Private member function that does the real date/time formatting. int maxIntCount = Integer.MAX_VALUE; String current = null; int beginOffset = buffer.length(); int field = PATTERN_INDEX_TO_CALENDAR_FIELD[patternCharIndex]; int value = calendar.get(field); int style = (count >= 4) ? Calendar.LONG : Calendar.SHORT; if (!useDateFormatSymbols) { current = calendar.getDisplayName(field, style, locale); } // Note: zeroPaddingNumber() assumes that maxDigits is either // 2 or maxIntCount. If we make any changes to this, // zeroPaddingNumber() must be fixed. switch (patternCharIndex) { case 0: // 'G' - ERA if (useDateFormatSymbols) { String[] eras = formatData.getEras(); if (value < eras.length) current = eras[value]; } if (current == null) current = ""; break; case 1: // 'y' - YEAR if (calendar instanceof GregorianCalendar) { if (count >= 4) zeroPaddingNumber(value, count, maxIntCount, buffer); else // count < 4 zeroPaddingNumber(value, 2, 2, buffer); // clip 1996 to 96 } else { if (current == null) { zeroPaddingNumber(value, style == Calendar.LONG ? 1 : count, maxIntCount, buffer); } } break; case 2: // 'M' - MONTH if (useDateFormatSymbols) { String[] months; if (count >= 4) { months = formatData.getMonths(); current = months[value]; } else if (count == 3) { months = formatData.getShortMonths(); current = months[value]; } } else { if (count < 3) { current = null; } } if (current == null) { zeroPaddingNumber(value+1, count, maxIntCount, buffer); } break; case 4: // 'k' - HOUR_OF_DAY: 1-based. eg, 23:59 + 1 hour =>> 24:59 if (current == null) { if (value == 0) zeroPaddingNumber(calendar.getMaximum(Calendar.HOUR_OF_DAY)+1, count, maxIntCount, buffer); else zeroPaddingNumber(value, count, maxIntCount, buffer); } break; case 9: // 'E' - DAY_OF_WEEK if (useDateFormatSymbols) { String[] weekdays; if (count >= 4) { weekdays = formatData.getWeekdays(); current = weekdays[value]; } else { // count < 4, use abbreviated form if exists weekdays = formatData.getShortWeekdays(); current = weekdays[value]; } } break; case 14: // 'a' - AM_PM if (useDateFormatSymbols) { String[] ampm = formatData.getAmPmStrings(); current = ampm[value]; } break; case 15: // 'h' - HOUR:1-based. eg, 11PM + 1 hour =>> 12 AM if (current == null) { if (value == 0) zeroPaddingNumber(calendar.getLeastMaximum(Calendar.HOUR)+1, count, maxIntCount, buffer); else zeroPaddingNumber(value, count, maxIntCount, buffer); } break; case 17: // 'z' - ZONE_OFFSET if (current == null) { if (formatData.locale == null || formatData.isZoneStringsSet) { int zoneIndex = formatData.getZoneIndex(calendar.getTimeZone().getID()); if (zoneIndex == -1) { value = calendar.get(Calendar.ZONE_OFFSET) + calendar.get(Calendar.DST_OFFSET); buffer.append(ZoneInfoFile.toCustomID(value)); } else { int index = (calendar.get(Calendar.DST_OFFSET) == 0) ? 1: 3; if (count < 4) { // Use the short name index++; } String[][] zoneStrings = formatData.getZoneStringsWrapper(); buffer.append(zoneStrings[zoneIndex][index]); } } else { TimeZone tz = calendar.getTimeZone(); boolean daylight = (calendar.get(Calendar.DST_OFFSET) != 0); int tzstyle = (count < 4 ? TimeZone.SHORT : TimeZone.LONG); buffer.append(tz.getDisplayName(daylight, tzstyle, formatData.locale)); } } break; case 18: // 'Z' - ZONE_OFFSET ("-/+hhmm" form) value = (calendar.get(Calendar.ZONE_OFFSET) + calendar.get(Calendar.DST_OFFSET)) / 60000; int width = 4; if (value >= 0) { buffer.append('+"); } else { width++; } int num = (value / 60) * 100 + (value % 60); CalendarUtils.sprintf0d(buffer, num, width); break; default: // case 3: // 'd' - DATE // case 5: // 'H' - HOUR_OF_DAY:0-based. eg, 23:59 + 1 hour =>> 00:59 // case 6: // 'm' - MINUTE // case 7: // 's' - SECOND // case 8: // 'S' - MILLISECOND // case 10: // 'D' - DAY_OF_YEAR // case 11: // 'F' - DAY_OF_WEEK_IN_MONTH // case 12: // 'w' - WEEK_OF_YEAR // case 13: // 'W' - WEEK_OF_MONTH // case 16: // 'K' - HOUR: 0-based. eg, 11PM + 1 hour =>> 0 AM if (current == null) { zeroPaddingNumber(value, count, maxIntCount, buffer); } break; } // switch (patternCharIndex) if (current != null) { buffer.append(current); } int fieldID = PATTERN_INDEX_TO_DATE_FORMAT_FIELD[patternCharIndex]; Field f = PATTERN_INDEX_TO_DATE_FORMAT_FIELD_ID[patternCharIndex]; delegate.formatted(fieldID, f, f, beginOffset, buffer.length(), buffer);
private int	subParse(java.lang.String text, int start, int patternCharIndex, int count, boolean obeyCount, boolean[] ambiguousYear, java.text.ParsePosition origPos) Private member function that converts the parsed date strings into timeFields. Returns -start (for ParsePosition) if failed. param text the time text to be parsed. param start where to start parsing. param ch the pattern character for the date field text to be parsed. param count the count of a pattern character. param obeyCount if true, then the next field directly abuts this one, and we should use the count to know when to stop parsing. param ambiguousYear return parameter; upon return, if ambiguousYear[0] is true, then a two-digit year was parsed and may need to be readjusted. param origPos origPos.errorIndex is used to return an error index at which a parse error occurred, if matching failure occurs. return the new start position if matching succeeded; -1 indicating matching failure, otherwise. In case matching failure occurred, an error index is set to origPos.errorIndex. Number number = null; int value = 0; ParsePosition pos = new ParsePosition(0); pos.index = start; int field = PATTERN_INDEX_TO_CALENDAR_FIELD[patternCharIndex]; // If there are any spaces here, skip over them. If we hit the end // of the string, then fail. for (;;) { if (pos.index >= text.length()) { origPos.errorIndex = start; return -1; } char c = text.charAt(pos.index); if (c != ' " && c != '\t") break; ++pos.index; } // We handle a few special cases here where we need to parse // a number value. We handle further, more generic cases below. We need // to handle some of them here because some fields require extra processing on // the parsed value. if (patternCharIndex == 4 /*HOUR_OF_DAY1_FIELD*/ || patternCharIndex == 15 /*HOUR1_FIELD*/ || (patternCharIndex == 2 /*MONTH_FIELD*/ && count <= 2) || patternCharIndex == 1) { // It would be good to unify this with the obeyCount logic below, // but that's going to be difficult. if (obeyCount) { if ((start+count) > text.length()) { origPos.errorIndex = start; return -1; } number = numberFormat.parse(text.substring(0, start+count), pos); } else number = numberFormat.parse(text, pos); if (number == null) { if (patternCharIndex != 1 || calendar instanceof GregorianCalendar) { origPos.errorIndex = pos.index; return -1; } } else { value = number.intValue(); } } boolean useDateFormatSymbols = useDateFormatSymbols(); int index; switch (patternCharIndex) { case 0: // 'G' - ERA if (useDateFormatSymbols) { if ((index = matchString(text, start, Calendar.ERA, formatData.getEras())) > 0) { return index; } } else { Map<String, Integer> map = calendar.getDisplayNames(field, Calendar.ALL_STYLES, locale); if ((index = matchString(text, start, field, map)) > 0) { return index; } } origPos.errorIndex = pos.index; return -1; case 1: // 'y' - YEAR if (!(calendar instanceof GregorianCalendar)) { // calendar might have text representations for year values, // such as "\u5143" in JapaneseImperialCalendar. int style = (count >= 4) ? Calendar.LONG : Calendar.SHORT; Map<String, Integer> map = calendar.getDisplayNames(field, style, locale); if (map != null) { if ((index = matchString(text, start, field, map)) > 0) { return index; } } calendar.set(field, value); return pos.index; } // If there are 3 or more YEAR pattern characters, this indicates // that the year value is to be treated literally, without any // two-digit year adjustments (e.g., from "01" to 2001). Otherwise // we made adjustments to place the 2-digit year in the proper // century, for parsed strings from "00" to "99". Any other string // is treated literally: "2250", "-1", "1", "002". if (count <= 2 && (pos.index - start) == 2 && Character.isDigit(text.charAt(start)) && Character.isDigit(text.charAt(start+1))) { // Assume for example that the defaultCenturyStart is 6/18/1903. // This means that two-digit years will be forced into the range // 6/18/1903 to 6/17/2003. As a result, years 00, 01, and 02 // correspond to 2000, 2001, and 2002. Years 04, 05, etc. correspond // to 1904, 1905, etc. If the year is 03, then it is 2003 if the // other fields specify a date before 6/18, or 1903 if they specify a // date afterwards. As a result, 03 is an ambiguous year. All other // two-digit years are unambiguous. int ambiguousTwoDigitYear = defaultCenturyStartYear % 100; ambiguousYear[0] = value == ambiguousTwoDigitYear; value += (defaultCenturyStartYear/100)*100 + (value < ambiguousTwoDigitYear ? 100 : 0); } calendar.set(Calendar.YEAR, value); return pos.index; case 2: // 'M' - MONTH if (count <= 2) // i.e., M or MM. { // Don't want to parse the month if it is a string // while pattern uses numeric style: M or MM. // [We computed 'value' above.] calendar.set(Calendar.MONTH, value - 1); return pos.index; } else { if (useDateFormatSymbols) { // count >= 3 // i.e., MMM or MMMM // Want to be able to parse both short and long forms. // Try count == 4 first: int newStart = 0; if ((newStart=matchString(text, start, Calendar.MONTH, formatData.getMonths())) > 0) return newStart; else // count == 4 failed, now try count == 3 if ((index = matchString(text, start, Calendar.MONTH, formatData.getShortMonths())) > 0) { return index; } } else { Map<String, Integer> map = calendar.getDisplayNames(field, Calendar.ALL_STYLES, locale); if ((index = matchString(text, start, field, map)) > 0) { return index; } } } origPos.errorIndex = pos.index; return -1; case 4: // 'k' - HOUR_OF_DAY: 1-based. eg, 23:59 + 1 hour =>> 24:59 // [We computed 'value' above.] if (value == calendar.getMaximum(Calendar.HOUR_OF_DAY)+1) value = 0; calendar.set(Calendar.HOUR_OF_DAY, value); return pos.index; case 9: { // 'E' - DAY_OF_WEEK if (useDateFormatSymbols) { // Want to be able to parse both short and long forms. // Try count == 4 (DDDD) first: int newStart = 0; if ((newStart=matchString(text, start, Calendar.DAY_OF_WEEK, formatData.getWeekdays())) > 0) return newStart; else // DDDD failed, now try DDD if ((index = matchString(text, start, Calendar.DAY_OF_WEEK, formatData.getShortWeekdays())) > 0) { return index; } } else { int[] styles = { Calendar.LONG, Calendar.SHORT }; for (int style : styles) { Map<String,Integer> map = calendar.getDisplayNames(field, style, locale); if ((index = matchString(text, start, field, map)) > 0) { return index; } } } origPos.errorIndex = pos.index; return -1; } case 14: // 'a' - AM_PM if (useDateFormatSymbols) { if ((index = matchString(text, start, Calendar.AM_PM, formatData.getAmPmStrings())) > 0) { return index; } } else { Map<String,Integer> map = calendar.getDisplayNames(field, Calendar.ALL_STYLES, locale); if ((index = matchString(text, start, field, map)) > 0) { return index; } } origPos.errorIndex = pos.index; return -1; case 15: // 'h' - HOUR:1-based. eg, 11PM + 1 hour =>> 12 AM // [We computed 'value' above.] if (value == calendar.getLeastMaximum(Calendar.HOUR)+1) value = 0; calendar.set(Calendar.HOUR, value); return pos.index; case 17: // 'z' - ZONE_OFFSET case 18: // 'Z' - ZONE_OFFSET // First try to parse generic forms such as GMT-07:00. Do this first // in case localized TimeZoneNames contains the string "GMT" // for a zone; in that case, we don't want to match the first three // characters of GMT+/-hh:mm etc. { int sign = 0; int offset; // For time zones that have no known names, look for strings // of the form: // GMT[+-]hours:minutes or // GMT. if ((text.length() - start) >= GMT.length() && text.regionMatches(true, start, GMT, 0, GMT.length())) { int num; calendar.set(Calendar.DST_OFFSET, 0); pos.index = start + GMT.length(); try { // try-catch for "GMT" only time zone string if( text.charAt(pos.index) == '+" ) { sign = 1; } else if( text.charAt(pos.index) == '-" ) { sign = -1; } } catch(StringIndexOutOfBoundsException e) {} if (sign == 0) { /* "GMT" without offset */ calendar.set(Calendar.ZONE_OFFSET, 0 ); return pos.index; } // Look for hours. try { char c = text.charAt(++pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { num = c - '0"; } if (text.charAt(++pos.index) != ':") { c = text.charAt(pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { num *= 10; num += c - '0"; pos.index++; } } if (num > 23) { origPos.errorIndex = pos.index - 1; return -1; // Wasn't actually a number. } if (text.charAt(pos.index) != ':") { origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } } catch(StringIndexOutOfBoundsException e) { origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } // Look for minutes. offset = num * 60; try { char c = text.charAt(++pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { num = c - '0"; c = text.charAt(++pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { num *= 10; num += c - '0"; } } if (num > 59) { origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } } catch(StringIndexOutOfBoundsException e) { origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } offset += num; // Fall through for final processing below of 'offset' and 'sign'. } else { // At this point, check for named time zones by looking through // the locale data from the TimeZoneNames strings. // Want to be able to parse both short and long forms. int i = subParseZoneString(text, pos.index); if (i != 0) { return i; } // As a last resort, look for numeric timezones of the form // [+-]hhmm as specified by RFC 822. This code is actually // a little more permissive than RFC 822. It will try to do // its best with numbers that aren't strictly 4 digits long. try { if( text.charAt(pos.index) == '+" ) { sign = 1; } else if( text.charAt(pos.index) == '-" ) { sign = -1; } if (sign == 0) { origPos.errorIndex = pos.index; return -1; } // Look for hh. int hours = 0; char c = text.charAt(++pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { hours = c - '0"; c = text.charAt(++pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { hours *= 10; hours += c - '0"; } } if (hours > 23) { origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } // Look for mm. int minutes = 0; c = text.charAt(++pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { minutes = c - '0"; c = text.charAt(++pos.index); if (c < '0" || c > '9") { /* must be from '0' to '9'. */ origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } else { minutes *= 10; minutes += c - '0"; } } if (minutes > 59) { origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } offset = hours * 60 + minutes; } catch(StringIndexOutOfBoundsException e) { origPos.errorIndex = pos.index; return -1; // Wasn't actually a number. } } // Do the final processing for both of the above cases. We only // arrive here if the form GMT+/-... or an RFC 822 form was seen. if (sign != 0) { offset *= millisPerMinute * sign; calendar.set(Calendar.ZONE_OFFSET, offset); calendar.set(Calendar.DST_OFFSET, 0); return ++pos.index; } } // All efforts to parse a zone failed. origPos.errorIndex = pos.index; return -1; default: // case 3: // 'd' - DATE // case 5: // 'H' - HOUR_OF_DAY:0-based. eg, 23:59 + 1 hour =>> 00:59 // case 6: // 'm' - MINUTE // case 7: // 's' - SECOND // case 8: // 'S' - MILLISECOND // case 10: // 'D' - DAY_OF_YEAR // case 11: // 'F' - DAY_OF_WEEK_IN_MONTH // case 12: // 'w' - WEEK_OF_YEAR // case 13: // 'W' - WEEK_OF_MONTH // case 16: // 'K' - HOUR: 0-based. eg, 11PM + 1 hour =>> 0 AM // Handle "generic" fields if (obeyCount) { if ((start+count) > text.length()) { origPos.errorIndex = pos.index; return -1; } number = numberFormat.parse(text.substring(0, start+count), pos); } else number = numberFormat.parse(text, pos); if (number != null) { calendar.set(field, number.intValue()); return pos.index; } origPos.errorIndex = pos.index; return -1; }
private int	subParseZoneString(java.lang.String text, int start) find time zone 'text' matched zoneStrings and set to internal calendar. boolean useSameName = false; // true if standard and daylight time use the same abbreviation. TimeZone currentTimeZone = getTimeZone(); // At this point, check for named time zones by looking through // the locale data from the TimeZoneNames strings. // Want to be able to parse both short and long forms. int zoneIndex = formatData.getZoneIndex (currentTimeZone.getID()); TimeZone tz = null; String[][] zoneStrings = formatData.getZoneStringsWrapper(); int j = 0, i = 0; if ((zoneIndex != -1) && ((j = matchZoneString(text, start, zoneIndex)) > 0)) { if (j <= 2) { useSameName = matchDSTString(text, start, zoneIndex, j); } tz = TimeZone.getTimeZone(zoneStrings[zoneIndex][0]); i = zoneIndex; } if (tz == null) { zoneIndex = formatData.getZoneIndex (TimeZone.getDefault().getID()); if ((zoneIndex != -1) && ((j = matchZoneString(text, start, zoneIndex)) > 0)) { if (j <= 2) { useSameName = matchDSTString(text, start, zoneIndex, j); } tz = TimeZone.getTimeZone(zoneStrings[zoneIndex][0]); i = zoneIndex; } } if (tz == null) { for (i = 0; i < zoneStrings.length; i++) { if ((j = matchZoneString(text, start, i)) > 0) { if (j <= 2) { useSameName = matchDSTString(text, start, i, j); } tz = TimeZone.getTimeZone(zoneStrings[i][0]); break; } } } if (tz != null) { // Matched any ? if (!tz.equals(currentTimeZone)) { setTimeZone(tz); } // If the time zone matched uses the same name // (abbreviation) for both standard and daylight time, // let the time zone in the Calendar decide which one. if (!useSameName) { calendar.set(Calendar.ZONE_OFFSET, tz.getRawOffset()); calendar.set(Calendar.DST_OFFSET, j >= 3 ? tz.getDSTSavings() : 0); } return (start + zoneStrings[i][j].length()); } return 0;
public java.lang.String	toLocalizedPattern() Returns a localized pattern string describing this date format. return a localized pattern string describing this date format. return translatePattern(pattern, DateFormatSymbols.patternChars, formatData.getLocalPatternChars());
public java.lang.String	toPattern() Returns a pattern string describing this date format. return a pattern string describing this date format. return pattern;
private java.lang.String	translatePattern(java.lang.String pattern, java.lang.String from, java.lang.String to) Translates a pattern, mapping each character in the from string to the corresponding character in the to string. exception IllegalArgumentException if the given pattern is invalid StringBuilder result = new StringBuilder(); boolean inQuote = false; for (int i = 0; i < pattern.length(); ++i) { char c = pattern.charAt(i); if (inQuote) { if (c == '\'") inQuote = false; } else { if (c == '\'") inQuote = true; else if ((c >= 'a" && c <= 'z") || (c >= 'A" && c <= 'Z")) { int ci = from.indexOf(c); if (ci == -1) throw new IllegalArgumentException("Illegal pattern " + " character '" + c + "'"); c = to.charAt(ci); } } result.append(c); } if (inQuote) throw new IllegalArgumentException("Unfinished quote in pattern"); return result.toString();
private boolean	useDateFormatSymbols() if (useDateFormatSymbols) { return true; } return isGregorianCalendar() || locale == null;
private final void	zeroPaddingNumber(int value, int minDigits, int maxDigits, java.lang.StringBuffer buffer) Formats a number with the specified minimum and maximum number of digits. // Optimization for 1, 2 and 4 digit numbers. This should // cover most cases of formatting date/time related items. // Note: This optimization code assumes that maxDigits is // either 2 or Integer.MAX_VALUE (maxIntCount in format()). try { if (zeroDigit == 0) { zeroDigit = ((DecimalFormat)numberFormat).getDecimalFormatSymbols().getZeroDigit(); } if (value >= 0) { if (value < 100 && minDigits >= 1 && minDigits <= 2) { if (value < 10) { if (minDigits == 2) { buffer.append(zeroDigit); } buffer.append((char)(zeroDigit + value)); } else { buffer.append((char)(zeroDigit + value / 10)); buffer.append((char)(zeroDigit + value % 10)); } return; } else if (value >= 1000 && value < 10000) { if (minDigits == 4) { buffer.append((char)(zeroDigit + value / 1000)); value %= 1000; buffer.append((char)(zeroDigit + value / 100)); value %= 100; buffer.append((char)(zeroDigit + value / 10)); buffer.append((char)(zeroDigit + value % 10)); return; } if (minDigits == 2 && maxDigits == 2) { zeroPaddingNumber(value % 100, 2, 2, buffer); return; } } } } catch (Exception e) { } numberFormat.setMinimumIntegerDigits(minDigits); numberFormat.setMaximumIntegerDigits(maxDigits); numberFormat.format((long)value, buffer, DontCareFieldPosition.INSTANCE);