java.text
クラス SimpleDateFormat

java.lang.Object
  java.text.Format
      java.text.DateFormat
          java.text.SimpleDateFormat

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

Serializable, Cloneable

public class SimpleDateFormat
extends DateFormat

SimpleDateFormat は、日付のフォーマットと解析を、ロケールを考慮して行うための具象クラスです。これによって、フォーマット (日付 -> テキスト)、解析 (テキスト -> 日付)、および正規化を行うことができます。

SimpleDateFormat を使うと、日付時刻フォーマットのユーザー定義パターンを選択することによって、とりあえず使用を開始することができます。しかし、できるだけ、DateFormat の getTimeInstance、getDateInstance、または getDateTimeInstance で日付時刻フォーマッタを作成するようにしてください。これらのクラスメソッドはいずれも、デフォルトフォーマットパターンで初期化された日付時刻フォーマッタを返すことができます。フォーマットパターンは、必要に応じて、applyPattern メソッドを使って修正することができます。これらのメソッドの使い方については、DateFormat を参照してください。

日付/時刻パターン

日付/時刻フォーマットは「日付/時刻パターン」文字列で指定されます。日付/時刻パターン文字列内では、引用符で囲まれていない 'A' 〜 'Z' および 'a' 〜 'z' は、日付または時刻文字列のコンポーネントを表すパターン文字として解釈されます。テキストは単一引用符 (') で囲むことで解釈を回避できます。''」は単一引用符を表します。ほかのすべての文字は解釈されず、フォーマット中に出力文字列へ単純にコピーされるか、解析中に入力文字列に対して一致させられます。

次のパターン文字が定義されます。(他の 'A' 〜 'Z' および 'a' 〜 'z' のすべての文字は予約済み)

文字	日付または時刻のコンポーネント	表示	例
G	紀元	Text	AD
y	年	年	1996; 96
M	月	月	July; Jul; 07
w	年における週	数値	27
W	月における週	数値	2
D	年における日	数値	189
d	月における日	数値	10
F	月における曜日	数値	2
E	曜日	Text	Tuesday; Tue
a	午前/午後	Text	PM
H	一日における時 (0 〜 23)	数値	0
k	一日における時 (1 〜 24)	数値	24
K	午前/午後の時 (0 〜 11)	数値	0
h	午前/午後の時 (1 〜 12)	数値	12
m	分	数値	30
s	秒	数値	55
S	ミリ秒	数値	978
z	タイムゾーン	一般的なタイムゾーン	Pacific Standard Time; PST; GMT-08:00
Z	タイムゾーン	RFC 822 タイムゾーン	-0800

パターン文字は、その数で正確な表現が決まるため、通常繰り返されます。

• テキスト: パターン文字の数が 4 以上の場合、フォーマットにはフル形式を使用します。 そうでない場合、短い形式または省略された形式があれば、それを使用します。解析には、パターン文字の数値にかかわらず、どちらの形式も受け付けられます。
• 数値: フォーマットには、パターン文字の数は最小桁数になります。 これより短い数値は、この桁数までゼロが追加されます。解析には、2 つの隣接するフィールドを区切る必要がないかぎり、パターン文字の数は無視されます。
• 年: フォーマッタの Calendar がグレゴリオ暦の場合は、次に示す規則が適用されます。
  
  • パターン文字の数が 2 の場合、フォーマットには年が 2 桁に短縮されます。 そうでない場合は、数値として解釈されます。
  • 解析には、パターン文字の数が 2 以上の場合、年は桁数にかかわらず文字どおりに解釈されます。「MM/dd/yyyy」のパターンを用いると、「01/11/12」は A.D. 12 年 1 月 11 日に解釈されます。
  • 短縮年パターン (「y」または「yy」) で解析するときは、SimpleDateFormat は特定の世紀に合わせて短縮年を解釈する必要があります。この解釈は、SimpleDateFormat のインスタンスの生成前の 80 年以内から生成後の 20 年以内に日付を調整することによって行われます。たとえば、「MM/dd/yy」のパターンと 1997 年 1 月 1 日に生成された SimpleDateFormat のインスタンスを使うと、「01/11/12」という文字列は 2012 年 1 月 11 日と解釈され、「05/04/64」という文字列は 1964 年 5 月 4 日と解釈されます。 解析中は、Character.isDigit(char) で定義された 2 桁を含む文字列のみがデフォルトの世紀に解析されます。1 桁の文字列、3 桁以上の文字列、あるいは数値以外を含む 2 桁の文字列 (-1 など) といったその他の数値文字列は、文字どおりに解釈されます。つまり、同じパターンを用いて「01/02/3」または「01/02/003」を解析すると、A.D. 3 年 1 月 2 日となります。同様に、「01/02/-3」は B.C. 4 年 1 月 2 日と解析されます。
  そうでない場合は、カレンダシステム固有の形式が適用されます。パターン文字の数が 4 以上の場合、フォーマットと解析の両方に、カレンダ固有の長い形式が使用されます。そうでない場合は、カレンダ固有の短い形式または省略された形式が使用されます。
• 月: パターン文字の数が 3 以上の場合、フォーマットには月がテキストとして解釈されます。 そうでない場合は、数値として解釈されます。
• 一般的なタイムゾーン: タイムゾーンに名前がある場合、テキストとして解釈されます。GMT オフセット値を表すタイムゾーンには、次の構文が使用されます。

       GMTOffsetTimeZone:
               GMT 符号 時 :Minutes
       Sign: 次のどれか
               + -
       Hours:
               数字
               Digit Digit
       Minutes:
               Digit Digit
       Digit: 次のどれか
               0 1 2 3 4 5 6 7 8 9

  時は 0 〜 23、分は 00 〜 59 です。フォーマットはロケールに依存せず、数字は Unicode 標準の Basic Latin ブロックの数字でなければなりません。

  解析には、RFC 822 タイムゾーンも受け付けられます。

• RFC 822 タイムゾーン: フォーマットには、RFC 822 の 4 桁タイムゾーン形式が使用されます。

       RFC822TimeZone:
               Sign TwoDigitHours Minutes
       TwoDigitHours:
               Digit Digit

  TwoDigitHours は 00 〜 23 です。他の定義は一般的なタイムゾーンと同様です。

  解析には、一般的なタイムゾーンも受け付けられます。

SimpleDateFormat は「地域対応された日付/時刻パターン」文字列もサポートします。この文字列では、前述したパターン文字はロケール依存の他の文字パターンに置き換えられます。SimpleDateFormat はパターン文字以外のテキストの地域対応を行いません。 この地域対応は、クラスのクライアントによります。

例

次の例に、U.S. ロケールで日付/時刻パターンがどのように解釈されるかを示します。指定された日付と時刻は U.S. Pacific Time タイムゾーンのローカルタイム 2001 年 7 月 4 日 12 時 8 分 56 秒です。

日付/時刻パターン	結果
"yyyy.MM.dd G 'at' HH:mm:ss z"	2001.07.04 AD at 12:08:56 PDT
"EEE, MMM d, ''yy"	Wed, Jul 4, '01
"h:mm a"	12:08 PM
"hh 'o''clock' a, zzzz"	12 o'clock PM, Pacific Daylight Time
"K:mm a, z"	0:08 PM, PDT
"yyyyy.MMMMM.dd GGG hh:mm aaa"	02001.July.04 AD 12:08 PM
"EEE, d MMM yyyy HH:mm:ss Z"	Wed, 4 Jul 2001 12:08:56 -0700
"yyMMddHHmmssZ"	010704120856-0700
「yyyy-MM-dd'T'HH:mm:ss.SSSZ」	2001-07-04T12:08:56.235-0700

同期

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

関連項目:

Java チュートリアル, Calendar, TimeZone, DateFormat, DateFormatSymbols, 直列化された形式

入れ子のクラスの概要

クラス java.text.DateFormat から継承された入れ子のクラス/インタフェース

DateFormat.Field

フィールドの概要

クラス java.text.DateFormat から継承されたフィールド

AM_PM_FIELD, calendar, DATE_FIELD, DAY_OF_WEEK_FIELD, DAY_OF_WEEK_IN_MONTH_FIELD, DAY_OF_YEAR_FIELD, DEFAULT, ERA_FIELD, FULL, HOUR_OF_DAY0_FIELD, HOUR_OF_DAY1_FIELD, HOUR0_FIELD, HOUR1_FIELD, LONG, MEDIUM, MILLISECOND_FIELD, MINUTE_FIELD, MONTH_FIELD, numberFormat, SECOND_FIELD, SHORT, TIMEZONE_FIELD, WEEK_OF_MONTH_FIELD, WEEK_OF_YEAR_FIELD, YEAR_FIELD

コンストラクタの概要

SimpleDateFormat()
デフォルトロケールのデフォルトパターンと日付フォーマット記号を使って SimpleDateFormat を構築します。

SimpleDateFormat(String pattern)
指定されたパターンとデフォルトロケールのデフォルト日付フォーマット記号を使って SimpleDateFormat を構築します。

SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols)
指定されたパターンと日付フォーマット記号を使って SimpleDateFormat を構築します。

