JavaTM 2 Platform
Standard Ed. 5.0

java.text
クラス DateFormat

java.lang.Object
  上位を拡張 java.text.Format
      上位を拡張 java.text.DateFormat
すべての実装されたインタフェース:
Serializable, Cloneable
直系の既知のサブクラス:
SimpleDateFormat

public abstract class DateFormat
extends Format

DateFormat は、言語に依存しない方法で日付または時刻をフォーマットおよび解析する、日付/時刻フォーマットサブクラスの抽象クラスです。SimpleDateFormat などの日付/時刻フォーマットサブクラスによって、フォーマット (日付 -> テキスト)、解析 (テキスト -> 日付)、および正規化を行うことができます。日付は、Date オブジェクトまたは 1970 年 1 月 1 日グリニッジ標準時 00:00:00 からのミリ秒で表現されます。

DateFormat は、デフォルト値、指定されたロケール、多くのフォーマットスタイルに基づいて、デフォルトの日付/時刻フォーマッタを取得する多くのクラスメソッドを提供します。フォーマットスタイルには FULL、LONG、MEDIUM、および SHORT があります。これらのスタイルの詳細と使用例については、メソッドの説明を参照してください。

DateFormat は、すべてのロケールの日付についてフォーマットおよび解析を支援します。コードは、月、曜日、カレンダフォーマット、陰暦太陽暦などロケールの慣習とは完全に独立しています。

現在のロケール用に日付をフォーマットするためには、次の static ファクトリメソッドの 1 つを使用します。


  myString = DateFormat.getDateInstance().format(myDate);
 

複数の日付をフォーマットする場合には、そのフォーマットを取得して、それを複数回使う方が効率的です。これにより、システムがローカルの言語と国のルールを何度も取得する必要がなくなります。


  DateFormat df = DateFormat.getDateInstance();
  for (int i = 0; i < myDate.length; ++i) {
    output.println(df.format(myDate[i]) + "; ");
  }
 

ある日付を異なるロケールに対してフォーマットする場合には、getDateInstance() の呼び出しにその日付を指定します。


  DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
 

さらに、解析のために DateFormat を使用できます。


  myDate = df.parse(myString);
 

その国の通常の日付フォーマットを取得するには、getDateInstance を使用します。ほかにも使用可能な static ファクトリメソッドがあります。その国の時刻フォーマットを取得するには、getTimeInstance を使用します。日付と時刻フォーマットを取得するには、getDateTimeInstance を使用します。結果の長さを制御するために、これらのファクトリメソッドを異なるオプションで渡すことができます (SHORT から MEDIUM、LONG、FULL へ)。正確な結果はロケールに依存しますが、一般的には次のようになります。

必要に応じて、フォーマットにタイムゾーンを設定することもできます。フォーマットや解析をさらに制御する場合 (または、ユーザにそのような制御を与える場合) には、ファクトリメソッドから得た DateFormat を SimpleDateFormat にキャストする方法を試行することもできます。この方法はほとんどの国に有効ですが、そうでない場合に備えて、try ブロックに入れるようにしてください。

さらに、parse と format メソッドの形式を ParsePosition と FieldPosition と一緒に使用すれば、次のことが行えます。

同期

日付フォーマットは同期化されません。スレッドごとに別のフォーマットインスタンスを作成することをお勧めします。複数のスレッドがフォーマットに同時にアクセスする場合は、外部的に同期化する必要があります。

関連項目:
Format, NumberFormat, SimpleDateFormat, Calendar, GregorianCalendar, TimeZone, 直列化された形式

入れ子のクラスの概要
static class DateFormat.Field
          DateFormat.formatToCharacterIterator から返された AttributedCharacterIterator 内の属性キー、および FieldPosition 内のフィールド識別子として使用する定数を定義します。
 
フィールドの概要
static int AM_PM_FIELD
          AM_PM フィールドの位置合わせのための定数です。
protected  Calendar calendar
          日付と時刻のフォーマットを行うためのタイムフィールドの値を生成するために DateFormat が使用するカレンダです。
static int DATE_FIELD
          DATE フィールドの位置合わせのための定数です。
static int DAY_OF_WEEK_FIELD
          DAY_OF_WEEK フィールドの位置合わせのための定数です。
