JavaTM 2 Platform
Standard Ed. 5.0

java.text
类 DateFormatSymbols

java.lang.Object
  继承者 java.text.DateFormatSymbols
所有已实现的接口:
Serializable, Cloneable

public class DateFormatSymbols
extends Object
implements Serializable, Cloneable

DateFormatSymbols 是一个公共类,用于封装可本地化的日期-时间格式化数据,如月名、星期几的名称和时区数据。DateFormatSimpleDateFormat 都使用 DateFormatSymbols 来封装此信息。

通常不应直接使用 DateFormatSymbols。相反,鼓励使用 DateFormat 类的工厂方法创建日期-时间 formatter:getTimeInstancegetDateInstancegetDateTimeInstance。这些方法自动为 formatter 创建一个 DateFormatSymbols,所以用户就不必再创建了。创建 formatter 后,可使用 setPattern 方法修改其格式模式。有关使用 DateFormat 的工厂方法创建 formatter 的更多信息,请参阅 DateFormat

如果要为具体的语言环境创建具有具体格式模式的日期-时间 formatter,可以:

 new SimpleDateFormat(aPattern, new DateFormatSymbols(aLocale)).
 

DateFormatSymbols 对象是可克隆的。获得一个 DateFormatSymbols 对象后,即可随意修改日期-时间格式化数据。例如,可以使用便于记忆的字符替换已本地化的日期-时间格式模式字符。或者可以将有代表性的城市更改为最喜欢的城市。

要为其他语言环境进行日期-时间格式化,可添加新的 DateFormatSymbols 子类以支持 SimpleDateFormat

另请参见:
DateFormat, SimpleDateFormat, SimpleTimeZone, 序列化表格

构造方法摘要
DateFormatSymbols()
          通过从默认语言环境的资源加载格式数据构造一个 DateFormatSymbols 对象。
DateFormatSymbols(Locale locale)
          通过从给定语言环境的资源中加载格式数据构造一个 DateFormatSymbols 对象。
 
方法摘要
 Object clone()
          重写 Cloneable
 boolean equals(Object obj)
          重写 equals
 String[] getAmPmStrings()
          获得 ampm 字符串。
 String[] getEras()
          获得年代字符串。
 String getLocalPatternChars()
          获得已本地化的日期-时间模式字符。
 String[] getMonths()
          获得月份字符串。
 String[] getShortMonths()
          获得简短形式的月份字符串。
 String[] getShortWeekdays()
          获得给定语言环境简短形式的星期几字符串。
 String[] getWeekdays()
          获得星期几字符串。
 String[][] getZoneStrings()
          获得时区字符串。
 int hashCode()
          重写 hashCode。
 void setAmPmStrings(String[] newAmpms)
          设置 ampm 字符串。
 void setEras(String[] newEras)
          设置年代字符串。
 void setLocalPatternChars(String newLocalPatternChars)
          设置已本地化的日期-时间模式字符。
 void setMonths(String[] newMonths)
          设置月份字符串。
 void setShortMonths(String[] newShortMonths)
          设置简短形式的月份字符串。
 void setShortWeekdays(String[] newShortWeekdays)
          设置简短形式的星期几字符串。
 void setWeekdays(String[] newWeekdays)
          设置星期几字符串。
 void setZoneStrings(String[][] newZoneStrings)
          设置时区字符串。
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

DateFormatSymbols

public DateFormatSymbols()
通过从默认语言环境的资源加载格式数据构造一个 DateFormatSymbols 对象。

抛出:
MissingResourceException - 如果无法找到或加载默认语言环境的资源。

DateFormatSymbols

public DateFormatSymbols(Locale locale)
通过从给定语言环境的资源中加载格式数据构造一个 DateFormatSymbols 对象。

抛出:
MissingResourceException - 如果无法找到或加载指定语言环境的资源。
方法详细信息

getEras

public String[] getEras()
获得年代字符串。例如:"AD" 和 "BC"。

返回:
年代字符串。

setEras

public void setEras(String[] newEras)
设置年代字符串。例如:"AD" 和 "BC"。

参数:
newEras - 新的年代字符串。

getMonths

public String[] getMonths()
获得月份字符串。例如:"January"、"February" 等等。

返回:
月份字符串。

setMonths

public void setMonths(String[] newMonths)
设置月份字符串。例如:"January"、"February" 等等。

参数:
newMonths - 新的月份字符串。

getShortMonths

public String[] getShortMonths()
获得简短形式的月份字符串。例如:"Jan"、"Feb" 等等。

返回:
简短形式的月份字符串。

setShortMonths

public void setShortMonths(String[] newShortMonths)
设置简短形式的月份字符串。例如:"Jan"、"Feb" 等等

参数:
newShortMonths - 新的简写形式的月份字符串。

getWeekdays

public String[] getWeekdays()
获得星期几字符串。例如:"Sunday"、"Monday" 等等。

返回:
星期几字符串。使用 Calendar.SUNDAYCalendar.MONDAY 等来索引得到的数组。

setWeekdays

public void setWeekdays(String[] newWeekdays)
设置星期几字符串。例如:"Sunday"、"Monday" 等等。

参数:
newWeekdays - 新的星期几字符串。应该通过 Calendar.SUNDAYCalendar.MONDAY 等来索引该数组。

getShortWeekdays

public String[] getShortWeekdays()
获得给定语言环境简短形式的星期几字符串。例如:"Sun"、"Mon" 等等。

返回:
简短形式的星期几字符串。使用 Calendar.SUNDAYCalendar.MONDAY 等来索引得到的数组。

setShortWeekdays

public void setShortWeekdays(String[] newShortWeekdays)
设置简短形式的星期几字符串。例如:"Sun"、"Mon" 等等。

参数:
newShortWeekdays - 新的简短形式星期几字符串。应该通过 Calendar.SUNDAYCalendar.MONDAY 等来索引该数组。

getAmPmStrings

public String[] getAmPmStrings()
获得 ampm 字符串。例如:"AM" 和 "PM"。

返回:
ampm 字符串。

setAmPmStrings

public void setAmPmStrings(String[] newAmpms)
设置 ampm 字符串。例如:"AM" 和 "PM"。

参数:
newAmpms - 新的 ampm 字符串。

getZoneStrings

public String[][] getZoneStrings()
获得时区字符串。

返回:
时区字符串。

setZoneStrings

public void setZoneStrings(String[][] newZoneStrings)
设置时区字符串。

参数:
newZoneStrings - 新的时区字符串。

getLocalPatternChars

public String getLocalPatternChars()
获得已本地化的日期-时间模式字符。例如:'u'、't' 等等。

返回:
已本地化的日期-时间模式字符。

setLocalPatternChars

public void setLocalPatternChars(String newLocalPatternChars)
设置已本地化的日期-时间模式字符。例如:'u'、't' 等等。

参数:
newLocalPatternChars - 新的已本地化的日期-时间模式字符。

clone

public Object clone()
重写 Cloneable

覆盖:
Object 中的 clone
返回:
此实例的一个克隆。
另请参见:
Cloneable

hashCode

public int hashCode()
重写 hashCode。生成 DateFormatSymbols 对象的哈希码。

覆盖:
Object 中的 hashCode
返回:
此对象的一个哈希码值。
另请参见:
Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)
重写 equals

覆盖:
Object 中的 equals
参数:
obj - 要与之比较的引用对象。
返回:
如果此对象与 obj 参数相同,则返回 true;否则返回 false
另请参见:
Object.hashCode(), Hashtable

JavaTM 2 Platform
Standard Ed. 5.0

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

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