SimpleDateFormat(String pattern, Locale locale)
指定されたパターンと指定されたロケールのデフォルト日付フォーマット記号を使って SimpleDateFormat を構築します。

メソッドの概要

void	applyLocalizedPattern(String pattern) 指定された地域対応されたパターン文字列を、この日付フォーマットに適用します。
void	applyPattern(String pattern) 指定されたパターン文字列を、この日付フォーマットに適用します。
Object	clone() この SimpleDateFormat のコピーを作成します。
boolean	equals(Object obj) 指定されたオブジェクトとこの SimpleDateFormat が等しいかどうかを比較します。
StringBuffer	format(Date date, StringBuffer toAppendTo, FieldPosition pos) 指定された Date を日付/時刻文字列にフォーマットし、指定された StringBuffer に結果を追加します。
AttributedCharacterIterator	formatToCharacterIterator(Object obj) Object をフォーマットし、AttributedCharacterIterator を生成します。
Date	get2DigitYearStart() 2 桁年が属すると解釈される 100 年間の開始日付を返します。
DateFormatSymbols	getDateFormatSymbols() この日付フォーマットの、日付と時刻のフォーマット記号のコピーを取得します。
int	hashCode() この SimpleDateFormat オブジェクトのハッシュコード値を返します。
Date	parse(String text, ParsePosition pos) 文字列からテキストを解析して Date を生成します。
void	set2DigitYearStart(Date startDate) 2 桁年が属すると解釈される 100 年間をユーザーが指定する日付から始まるように設定します。
void	setDateFormatSymbols(DateFormatSymbols newFormatSymbols) この日付フォーマットの、日付と時刻のフォーマット記号を設定します。
String	toLocalizedPattern() この日付フォーマットの地域対応されたパターン文字列を返します。
String	toPattern() この日付フォーマットを記述するパターン文字列を返します。

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