static int DAY_OF_WEEK_IN_MONTH_FIELD
          DAY_OF_WEEK_IN_MONTH フィールドの位置合わせのための定数です。
static int DAY_OF_YEAR_FIELD
          DAY_OF_YEAR フィールドの位置合わせのための定数です。
static int DEFAULT
          デフォルトスタイルパターンのための定数です。
static int ERA_FIELD
          ERA フィールドの位置合わせのための定数です。
static int FULL
          全スタイルパターンのための定数です。
static int HOUR_OF_DAY0_FIELD
          0 から始まる HOUR_OF_DAY フィールドの位置合わせのための定数です。
static int HOUR_OF_DAY1_FIELD
          1 から始まる HOUR_OF_DAY フィールドの位置合わせのための定数です。
static int HOUR0_FIELD
          0 から始まる HOUR フィールドの位置合わせのための定数です。
static int HOUR1_FIELD
          1 から始まる HOUR フィールドの位置合わせのための定数です。
static int LONG
          長いスタイルパターンのための定数です。
static int MEDIUM
          長さが中位のスタイルパターンのための定数です。
static int MILLISECOND_FIELD
          MILLISECOND フィールドの位置合わせのための定数です。
static int MINUTE_FIELD
          MINUTE フィールドの位置合わせのための定数です。
static int MONTH_FIELD
          MONTH フィールドの位置合わせのための定数です。
protected  NumberFormat numberFormat
          日付と時刻の数値をフォーマットするために DateFormat が使用する数値フォーマッタです。
static int SECOND_FIELD
          SECOND フィールドの位置合わせのための定数です。
static int SHORT
          短いスタイルパターンのための定数です。
static int TIMEZONE_FIELD
          TIMEZONE フィールドの位置合わせのための定数です。
static int WEEK_OF_MONTH_FIELD
          WEEK_OF_MONTH フィールドの位置合わせのための定数です。
static int WEEK_OF_YEAR_FIELD
          WEEK_OF_YEAR フィールドの位置合わせのための定数です。
static int YEAR_FIELD
          YEAR フィールドの位置合わせのための定数です。
 
コンストラクタの概要
protected DateFormat()
          新しい日付フォーマットを作成します。
 
メソッドの概要
 Object clone()
          Cloneable をオーバーライドします。
 boolean equals(Object obj)
          equals をオーバーライドします。
 String format(Date date)
          Date を日付/時刻文字列にフォーマットします。
abstract  StringBuffer format(Date date, StringBuffer toAppendTo, FieldPosition fieldPosition)
          Date を日付/時刻文字列にフォーマットします。
 StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition)
          Format をオーバーライドします。
static Locale[] getAvailableLocales()
          このクラスの get*Instance メソッドが地域対応のインスタンスを返すことのできるロケールすべての配列を返します。
 Calendar getCalendar()
          この日付/時刻フォーマッタに対応するカレンダを取得します。
static DateFormat getDateInstance()
          デフォルトのロケールに対し、デフォルトのフォーマットスタイルを持つ日付フォーマッタを取得します。
static DateFormat getDateInstance(int style)
          デフォルトのロケールに対し、指定されたフォーマットスタイルを持つ日付フォーマッタを取得します。
static DateFormat getDateInstance(int style, Locale aLocale)
          指定されたロケールに対し、指定されたフォーマットスタイルを持つ日付フォーマッタを取得します。
static DateFormat getDateTimeInstance()
          デフォルトのロケールに対し、デフォルトのフォーマットスタイルを持つ日付/時刻フォーマッタを取得します。
static DateFormat getDateTimeInstance(int dateStyle, int timeStyle)
          デフォルトのロケールに対し、指定された日付/時刻フォーマットスタイルを持つ日付/時刻フォーマッタを取得します。
static DateFormat getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale)
          指定されたロケールに対し、指定されたフォーマットスタイルを持つ日付/時刻フォーマッタを取得します。
static DateFormat getInstance()
          日付と時刻の両方に対し SHORT スタイルを持つ日付/時刻フォーマッタを取得します。
 NumberFormat getNumberFormat()
          時刻のフォーマットと解析のためにこの日付/時刻フォーマッタが使用する数値フォーマッタを取得します。
static DateFormat getTimeInstance()
          デフォルトのロケールに対し、デフォルトのフォーマットスタイルを持つ時刻フォーマッタを取得します。
