DateFormatSymbols (Java Platform SE 7)

java.lang.Object
- java.text.DateFormatSymbols

すべての実装されたインタフェース:

Serializable、Cloneable
```
public class DateFormatSymbols
extends Object
implements Serializable, Cloneable
```
DateFormatSymbols は、月、曜日、タイムゾーンデータなど、ローカライズが可能な日付/時刻フォーマットデータをカプセル化するための public クラスです。 DateFormat クラスと SimpleDateFormat クラスはどちらも、DateFormatSymbols クラスを使ってこの情報をカプセル化します。
一般には、DateFormatSymbols を直接使うことはしません。その代わりに、できるだけ DateFormat クラスのファクトリメソッド 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()` 午前/午後の文字列を取得します。
`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)` 午前/午後の文字列を設定します。
`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 インスタンスが少なくとも 1 つ含まれている必要があります。
    
    戻り値:
    ローカライズされた 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 インスタンスにアクセスできます。
    
    パラメータ:
    locale - 指定されたロケール。
    
    戻り値:
    DateFormatSymbols のインスタンス。
    
    例外:
    
    NullPointerException - 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()
```
    午前/午後の文字列を取得します。例: 「AM」、「PM」。
    
    戻り値:
    午前/午後の文字列。
  - setAmPmStrings
```
public void setAmPmStrings(String[] newAmpms)
```
    午前/午後の文字列を設定します。例: 「AM」、「PM」。
    
    パラメータ:
    newAmpms - 新しい午前/午後の文字列。
  - getZoneStrings
```
public String[][] getZoneStrings()
```
    タイムゾーンの文字列を取得します。このメソッドを使用することは推奨されません。代わりに、TimeZone.getDisplayName() を使用してください。
    返される値は、サイズが n × m の 2 次元の文字列配列で、この場合の m は 5 以上になります。各 n 行は、単一の TimeZone に対してローカライズされた名前を含むエントリです。各行には次のものが含まれます (i は 0 から n-1 の範囲内)。
    - zoneStrings[i][0] - タイムゾーン ID
    - zoneStrings[i][1] - 標準時刻のゾーンの長い名前
    - zoneStrings[i][2] - 標準時刻のゾーンの短い名前
    - zoneStrings[i][3] - 夏時間のゾーンの長い名前
    - zoneStrings[i][4] - 夏時間のゾーンの短い名前
    ゾーン ID はローカライズされていません。TimeZone クラスの、カスタム ID ではない有効な ID のいずれかになります。ほかのエントリはすべてローカライズされた名前です。ゾーンで夏時間が実装されていない場合、夏時間の名前は使用しないようにしてください。
    この DateFormatSymbols インスタンスに対して setZoneStrings がすでに呼び出されていた場合は、その呼び出しによって指定された文字列が返されます。それ以外の場合、返される配列には、Java ランタイムおよびインストールされている TimeZoneNameProvider 実装によって提供されている名前が格納されます。
    戻り値:
    タイムゾーンの文字列。
    関連項目:
    setZoneStrings(String[][])
  - setZoneStrings
```
public void setZoneStrings(String[][] newZoneStrings)
```
    タイムゾーンの文字列を設定します。引数は、サイズが n × m の 2 次元の文字列配列を指定する必要があり、この場合の m は 5 以上になります。各 n 行は、単一の TimeZone に対してローカライズされた名前を含むエントリです。各行には次のものが含まれます (i は 0 から n-1 の範囲内)。
    - zoneStrings[i][0] - タイムゾーン ID
    - zoneStrings[i][1] - 標準時刻のゾーンの長い名前
    - zoneStrings[i][2] - 標準時刻のゾーンの短い名前
    - zoneStrings[i][3] - 夏時間のゾーンの長い名前
    - zoneStrings[i][4] - 夏時間のゾーンの短い名前
    ゾーン 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 をオーバーライドします。
    
    オーバーライド:
    
    clone、クラス: Object
    
    戻り値:
    このインスタンスの複製。
    関連項目:
    Cloneable
  - hashCode
```
public int hashCode()
```
    hashCode をオーバーライドします。DateFormatSymbols オブジェクトのハッシュコードを生成します。
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    このオブジェクトのハッシュコード値。
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    equals をオーバーライドします。
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    obj - 比較対象の参照オブジェクト。
    
    戻り値:
    このオブジェクトが obj 引数と同じである場合は true、それ以外の場合は false。
    関連項目:
    Object.hashCode()、HashMap

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス DateFormatSymbols

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

DateFormatSymbols

DateFormatSymbols

メソッドの詳細

getAvailableLocales

getInstance

getInstance

getEras

setEras

getMonths

setMonths

getShortMonths

setShortMonths

getWeekdays

setWeekdays

getShortWeekdays

setShortWeekdays

getAmPmStrings

setAmPmStrings

getZoneStrings

setZoneStrings

getLocalPatternChars

setLocalPatternChars

clone

hashCode

equals