JavaTM 2 Platform
Standard Ed. 6

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 - 如果无法解析该常量。

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策