static DateFormat getTimeInstance(int style)
          デフォルトのロケールに対し、指定されたフォーマットスタイルを持つ時刻フォーマッタを取得します。
static DateFormat getTimeInstance(int style, Locale aLocale)
          指定されたロケールに対し、指定されたフォーマットスタイルを持つ時刻フォーマッタを取得します。
 TimeZone getTimeZone()
          タイムゾーンを取得します。
 int hashCode()
          hashCode をオーバーライドします。
 boolean isLenient()
          日付/時刻の解析を厳密に行うかどうかを判定します。
 Date parse(String source)
          指定された文字列の先頭からテキストを解析して日付を生成します。
abstract  Date parse(String source, ParsePosition pos)
          指定された解析位置に従って日付/時刻文字列を解析します。
 Object parseObject(String source, ParsePosition pos)
          文字列からテキストを解析して Date を生成します。
 void setCalendar(Calendar newCalendar)
          この日付フォーマットで使用するカレンダを設定します。
 void setLenient(boolean lenient)
          日付/時刻解析を厳密に行うかどうかを設定します。
 void setNumberFormat(NumberFormat newNumberFormat)
          数値フォーマッタを設定します。
 void setTimeZone(TimeZone zone)
          この DateFormat オブジェクトのカレンダのタイムゾーンを設定します。
 
クラス java.text.Format から継承されたメソッド
format, formatToCharacterIterator, parseObject
 
クラス java.lang.Object から継承されたメソッド
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

calendar

protected Calendar calendar
日付と時刻のフォーマットを行うためのタイムフィールドの値を生成するために DateFormat が使用するカレンダです。サブクラスは、このカレンダを、この DateFormat に対応するロケールに適したカレンダに初期化する必要があります。


numberFormat

protected NumberFormat numberFormat
日付と時刻の数値をフォーマットするために DateFormat が使用する数値フォーマッタです。サブクラスは、この数値フォーマッタを、この DateFormat に対応するロケールに適した数値フォーマットに初期化する必要があります。


ERA_FIELD

public static final int ERA_FIELD
ERA フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

YEAR_FIELD

public static final int YEAR_FIELD
YEAR フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

MONTH_FIELD

public static final int MONTH_FIELD
MONTH フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

DATE_FIELD

public static final int DATE_FIELD
DATE フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

HOUR_OF_DAY1_FIELD

public static final int HOUR_OF_DAY1_FIELD
1 から始まる HOUR_OF_DAY フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。HOUR_OF_DAY1_FIELD は、1 から始まる 24 時間時計で使用します。たとえば、23:59 + 01:00 は 24:59 となります。

関連項目:
定数フィールド値

HOUR_OF_DAY0_FIELD

public static final int HOUR_OF_DAY0_FIELD
0 から始まる HOUR_OF_DAY フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。HOUR_OF_DAY0_FIELD は、0 から始まる 24 時間時計で使用します。たとえば、23:59 + 01:00 は 00:59 となります。

関連項目:
定数フィールド値

MINUTE_FIELD

public static final int MINUTE_FIELD
MINUTE フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

SECOND_FIELD

public static final int SECOND_FIELD
SECOND フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

MILLISECOND_FIELD

public static final int MILLISECOND_FIELD
MILLISECOND フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

DAY_OF_WEEK_FIELD

public static final int DAY_OF_WEEK_FIELD
DAY_OF_WEEK フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

DAY_OF_YEAR_FIELD

public static final int DAY_OF_YEAR_FIELD
DAY_OF_YEAR フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

DAY_OF_WEEK_IN_MONTH_FIELD

public static final int DAY_OF_WEEK_IN_MONTH_FIELD
DAY_OF_WEEK_IN_MONTH フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

WEEK_OF_YEAR_FIELD

public static final int WEEK_OF_YEAR_FIELD
WEEK_OF_YEAR フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

WEEK_OF_MONTH_FIELD

public static final int WEEK_OF_MONTH_FIELD
WEEK_OF_MONTH フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

AM_PM_FIELD

public static final int AM_PM_FIELD
AM_PM フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

HOUR1_FIELD

public static final int HOUR1_FIELD
1 から始まる HOUR フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。HOUR1_FIELD は、1 から始まる 12 時間時計で使用します。たとえば、11:30 PM + 1 時間は 12:30 AM となります。

