MailDateFormat (XJavaMail API 0.1.6 API)

java.lang.Object
- java.text.Format
- - java.text.DateFormat
  - - java.text.SimpleDateFormat
    - - javax.mail.internet.MailDateFormat

所有已实现的接口:

Serializable, Cloneable
```
public class MailDateFormat
extends SimpleDateFormat
```
Formats and parses date specification based on RFC 2822.
This class does not support methods that influence the format. It always formats the date based on the specification below.
3.3. Date and Time Specification
Date and time occur in several header fields. This section specifies the syntax for a full date and time specification. Though folding white space is permitted throughout the date-time specification, it is RECOMMENDED that a single space be used in each place that FWS appears (whether it is required or optional); some older implementations may not interpret other occurrences of folding white space correctly.
```
 date-time       =       [ day-of-week "," ] date FWS time [CFWS]

 day-of-week     =       ([FWS] day-name) / obs-day-of-week

 day-name        =       "Mon" / "Tue" / "Wed" / "Thu" /
                         "Fri" / "Sat" / "Sun"

 date            =       day month year

 year            =       4*DIGIT / obs-year

 month           =       (FWS month-name FWS) / obs-month

 month-name      =       "Jan" / "Feb" / "Mar" / "Apr" /
                         "May" / "Jun" / "Jul" / "Aug" /
                         "Sep" / "Oct" / "Nov" / "Dec"

 day             =       ([FWS] 1*2DIGIT) / obs-day

 time            =       time-of-day FWS zone

 time-of-day     =       hour ":" minute [ ":" second ]

 hour            =       2DIGIT / obs-hour

 minute          =       2DIGIT / obs-minute

 second          =       2DIGIT / obs-second

 zone            =       (( "+" / "-" ) 4DIGIT) / obs-zone
 
```
The day is the numeric day of the month. The year is any numeric year 1900 or later.
The time-of-day specifies the number of hours, minutes, and optionally seconds since midnight of the date indicated.
The date and time-of-day SHOULD express local time.
The zone specifies the offset from Coordinated Universal Time (UTC, formerly referred to as "Greenwich Mean Time") that the date and time-of-day represent. The "+" or "-" indicates whether the time-of-day is ahead of (i.e., east of) or behind (i.e., west of) Universal Time. The first two digits indicate the number of hours difference from Universal Time, and the last two digits indicate the number of minutes difference from Universal Time. (Hence, +hhmm means +(hh * 60 + mm) minutes, and -hhmm means -(hh * 60 + mm) minutes). The form "+0000" SHOULD be used to indicate a time zone at Universal Time. Though "-0000" also indicates Universal Time, it is used to indicate that the time was generated on a system that may be in a local time zone other than Universal Time and therefore indicates that the date-time contains no information about the local time zone.
A date-time specification MUST be semantically valid. That is, the day-of-the-week (if included) MUST be the day implied by the date, the numeric day-of-month MUST be between 1 and the number of days allowed for the specified month (in the specified year), the time-of-day MUST be in the range 00:00:00 through 23:59:60 (the number of seconds allowing for a leap second; see [STD12]), and the zone MUST be within the range -9959 through +9959.
Synchronization

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.
从以下版本开始:

JavaMail 1.2

作者:

Anthony Vanelverdinghe, Max Spivak

另请参阅:

序列化表格

嵌套类概要
- 从类继承的嵌套类/接口 java.text.DateFormat
  DateFormat.Field

字段概要
- 从类继承的字段 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

构造器概要

构造器
构造器和说明

MailDateFormat()
Create a new date format for the RFC2822 specification with lenient parsing.

构造器
构造器和说明
`MailDateFormat()` Create a new date format for the RFC2822 specification with lenient parsing.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`applyLocalizedPattern(String pattern)` This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific pattern.
`void`	`applyPattern(String pattern)` This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific pattern.
`MailDateFormat`	`clone()` Overrides Cloneable.
`StringBuffer`	`format(Date date, StringBuffer dateStrBuf, FieldPosition fieldPosition)` Formats the given date in the format specified by RFC 2822 in the current TimeZone.
`Date`	`get2DigitYearStart()` This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates another strategy for interpreting 2-digits years.
`Date`	`parse(String text, ParsePosition pos)` Parses the given date in the format specified by RFC 2822.
`void`	`set2DigitYearStart(Date startDate)` This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates another strategy for interpreting 2-digits years.
`void`	`setCalendar(Calendar newCalendar)` This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific calendar.
`void`	`setDateFormatSymbols(DateFormatSymbols newFormatSymbols)` This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates specific date format symbols.
`void`	`setNumberFormat(NumberFormat newNumberFormat)` This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific number format.

从类继承的方法 java.text.SimpleDateFormat
equals, formatToCharacterIterator, getDateFormatSymbols, hashCode, toLocalizedPattern, toPattern