format, format, getAvailableLocales, getCalendar, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getNumberFormat, getTimeInstance, getTimeInstance, getTimeInstance, getTimeZone, isLenient, parse, parseObject, setCalendar, setLenient, setNumberFormat, setTimeZone

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

format, parseObject

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

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SimpleDateFormat

public SimpleDateFormat()

デフォルトロケールのデフォルトパターンと日付フォーマット記号を使って SimpleDateFormat を構築します。注:このコンストラクタはすべてのロケールをサポートするわけではありません。すべてをカバーするには、DateFormat クラスのファクトリメソッドを使用してください。

SimpleDateFormat

public SimpleDateFormat(String pattern)

指定されたパターンとデフォルトロケールのデフォルト日付フォーマット記号を使って SimpleDateFormat を構築します。注:このコンストラクタはすべてのロケールをサポートするわけではありません。すべてをカバーするには、DateFormat クラスのファクトリメソッドを使用してください。

パラメータ:

pattern - 日付と時刻のフォーマットを記述するパターン

例外:

NullPointerException - 指定されたパターンが null の場合

IllegalArgumentException - 指定されたパターンが正しくない場合

SimpleDateFormat

public SimpleDateFormat(String pattern,
                        Locale locale)

指定されたパターンと指定されたロケールのデフォルト日付フォーマット記号を使って SimpleDateFormat を構築します。注:このコンストラクタはすべてのロケールをサポートするわけではありません。すべてをカバーするには、DateFormat クラスのファクトリメソッドを使用してください。

パラメータ:

pattern - 日付と時刻のフォーマットを記述するパターン

locale - 日付フォーマット記号を使用するロケール

例外:

NullPointerException - 指定されたパターンまたはロケールが null の場合

IllegalArgumentException - 指定されたパターンが正しくない場合

SimpleDateFormat

public SimpleDateFormat(String pattern,
                        DateFormatSymbols formatSymbols)

指定されたパターンと日付フォーマット記号を使って SimpleDateFormat を構築します。

パラメータ:

pattern - 日付と時刻のフォーマットを記述するパターン

formatSymbols - フォーマットに使用する日付フォーマット記号

例外:

NullPointerException - 指定されたパターンまたは formatSymbols が null の場合

IllegalArgumentException - 指定されたパターンが正しくない場合

メソッドの詳細

set2DigitYearStart

public void set2DigitYearStart(Date startDate)

2 桁年が属すると解釈される 100 年間をユーザーが指定する日付から始まるように設定します。

パラメータ:

startDate - 解析中、2 桁年は startDate 〜 startDate + 100 年 の範囲に配置される

導入されたバージョン:

1.2

関連項目:

get2DigitYearStart()

get2DigitYearStart

public Date get2DigitYearStart()

2 桁年が属すると解釈される 100 年間の開始日付を返します。

戻り値:

