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 へ)。正確な結果はロケールに依存しますが、一般的には次のようになります。

• SHORT はすべて数値で、12.13.52 や 3:30pm など
• MEDIUM はそれより長い形式で、Jan 12, 1952 など
• LONG はさらに長い形式で、January 12, 1952 や 3:30:32pm など
• FULL はほぼ完全に指定する形式で、Tuesday, April 12, 1952 AD や 3:30:42pm PST など

必要に応じて、フォーマットにタイムゾーンを設定することもできます。フォーマットや解析をさらに制御する場合 (または、ユーザにそのような制御を与える場合) には、ファクトリメソッドから得た 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