概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

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。這些方法自動為格式器創建一個 DateFormatSymbols，所以使用者就不必再創建了。創建了格式器後，可使用 setPattern 方法修改它的格式網要。有關使用 DateFormat 的處理器方法創建格式器的更多資訊，請參閱 DateFormat。

如果要為特定語言環境創建具有特定格式網要的日期-時間格式器，可使用以下語句實作： 

 new SimpleDateFormat(aPattern, DateFormatSymbols.getInstance(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 字元串。
static Locale[] getAvailableLocales()
          返回一個陣列，它由此類別的 getInstance 方法可為之返回本地化實例的所有語言環境組成。
 String[] getEras()
          獲取年代字元串。
static DateFormatSymbols getInstance()
          獲取預設語言環境的 DateFormatSymbols 實例。
static DateFormatSymbols getInstance(Locale locale)
          獲取指定語言環境的 DateFormatSymbols 實例。
 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 物件。此建構子只能建構 Java 運行時環境所支持的語言環境實例，不能建構已安裝的 DateFormatSymbolsProvider 實作所支持的語言環境實例。要覆寫所有的語言環境，可使用 getInstance 方法。

拋出：
MissingResourceException - 如果無法找到或載入預設語言環境的資源。
另請參見：
getInstance()

DateFormatSymbols

public DateFormatSymbols(Locale locale)
通過從給定語言環境資源載入格式資料，建構一個 DateFormatSymbols 物件。此建構子只能建構 Java 運行時環境所支持的語言環境實例，不能建構已安裝的 DateFormatSymbolsProvider 實作所支持的語言環境實例。要覆寫所有的語言環境，可使用 getInstance 方法。

拋出：
MissingResourceException - 如果無法找到或載入指定語言環境的資源。
另請參見：
getInstance(Locale)
方法詳細資訊

getAvailableLocales

public static Locale[] getAvailableLocales()
返回一個陣列，它由此類別的 getInstance 方法可為之返回本地化實例的所有語言環境組成。返回的陣列表示 Java 運行時所支持的語言環境和已安裝的 DateFormatSymbolsProvider 實作所支持的語言環境的並集。 它至少必須包含一個等於 Locale.US 的 Locale 實例。

返回：
一個語言環境陣列，可獲取這些語言環境的本地化 DateFormatSymbols 實例。
從以下版本開始：
1.6

getInstance

public static final DateFormatSymbols getInstance()
獲取預設語言環境的 DateFormatSymbols 實例。此方法可存取 Java 運行時本身以及已安裝 DateFormatSymbolsProvider 實作所支持的語言環境的 DateFormatSymbols 實例。

返回：
一個 DateFormatSymbols 實例。
從以下版本開始：
1.6

getInstance

public static final DateFormatSymbols getInstance(Locale locale)
獲取指定語言環境的 DateFormatSymbols 實例。此方法可存取 Java 運行時本身以及已安裝 DateFormatSymbolsProvider 實作所支持的語言環境的 DateFormatSymbols 實例。

參數：
給定的語言環境 -
返回：
一個 DateFormatSymbols 實例。
拋出：
如果 - locale 為 null
從以下版本開始：
1.6

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()
獲取時區字元串。不建議使用此方法；可以使用 TimeZone.getDisplayName() 替代。

返回值是一個二維字元串數字，其大小為 n × m，其中 m 至少為 5。每個 n 行都是一個套件含單個 TimeZone 本地化名稱的條目。每個這樣的行包含（i 的範圍從 0 到 n-1）：

時區 ID 沒有 被本地化；它是 TimeZone 類別的有效 ID 之一，但不是自定義 ID。其他所有條目都是本地化名稱。如果某個時區沒有實作夏令時，則不能使用夏令時名稱。

如果沒有在此 DateFormatSymbols 實例上調用 setZoneStrings，則返回該調用提供的字元串。否則，返回的陣列包含 Java 運行時和已安裝的 TimeZoneNameProvider 實作所提供的名稱。

返回：
時區字元串。
另請參見：
setZoneStrings(String[][])

setZoneStrings

public void setZoneStrings(String[][] newZoneStrings)
設置時區字元串。該參數必須是一個二維字元串陣列，其大小為 n × m，其中 m 至少為 5。每個 n 行都是一個套件含單個 TimeZone 本地化名稱的條目。每個這樣的行包含（i 的範圍從 0 到 n-1）： 時區 ID 沒有 被本地化；它是 TimeZone 類別的有效 ID 之一，但不是自定義 ID。其他所有條目都是本地化名稱。

參數：
newZoneStrings - 新的時區字元串。
拋出：
IllegalArgumentException - 如果 newZoneStrings 中任何行的長度小於 5
NullPointerException - 如果 newZoneStrings 為 null
另請參見：
getZoneStrings()

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. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。