2 桁年が解析される 100 年間の 始まり

導入されたバージョン:

1.2

関連項目:

set2DigitYearStart(java.util.Date)

format

public StringBuffer format(Date date,
                           StringBuffer toAppendTo,
                           FieldPosition pos)

指定された Date を日付/時刻文字列にフォーマットし、指定された StringBuffer に結果を追加します。

定義:

クラス DateFormat 内の format

パラメータ:

date - 日付/時刻文字列にフォーマットする日付/時刻値

toAppendTo - 新しい日付/時刻テキストを追加する位置

pos - フォーマットする位置。入力では、必要であれば 位置合わせフィールド。出力では、その位置合わせフィールドのオフセット

戻り値:

フォーマットされた日付/時刻文字列

例外:

NullPointerException - 指定された日付が null の場合

formatToCharacterIterator

public AttributedCharacterIterator formatToCharacterIterator(Object obj)

Object をフォーマットし、AttributedCharacterIterator を生成します。返された AttributedCharacterIterator を使用すると、結果の String を構築できるとともに、結果の String についての情報を判定できます。

AttributedCharacterIterator の各属性キーは DateFormat.Field 型です。対応する属性値は属性キーと同一です。

オーバーライド:

クラス Format 内の formatToCharacterIterator

パラメータ:

obj - フォーマットするオブジェクト

戻り値:

フォーマットされた値を説明する AttributedCharacterIterator

例外:

NullPointerException - obj が null の場合

IllegalArgumentException - if the Format cannot format the given object, or if the Format's pattern string is invalid.

導入されたバージョン:

1.4

parse

public Date parse(String text,
                  ParsePosition pos)

文字列からテキストを解析して Date を生成します。

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

定義:

クラス DateFormat 内の parse

パラメータ:

text - 部分的に解析される String

pos - A ParsePosition object with index and error index information as described above.

戻り値:

文字列から解析される Date In case of error, returns null.

例外:

NullPointerException - text または pos が null の場合

関連項目:

DateFormat.setLenient(boolean)

toPattern

public String toPattern()

この日付フォーマットを記述するパターン文字列を返します。

戻り値:

この日付フォーマットを記述するパターン文字列

toLocalizedPattern

public String toLocalizedPattern()

この日付フォーマットの地域対応されたパターン文字列を返します。

戻り値:

この日付フォーマットを記述する地域対応されたパターン文字列

applyPattern

public void applyPattern(String pattern)

指定されたパターン文字列を、この日付フォーマットに適用します。

パラメータ:

pattern - この日付フォーマットのための新しい日付と時刻のパターン

例外:

NullPointerException - 指定されたパターンが null の場合

IllegalArgumentException - 指定されたパターンが正しくない場合

applyLocalizedPattern

public void applyLocalizedPattern(String pattern)

指定された地域対応されたパターン文字列を、この日付フォーマットに適用します。

パラメータ:

pattern - a String to be mapped to the new date and time format pattern for this format

例外:

NullPointerException - 指定されたパターンが null の場合

IllegalArgumentException - 指定されたパターンが正しくない場合

getDateFormatSymbols

public DateFormatSymbols getDateFormatSymbols()

この日付フォーマットの、日付と時刻のフォーマット記号のコピーを取得します。

戻り値:

この日付フォーマットの、日付と時刻のフォーマット記号

関連項目:

setDateFormatSymbols(java.text.DateFormatSymbols)

setDateFormatSymbols

public void setDateFormatSymbols(DateFormatSymbols newFormatSymbols)

この日付フォーマットの、日付と時刻のフォーマット記号を設定します。

パラメータ:

newFormatSymbols - 新しい日付と時刻のフォーマット記号

例外:

NullPointerException - 指定された newFormatSymbols が null の場合

関連項目:

getDateFormatSymbols()

clone

public Object clone()

この SimpleDateFormat のコピーを作成します。また、フォーマットの日付フォーマット記号を複製します。

オーバーライド:

クラス DateFormat 内の clone

戻り値:

この SimpleDateFormat の複製

関連項目:

Cloneable

hashCode

public int hashCode()

この SimpleDateFormat オブジェクトのハッシュコード値を返します。

オーバーライド:

クラス DateFormat 内の hashCode

戻り値:

この SimpleDateFormat オブジェクトのハッシュコード値

関連項目:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

指定されたオブジェクトとこの SimpleDateFormat が等しいかどうかを比較します。

オーバーライド:

クラス DateFormat 内の equals

パラメータ:

obj - 比較対象の参照オブジェクト

戻り値:

指定された Object がこの SimpleDateFormat と等しい場合は ture

関連項目:

Object.hashCode(), Hashtable