public
  static
  
  
  class
  DateFormat.Field
  
  
  
  
  
  
  
    extends Format.Field
  
  
  
  
  
  
| java.lang.Object | |||
| ↳ | java.text.AttributedCharacterIterator.Attribute | ||
| ↳ | java.text.Format.Field | ||
| ↳ | java.text.DateFormat.Field | ||
Defines constants that are used as attribute keys in the
 AttributedCharacterIterator returned
 from DateFormat.formatToCharacterIterator and as
 field identifiers in FieldPosition.
 
The class also provides two methods to map between its constants and the corresponding Calendar constants.
See also:
Fields | |
|---|---|
    public
    static
    final
    DateFormat.Field | 
    
      AM_PM
      Constant identifying the time of day indicator (e.g.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      DAY_OF_MONTH
      Constant identifying the day of month field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      DAY_OF_WEEK
      Constant identifying the day of week field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      DAY_OF_WEEK_IN_MONTH
      Constant identifying the day of week field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      DAY_OF_YEAR
      Constant identifying the day of year field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      ERA
      Constant identifying the era field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      HOUR0
      Constant identifying the hour field, where the legal values are 0 to 11.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      HOUR1
      Constant identifying the hour field, where the legal values are 1 to 12.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      HOUR_OF_DAY0
      Constant identifying the hour of day field, where the legal values are 0 to 23.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      HOUR_OF_DAY1
      Constant identifying the hour of day field, where the legal values are 1 to 24.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      MILLISECOND
      Constant identifying the millisecond field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      MINUTE
      Constant identifying the minute field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      MONTH
      Constant identifying the month field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      SECOND
      Constant identifying the second field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      TIME_ZONE
      Constant identifying the time zone field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      WEEK_OF_MONTH
      Constant identifying the week of month field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      WEEK_OF_YEAR
      Constant identifying the week of year field.  | 
  
    public
    static
    final
    DateFormat.Field | 
    
      YEAR
      Constant identifying the year field.  | 
  
Inherited fields | 
|---|
  
  
    java.text.AttributedCharacterIterator.Attribute
  
   | 
Protected constructors | |
|---|---|
      
      DateFormat.Field(String name, int calendarField)
      
      
        Creates a   | 
  |
Public methods | |
|---|---|
        
        
        
        
        
        int
     | 
  
    
      
      getCalendarField()
      
      
        Returns the   | 
  
        
        
        static
        
        
        DateFormat.Field
     | 
  
    
      
      ofCalendarField(int calendarField)
      
      
        Returns the   | 
  
Protected methods | |
|---|---|
        
        
        
        
        
        Object
     | 
  
    
      
      readResolve()
      
      
        Resolves instances being deserialized to the predefined constants.  | 
  
Inherited methods | |
|---|---|
  
  
    java.text.AttributedCharacterIterator.Attribute
  
 | |
  
  
    java.lang.Object
  
 | |
DateFormat.Field AM_PM
Constant identifying the time of day indicator (e.g. "a.m." or "p.m.") field.
DateFormat.Field DAY_OF_MONTH
Constant identifying the day of month field.
DateFormat.Field DAY_OF_WEEK
Constant identifying the day of week field.
DateFormat.Field DAY_OF_WEEK_IN_MONTH
Constant identifying the day of week field.
DateFormat.Field DAY_OF_YEAR
Constant identifying the day of year field.
DateFormat.Field HOUR0
Constant identifying the hour field, where the legal values are 0 to 11.
DateFormat.Field HOUR1
Constant identifying the hour field, where the legal values are 1 to 12.
DateFormat.Field HOUR_OF_DAY0
Constant identifying the hour of day field, where the legal values are 0 to 23.
DateFormat.Field HOUR_OF_DAY1
Constant identifying the hour of day field, where the legal values are 1 to 24.
DateFormat.Field MILLISECOND
Constant identifying the millisecond field.
DateFormat.Field WEEK_OF_MONTH
Constant identifying the week of month field.
DateFormat.Field WEEK_OF_YEAR
Constant identifying the week of year field.
DateFormat.Field (String name, int calendarField)
Creates a Field.
| Parameters | |
|---|---|
name | 
        
          String:
          the name of the Field | 
      
calendarField | 
        
          int:
          the Calendar constant this
        Field corresponds to; any value, even one
        outside the range of legal Calendar values may
        be used, but -1 should be used for values
        that don't correspond to legal Calendar values
 | 
      
int getCalendarField ()
Returns the Calendar field associated with this
 attribute. For example, if this represents the hours field of
 a Calendar, this would return
 Calendar.HOUR. If there is no corresponding
 Calendar constant, this will return -1.
| Returns | |
|---|---|
int | 
        Calendar constant for this field | 
See also:
DateFormat.Field ofCalendarField (int calendarField)
Returns the Field constant that corresponds to
 the Calendar constant calendarField.
 If there is no direct mapping between the Calendar
 constant and a Field, null is returned.
| Parameters | |
|---|---|
calendarField | 
        
          int:
          Calendar field constant | 
      
| Returns | |
|---|---|
DateFormat.Field | 
        Field instance representing calendarField. | 
| Throws | |
|---|---|
IllegalArgumentException | 
          if calendarField is
         not the value of a Calendar field constant. | 
        
See also:
Object readResolve ()
Resolves instances being deserialized to the predefined constants.
| Returns | |
|---|---|
Object | 
        resolved DateFormat.Field constant | 
| Throws | |
|---|---|
InvalidObjectException | 
          if the constant could not be resolved. |