Module java.base
Package java.text

Class DateFormat.Field

  • All Implemented Interfaces:
    Serializable
    Enclosing class:
    DateFormat

    public static classDateFormat.FieldextendsFormat.Field
    Defines constants that are used as attribute keys in theAttributedCharacterIterator returned fromDateFormat.formatToCharacterIterator and as field identifiers inFieldPosition.

    The class also provides two methods to map between its constants and the corresponding Calendar constants.

    Since:
    1.4
    See Also:
    Calendar,Serialized Form
    • Field Detail

      • YEAR

        public static final DateFormat.Field YEAR
        Constant identifying the year field.
      • MONTH

        public static final DateFormat.Field MONTH
        Constant identifying the month field.
      • DAY_OF_MONTH

        public static final DateFormat.Field DAY_OF_MONTH
        Constant identifying the day of month field.
      • HOUR_OF_DAY1

        public static final DateFormat.Field HOUR_OF_DAY1
        Constant identifying the hour of day field, where the legal values are 1 to 24.
      • HOUR_OF_DAY0

        public static final DateFormat.Field HOUR_OF_DAY0
        Constant identifying the hour of day field, where the legal values are 0 to 23.
      • MINUTE

        public static final DateFormat.Field MINUTE
        Constant identifying the minute field.
      • SECOND

        public static final DateFormat.Field SECOND
        Constant identifying the second field.
      • MILLISECOND

        public static final DateFormat.Field MILLISECOND
        Constant identifying the millisecond field.
      • DAY_OF_WEEK

        public static final DateFormat.Field DAY_OF_WEEK
        Constant identifying the day of week field.
      • DAY_OF_YEAR

        public static final DateFormat.Field DAY_OF_YEAR
        Constant identifying the day of year field.
      • DAY_OF_WEEK_IN_MONTH

        public static final DateFormat.Field DAY_OF_WEEK_IN_MONTH
        Constant identifying the day of week field.
      • WEEK_OF_YEAR

        public static final DateFormat.Field WEEK_OF_YEAR
        Constant identifying the week of year field.
      • WEEK_OF_MONTH

        public static final DateFormat.Field WEEK_OF_MONTH
        Constant identifying the week of month field.
      • AM_PM

        public static final DateFormat.Field AM_PM
        Constant identifying the time of day indicator (e.g. "a.m." or "p.m.") field.
      • HOUR1

        public static final DateFormat.Field HOUR1
        Constant identifying the hour field, where the legal values are 1 to 12.
      • HOUR0

        public static final DateFormat.Field HOUR0
        Constant identifying the hour field, where the legal values are 0 to 11.
      • TIME_ZONE

        public static final DateFormat.Field TIME_ZONE
        Constant identifying the time zone field.
    • Constructor Detail

      • Field

        protected Field​(String name,                int calendarField)
        Creates aField.
        Parameters:
        name - the name of theField
        calendarField - theCalendar constant thisField corresponds to; any value, even one outside the range of legalCalendar values may be used, but-1 should be used for values that don't correspond to legalCalendar values
    • Method Detail

      • ofCalendarField

        public static DateFormat.Field ofCalendarField​(int calendarField)
        Returns theField constant that corresponds to theCalendar constantcalendarField. If there is no direct mapping between theCalendar constant and aField, null is returned.
        Parameters:
        calendarField - Calendar field constant
        Returns:
        Field instance representing calendarField.
        Throws:
        IllegalArgumentException - ifcalendarField is not the value of aCalendar field constant.
        See Also:
        Calendar
      • getCalendarField

        public int getCalendarField()
        Returns theCalendar field associated with this attribute. For example, if this represents the hours field of aCalendar, this would returnCalendar.HOUR. If there is no correspondingCalendar constant, this will return -1.
        Returns:
        Calendar constant for this field
        See Also:
        Calendar