関連項目:
定数フィールド値

HOUR0_FIELD

public static final int HOUR0_FIELD
0 から始まる HOUR フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。HOUR0_FIELD は、0 から始まる 12 時間時計で使用します。たとえば、11:30 PM + 1 時間は 00:30 AM となります。

関連項目:
定数フィールド値

TIMEZONE_FIELD

public static final int TIMEZONE_FIELD
TIMEZONE フィールドの位置合わせのための定数です。日付/時刻フォーマット機能の FieldPosition で使用します。

関連項目:
定数フィールド値

FULL

public static final int FULL
全スタイルパターンのための定数です。

関連項目:
定数フィールド値

LONG

public static final int LONG
長いスタイルパターンのための定数です。

関連項目:
定数フィールド値

MEDIUM

public static final int MEDIUM
長さが中位のスタイルパターンのための定数です。

関連項目:
定数フィールド値

SHORT

public static final int SHORT
短いスタイルパターンのための定数です。

関連項目:
定数フィールド値

DEFAULT

public static final int DEFAULT
デフォルトスタイルパターンのための定数です。値は MEDIUM です。

関連項目:
定数フィールド値
コンストラクタの詳細

DateFormat

protected DateFormat()
新しい日付フォーマットを作成します。

メソッドの詳細

format

public final StringBuffer format(Object obj,
                                 StringBuffer toAppendTo,
                                 FieldPosition fieldPosition)
Format をオーバーライドします。時刻オブジェクトを時刻文字列にフォーマットします。時刻オブジェクトの例としては、ミリ秒と Date オブジェクトで表す時刻値があります。

定義:
クラス Format 内の format
パラメータ:
obj - Number または Date にする必要がある
toAppendTo - 返される時刻文字列のための文字列バッファ
fieldPosition - 返された文字列内のフィールド位置を把握する。入力時は、必要であれば位置合わせフィールド。出力時は、位置合わせフィールドのオフセット。たとえば「1996.07.10 AD at 15:08:56 PDT」という時刻テキストが指定された場合に、指定された fieldPosition が DateFormat.YEAR_FIELD であれば、fieldPosition の開始インデックスと終了インデックスはそれぞれ 0 と 4 に設定される。同じ時刻フィールドがパターン内で複数回現れる場合、fieldPosition はその時刻フィールドの最初のものに設定される。たとえば、パターン「h a z (zzzz)」と位置合わせフィールドの DateFormat.TIMEZONE_FIELD を使って Date を時刻文字列「1 PM PDT (Pacific Daylight Time)」にフォーマットすると、fieldPosition の開始インデックスと終了インデックスはそれぞれ、最初に現れたタイムゾーンパターン文字「z」に対して 5 と 8 に設定される
戻り値:
フォーマットされた時刻文字列
関連項目:
Format

format

public abstract StringBuffer format(Date date,
                                    StringBuffer toAppendTo,
                                    FieldPosition fieldPosition)
Date を日付/時刻文字列にフォーマットします。

パラメータ:
date - 日付/時刻文字列にフォーマットする Date
toAppendTo - 返される日付/時刻文字列のための文字列バッファ
fieldPosition - 返された文字列内のフィールド位置を把握する。入力時は、必要であれば位置合わせフィールド。出力時は、位置合わせフィールドのオフセット。たとえば「1996.07.10 AD at 15:08:56 PDT」という時刻テキストが指定された場合に、指定された fieldPosition が DateFormat.YEAR_FIELD であれば、fieldPosition の開始インデックスと終了インデックスはそれぞれ 0 と 4 に設定される。同じ時刻フィールドがパターン内で複数回現れる場合、fieldPosition はその時刻フィールドの最初のものに設定される。たとえば、パターン「h a z (zzzz)」と位置合わせフィールドの DateFormat.TIMEZONE_FIELD を使って Date を時刻文字列「1 PM PDT (Pacific Daylight Time)」にフォーマットすると、fieldPosition の開始インデックスと終了インデックスはそれぞれ、最初に現れたタイムゾーンパターン文字「z」に対して 5 と 8 に設定される
戻り値:
フォーマットされた日付/時刻文字列

format

public final String format(Date date)
Date を日付/時刻文字列にフォーマットします。

パラメータ:
date - 時刻文字列にフォーマットする時刻値
戻り値:
フォーマットされた時刻文字列

