java.text
类 DateFormat.Field

java.lang.Object
  java.text.AttributedCharacterIterator.Attribute
      java.text.Format.Field
          java.text.DateFormat.Field

所有已实现的接口：

Serializable

正在封闭类：

DateFormat

public static class DateFormat.Field
extends Format.Field

定义了各种常量，这些常量用作 DateFormat.formatToCharacterIterator 所返回的 AttributedCharacterIterator 中的属性键和 FieldPosition 中的字段标识符。

该类还提供了两个方法，以在其常量和相应的 Calendar 常量之间进行映射。

从以下版本开始：

1.4

另请参见：

Calendar, 序列化表格

字段摘要

static DateFormat.Field	AM_PM 标识每日时间指示符（例如 "a.m." 或 "p.m."）的常量。
static DateFormat.Field	DAY_OF_MONTH 标识 DAY_OF_MONTH 字段的常量。
static DateFormat.Field	DAY_OF_WEEK 标识 DAY_OF_WEEK 字段的常量。
static DateFormat.Field	DAY_OF_WEEK_IN_MONTH 标识 DAY_OF_WEEK_IN_MONTH 字段的常量。
static DateFormat.Field	DAY_OF_YEAR 标识 DAY_OF_YEAR 字段的常量。
static DateFormat.Field	ERA 标识 ERA 字段的常量。
static DateFormat.Field	HOUR_OF_DAY0 标识 HOUR_OF_DAY0 字段的常量，其合法的值是 0 到 23。
static DateFormat.Field	HOUR_OF_DAY1 标识 HOUR_OF_DAY1 字段的常量，其合法的值是 1 到 24。
static DateFormat.Field	HOUR0 标识 HOUR0 字段的常量，其合法的值是 1 到 11。
static DateFormat.Field	HOUR1 标识 HOUR1 字段的常量，其合法的值是 1 到 12。
static DateFormat.Field	MILLISECOND 标识 MILLISECOND 字段的常量。
static DateFormat.Field	MINUTE 标识 MINUTE 字段的常量。
static DateFormat.Field	MONTH 标识 MONTH 字段的常量。
static DateFormat.Field	SECOND 标识 SECOND 字段的常量。
static DateFormat.Field	TIME_ZONE 标识 TIME_ZONE 字段的常量。
static DateFormat.Field	WEEK_OF_MONTH 标识 WEEK_OF_MONTH 字段的常量。
static DateFormat.Field	WEEK_OF_YEAR 标识 WEEK_OF_YEAR 字段的常量。
static DateFormat.Field	YEAR 标识 YEAR 字段的常量。

从类 java.text.AttributedCharacterIterator.Attribute 继承的字段

INPUT_METHOD_SEGMENT, LANGUAGE, READING

构造方法摘要

protected

DateFormat.Field(String name, int calendarField) 创建一个 Field。

方法摘要

int	getCalendarField() 返回与此属性关联的 Calendar 字段。
static DateFormat.Field	ofCalendarField(int calendarField) 返回与此 Calendar 常量 calendarField 对应的 Field 常量。
protected Object	readResolve() 将反序列化的实例解析成预定义的常量。

从类 java.text.AttributedCharacterIterator.Attribute 继承的方法

equals, getName, hashCode, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

ERA

public static final DateFormat.Field ERA

标识 ERA 字段的常量。

YEAR

public static final DateFormat.Field YEAR

标识 YEAR 字段的常量。

MONTH

public static final DateFormat.Field MONTH

标识 MONTH 字段的常量。

DAY_OF_MONTH

public static final DateFormat.Field DAY_OF_MONTH

标识 DAY_OF_MONTH 字段的常量。

HOUR_OF_DAY1

public static final DateFormat.Field HOUR_OF_DAY1

标识 HOUR_OF_DAY1 字段的常量，其合法的值是 1 到 24。

HOUR_OF_DAY0

public static final DateFormat.Field HOUR_OF_DAY0

标识 HOUR_OF_DAY0 字段的常量，其合法的值是 0 到 23。

MINUTE

public static final DateFormat.Field MINUTE

标识 MINUTE 字段的常量。

SECOND

public static final DateFormat.Field SECOND

标识 SECOND 字段的常量。

MILLISECOND

public static final DateFormat.Field MILLISECOND

标识 MILLISECOND 字段的常量。

DAY_OF_WEEK

public static final DateFormat.Field DAY_OF_WEEK

标识 DAY_OF_WEEK 字段的常量。

DAY_OF_YEAR

public static final DateFormat.Field DAY_OF_YEAR

标识 DAY_OF_YEAR 字段的常量。

DAY_OF_WEEK_IN_MONTH

public static final DateFormat.Field DAY_OF_WEEK_IN_MONTH

标识 DAY_OF_WEEK_IN_MONTH 字段的常量。

WEEK_OF_YEAR

public static final DateFormat.Field WEEK_OF_YEAR

标识 WEEK_OF_YEAR 字段的常量。

WEEK_OF_MONTH

public static final DateFormat.Field WEEK_OF_MONTH

标识 WEEK_OF_MONTH 字段的常量。

AM_PM

public static final DateFormat.Field AM_PM

标识每日时间指示符（例如 "a.m." 或 "p.m."）的常量。

HOUR1

public static final DateFormat.Field HOUR1

标识 HOUR1 字段的常量，其合法的值是 1 到 12。

HOUR0

public static final DateFormat.Field HOUR0

标识 HOUR0 字段的常量，其合法的值是 1 到 11。

TIME_ZONE

public static final DateFormat.Field TIME_ZONE

标识 TIME_ZONE 字段的常量。

构造方法详细信息

DateFormat.Field

protected DateFormat.Field(String name,
                           int calendarField)

创建一个 Field。

参数：

name - Field 的名称

calendarField - 与此 Field 一致的 Calendar 常量；可以使用任意值，即使是超出合法的 Calendar 范围的值，但是在与合法的 Calendar 值不一致的情况下，应该使用 -1。

方法详细信息

ofCalendarField

public static DateFormat.Field ofCalendarField(int calendarField)

返回与此 Calendar 常量 calendarField 对应的 Field 常量。如果 Calendar 常量与 Field 之间没有直接的映射关系，则返回 null。

参数：

calendarField - Calendar 字段常量

返回：

表示 calendarField 的 Field 实例。

抛出：

IllegalArgumentException - 如果 calendarField 不是 Calendar 字段常量值。

另请参见：

Calendar

getCalendarField

public int getCalendarField()

返回与此属性关联的 Calendar 字段。例如，如果此属性表示 Calendar 的 HOUR 字段，则此方法返回 Calendar.HOUR。如果没有对应的 Calendar 常量，则此方法返回 -1。

返回：

此字段的 Calendar 常量

另请参见：

Calendar

readResolve

protected Object readResolve()
                      throws InvalidObjectException

将反序列化的实例解析成预定义的常量。

覆盖：

类 AttributedCharacterIterator.Attribute 中的 readResolve

返回：

解析后的 DateFormat.Field 常量

抛出：

InvalidObjectException - 如果无法解析该常量。