从类继承的方法 java.text.DateFormat
format, format, getAvailableLocales, getCalendar, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getNumberFormat, getTimeInstance, getTimeInstance, getTimeInstance, getTimeZone, isLenient, parse, parseObject, setLenient, setTimeZone

从类继承的方法 java.text.Format
format, parseObject

从类继承的方法 java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - MailDateFormat
```
public MailDateFormat()
```
    Create a new date format for the RFC2822 specification with lenient parsing.
- 方法详细资料
  - clone
```
public MailDateFormat clone()
```
    Overrides Cloneable.
    
    覆盖:
    
    clone 在类中 SimpleDateFormat
    
    返回:
    
    a clone of this instance
    
    从以下版本开始:
    
    JavaMail 1.6
  - format
```
public StringBuffer format(Date date,
                           StringBuffer dateStrBuf,
                           FieldPosition fieldPosition)
```
    Formats the given date in the format specified by RFC 2822 in the current TimeZone.
    
    覆盖:
    
    format 在类中 SimpleDateFormat
    
    参数:
    
    date - the Date object
    
    dateStrBuf - the formatted string
    
    fieldPosition - the current field position
    
    返回:
    
    StringBuffer the formatted String
    
    从以下版本开始:
    
    JavaMail 1.2
  - parse
```
public Date parse(String text,
                  ParsePosition pos)
```
    Parses the given date in the format specified by RFC 2822.
    - With strict parsing, obs-* tokens are unsupported. Lenient parsing supports obs-year and obs-zone, with the exception of the 1-character military time zones.
    - The optional CFWS token at the end is not parsed.
    - RFC 2822 specifies that a zone of "-0000" indicates that the date-time contains no information about the local time zone. This class uses the UTC time zone in this case.
    覆盖:
    
    parse 在类中 SimpleDateFormat
    
    参数:
    
    text - the formatted date to be parsed
    
    pos - the current parse position
    
    返回:
    
    Date the parsed date. In case of error, returns null.
    
    从以下版本开始:
    
    JavaMail 1.2
  - setCalendar
```
public void setCalendar(Calendar newCalendar)
```
    This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific calendar.
    
    覆盖:
    
    setCalendar 在类中 DateFormat
    
    抛出:
    
    UnsupportedOperationException - if this method is invoked
  - setNumberFormat
```
public void setNumberFormat(NumberFormat newNumberFormat)
```
    This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific number format.
    
    覆盖:
    
    setNumberFormat 在类中 DateFormat
    
    抛出:
    
    UnsupportedOperationException - if this method is invoked
  - applyLocalizedPattern
```
public void applyLocalizedPattern(String pattern)
```
    This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific pattern.
    
    覆盖:
    
    applyLocalizedPattern 在类中 SimpleDateFormat
    
    抛出:
    
    UnsupportedOperationException - if this method is invoked
    
    从以下版本开始:
    
    JavaMail 1.6
  - applyPattern
```
public void applyPattern(String pattern)
```
    This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates a specific pattern.
    
    覆盖:
    
    applyPattern 在类中 SimpleDateFormat
    
    抛出:
    
    UnsupportedOperationException - if this method is invoked
    
    从以下版本开始:
    
    JavaMail 1.6
  - get2DigitYearStart
```
public Date get2DigitYearStart()
```
    This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates another strategy for interpreting 2-digits years.
    
    覆盖:
    
    get2DigitYearStart 在类中 SimpleDateFormat
    
    返回:
    
    the start of the 100-year period into which two digit years are parsed
    
    抛出:
    
    UnsupportedOperationException - if this method is invoked
    
    从以下版本开始:
    
    JavaMail 1.6
  - set2DigitYearStart
```
public void set2DigitYearStart(Date startDate)
```
    This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates another strategy for interpreting 2-digits years.
    
    覆盖:
    
    set2DigitYearStart 在类中 SimpleDateFormat
    
    抛出:
    
    UnsupportedOperationException - if this method is invoked
    
    从以下版本开始:
    
    JavaMail 1.6
  - setDateFormatSymbols
```
public void setDateFormatSymbols(DateFormatSymbols newFormatSymbols)
```
    This method always throws an UnsupportedOperationException and should not be used because RFC 2822 mandates specific date format symbols.
    
    覆盖:
    
    setDateFormatSymbols 在类中 SimpleDateFormat
    
    抛出:
    
    UnsupportedOperationException - if this method is invoked
    
    从以下版本开始:
    
    JavaMail 1.6

类 MailDateFormat

Synchronization

嵌套类概要

从类继承的嵌套类/接口 java.text.DateFormat

字段概要

从类继承的字段 java.text.DateFormat

构造器概要

方法概要

从类继承的方法 java.text.SimpleDateFormat

从类继承的方法 java.text.DateFormat

从类继承的方法 java.text.Format

从类继承的方法 java.lang.Object

构造器详细资料

MailDateFormat

方法详细资料

clone

format

parse

setCalendar

setNumberFormat

applyLocalizedPattern

applyPattern

get2DigitYearStart

set2DigitYearStart

setDateFormatSymbols