java.text
类 DateFormatSymbols

java.lang.Object
  java.text.DateFormatSymbols

所有已实现的接口：

Serializable, Cloneable

public class DateFormatSymbols
extends Object
implements Serializable, Cloneable

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

通常不应直接使用 DateFormatSymbols。相反，鼓励使用 DateFormat 类的工厂方法创建日期-时间 formatter：getTimeInstance、getDateInstance 或 getDateTimeInstance。这些方法自动为 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.SUNDAY、Calendar.MONDAY 等来索引得到的数组。

setWeekdays

public void setWeekdays(String[] newWeekdays)

设置星期几字符串。例如："Sunday"、"Monday" 等等。

参数：

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

getShortWeekdays

public String[] getShortWeekdays()

获得给定语言环境简短形式的星期几字符串。例如："Sun"、"Mon" 等等。

返回：

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

setShortWeekdays

public void setShortWeekdays(String[] newShortWeekdays)

设置简短形式的星期几字符串。例如："Sun"、"Mon" 等等。

参数：

newShortWeekdays - 新的简短形式星期几字符串。应该通过 Calendar.SUNDAY、Calendar.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