parse

public Date parse(String source)
           throws ParseException
指定された文字列の先頭からテキストを解析して日付を生成します。メソッドは指定された文字列のテキスト全体に使用されない場合もあります。

日付の解析についての詳細は、parse(String, ParsePosition) メソッドを参照してください。

パラメータ:
source - 先頭が解析される String
戻り値:
文字列を解析して得られた Date
例外:
ParseException - 指定された文字列の先頭が解析できない場合

parse

public abstract Date parse(String source,
                           ParsePosition pos)
指定された解析位置に従って日付/時刻文字列を解析します。たとえば、時刻テキスト「07/10/96 4:5 PM, PDT」が、Date(837039928046) と同等な Date に解析されます。

デフォルト値では、解析は厳密ではありません。入力が、このオブジェクトのフォーマットメソッドで使用される形式ではないが、日付として解析可能であれば、解析は正常に行われます。クライアントは、setLenient(false) を呼び出すことによって、このフォーマットを厳密に要求できます。

パラメータ:
source - 解析する日付/時刻文字列
pos - 入力時は、解析を開始する位置。出力時は、解析が終了した位置、または解析が失敗した場合には開始位置
戻り値:
Date。入力解析ができない場合は null
関連項目:
setLenient(boolean)

parseObject

public Object parseObject(String source,
                          ParsePosition pos)
文字列からテキストを解析して Date を生成します。

メソッドは pos によって指定されたインデックスを開始位置としてテキストの解析を試みます。解析が完了すると、pos のインデックスは、使用された最後の文字 (解析では、文字列の最後までのすべての文字を使用する必要はない) のあとのインデックスに更新され、解析された日付が返されます。更新された pos は、このメソッドの次の呼び出しの開始点を示すのに使用できます。エラーが発生した場合は、pos のインデックスは変更されず、エラーが発生した文字のインデックスに pos のエラーインデックスが設定され、null が返されます。

日付の解析についての詳細は、parse(String, ParsePosition) メソッドを参照してください。

定義:
クラス Format 内の parseObject
パラメータ:
source - 部分的に解析される String
pos - 上記のインデックスおよびエラーインデックス情報を持つ ParsePosition オブジェクト
戻り値:
文字列を解析して得られた Date。エラーの場合は null
例外:
NullPointerException - pos が null の場合

getTimeInstance

public static final DateFormat getTimeInstance()
デフォルトのロケールに対し、デフォルトのフォーマットスタイルを持つ時刻フォーマッタを取得します。

戻り値:
時刻フォーマッタ

getTimeInstance

public static final DateFormat getTimeInstance(int style)
デフォルトのロケールに対し、指定されたフォーマットスタイルを持つ時刻フォーマッタを取得します。

パラメータ:
style - 指定するフォーマットスタイル。たとえば、US ロケールでの "h:mm a" に対する SHORT
戻り値:
時刻フォーマッタ

getTimeInstance

public static final DateFormat getTimeInstance(int style,
                                               Locale aLocale)
指定されたロケールに対し、指定されたフォーマットスタイルを持つ時刻フォーマッタを取得します。

パラメータ:
style - 指定するフォーマットスタイル。たとえば、US ロケールでの "h:mm a" に対する SHORT
aLocale - 指定されたロケール
戻り値:
時刻フォーマッタ

getDateInstance

public static final DateFormat getDateInstance()
デフォルトのロケールに対し、デフォルトのフォーマットスタイルを持つ日付フォーマッタを取得します。

戻り値:
日付フォーマッタ

getDateInstance

public static final DateFormat getDateInstance(int style)
デフォルトのロケールに対し、指定されたフォーマットスタイルを持つ日付フォーマッタを取得します。

パラメータ:
style - 指定するフォーマットスタイル。たとえば、US ロケールでの "M/d/yy" に対する SHORT
戻り値:
日付フォーマッタ

getDateInstance

public static final DateFormat getDateInstance(int style,
                                               Locale aLocale)
指定されたロケールに対し、指定されたフォーマットスタイルを持つ日付フォーマッタを取得します。

パラメータ:
style - 指定するフォーマットスタイル。たとえば、US ロケールでの "M/d/yy" に対する SHORT
aLocale - 指定されたロケール
戻り値:
日付フォーマッタ

getDateTimeInstance

public static final DateFormat getDateTimeInstance()
デフォルトのロケールに対し、デフォルトのフォーマットスタイルを持つ日付/時刻フォーマッタを取得します。

戻り値:
日付/時刻フォーマッタ

getDateTimeInstance

public static final DateFormat getDateTimeInstance(int dateStyle,
                                                   int timeStyle)
デフォルトのロケールに対し、指定された日付/時刻フォーマットスタイルを持つ日付/時刻フォーマッタを取得します。

パラメータ:
dateStyle - 指定する日付フォーマットスタイル。たとえば、US ロケールでの "M/d/yy" に対する SHORT
timeStyle - 指定する時刻フォーマットスタイル。たとえば、US ロケールでの "h:mm a" に対する SHORT
戻り値:
日付/時刻フォーマッタ

getDateTimeInstance

public static final DateFormat getDateTimeInstance(int dateStyle,
                                                   int timeStyle,
                                                   Locale aLocale)
指定されたロケールに対し、指定されたフォーマットスタイルを持つ日付/時刻フォーマッタを取得します。

パラメータ:
dateStyle - 指定する日付フォーマットスタイル
timeStyle - 指定する時刻フォーマットスタイル
aLocale - 指定されたロケール
戻り値:
日付/時刻フォーマッタ

getInstance

public static final DateFormat getInstance()
日付と時刻の両方に対し SHORT スタイルを持つ日付/時刻フォーマッタを取得します。


getAvailableLocales

public static Locale[] getAvailableLocales()
このクラスの get*Instance メソッドが地域対応のインスタンスを返すことのできるロケールすべての配列を返します。返される配列は、最低限 Locale.US に等しい Locale インスタンスを含んでいる必要があります。

戻り値:
地域対応の DateFormat インスタンスを使用可能なロケールの配列

setCalendar

public void setCalendar(Calendar newCalendar)
この日付フォーマットで使用するカレンダを設定します。最初は、指定されたロケールまたはデフォルトのロケールに対し、デフォルトのカレンダが使用されます。

パラメータ:
newCalendar - 日付フォーマットで使用する新しい Calendar

getCalendar

public Calendar getCalendar()
この日付/時刻フォーマッタに対応するカレンダを取得します。

戻り値:
この日付/時刻フォーマッタに対応するカレンダ

setNumberFormat

public void setNumberFormat(NumberFormat newNumberFormat)
数値フォーマッタを設定します。

パラメータ:
newNumberFormat - 指定する新しい NumberFormat

getNumberFormat

public NumberFormat getNumberFormat()
時刻のフォーマットと解析のためにこの日付/時刻フォーマッタが使用する数値フォーマッタを取得します。

戻り値:
この日付/時刻フォーマッタが使用する数値フォーマッタ

setTimeZone

public void setTimeZone(TimeZone zone)
この DateFormat オブジェクトのカレンダのタイムゾーンを設定します。

パラメータ:
zone - 指定する新しいタイムゾーン

getTimeZone

public TimeZone getTimeZone()
タイムゾーンを取得します。

戻り値:
DateFormat のカレンダに対応するタイムゾーン

setLenient

public void setLenient(boolean lenient)
日付/時刻解析を厳密に行うかどうかを設定します。厳密でない解析では、解析機能は、ヒューリスティックな方法を使って、このオブジェクトのフォーマットと完全には一致しない入力を解釈することがあります。厳密な解析では、入力はこのオブジェクトのフォーマットと一致する必要があります。

パラメータ:
lenient - true の場合は厳密ではない解析
関連項目:
Calendar.setLenient(boolean)

isLenient

public boolean isLenient()
日付/時刻の解析を厳密に行うかどうかを判定します。


hashCode

public int hashCode()
hashCode をオーバーライドします。

オーバーライド:
クラス Object 内の hashCode
戻り値:
このオブジェクトのハッシュコード値
関連項目:
Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)
equals をオーバーライドします。

オーバーライド:
クラス Object 内の equals
パラメータ:
obj - 比較対象の参照オブジェクト
戻り値:
obj 引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false
関連項目:
Object.hashCode(), Hashtable

clone

public Object clone()
Cloneable をオーバーライドします。

オーバーライド:
クラス Format 内の clone
戻り値:
このインスタンスの複製
関連項目:
Cloneable

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。