モジュール java.base
パッケージ java.text

クラスSimpleDateFormat

java.lang.Object
java.text.Format
java.text.DateFormat
java.text.SimpleDateFormat
すべての実装されたインタフェース:
Serializable, Cloneable

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

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

日時パターン

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

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

チャートはパターン文字、日付/時間コンポーネント、表示および例を示します。
文字 日付または時刻のコンポーネント 表示
G 紀元 Text AD
y Year 1996; 96
Y 暦週の基準年 Year 2009; 09
M 年における月(状況依存) Month July; Jul; 07
L 年における月(スタンドアロン形式) Month July; Jul; 07
w 年における週 Number 27
W 月における週 Number 2
D 年における日 Number 189
d 月における日 Number 10
F 月における曜日 Number 2
E 曜日の名前 Text Tuesday; Tue
u 曜日の番号(1 =月曜、...、7 =日曜) Number 1
a 午前/午後 Text PM
H 一日における時(0 - 23) Number 0
k 一日における時(1 - 24) Number 24
K 午前/午後の時(0 - 11) Number 0
h 午前/午後の時(1 - 12) Number 12
m Number 30
s Number 55
S ミリ秒 Number 978
z タイムゾーン 一般的なタイムゾーン Pacific Standard Time; PST; GMT-08:00
Z タイムゾーン RFC 822タイムゾーン -0800
X タイムゾーン ISO 8601タイムゾーン -08; -0800; -08:00
パターン文字は、その数で正確な表現が決まるため、通常繰り返されます。
  • テキスト: フォーマット時に、パターン文字の数が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以上の場合、フォーマットと解析の両方に、カレンダ固有の長い形式が使用されます。 そうでない場合は、カレンダ固有の短い形式または省略された形式が使用されます。

    暦週の基準年'Y'が指定され、カレンダ暦週の基準年をサポートしていない場合は、代わりにカレンダの年('y')が使用されます。
    getCalendar().isWeekDateSupported()を呼び出すと、暦週の基準年のサポートをテストできます。

  • 月:パターン文字の数が3以上の場合、月はテキストとして解釈されます。そうでない場合は、数値として解釈されます。
    • 文字Mにより、埋込み形式の名前など、状況依存の月の名前が生成されます。 文字Mは、スタンドアロン・パターン(たとえば、"MMMM")で使用する場合、月名のスタンドアロン・フォームを提供し、otherfield(s)を含むパターン(たとえば、"d MMMM")で使用する場合、月名のフォーマット・フォームを提供するという意味でコンテキスト依存です。 たとえば、カタルーニャ語の1月は書式形式の"ジェネレーション"で、スタンドアロン形式の"gener"です。 この場合、"MMMM"は"gener"を生成し、"d MMMM"の月部は"ジェネレーション"を生成します。 DateFormatSymbolsがコンストラクタSimpleDateFormat(String,DateFormatSymbols)またはメソッドsetDateFormatSymbols(DateFormatSymbols)を使用して明示的に設定されている場合、DateFormatSymbolsによって指定された月の名前が使用されます。
    • 文字Lによりスタンドアロン形式の月の名前が生成されます。

  • 一般的なタイムゾーン:タイムゾーンに名前がある場合、テキストとして解釈されます。 GMTオフセット値を表すタイムゾーンには、次の構文が使用されます。
         GMTOffsetTimeZone:
                 GMT Sign Hours : Minutes
         Sign: one of
                 + -
         Hours:
                 Digit
                 Digit Digit
         Minutes:
                 Digit Digit
         Digit: one of
                 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です。 ほかの定義は一般的なタイムゾーンと同様です。

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

  • ISO 8601タイムゾーン:以下のように、フォーマットと解析のフォーマットはどちらも、パターン文字の数で指定されます。
         ISO8601TimeZone:
                 OneLetterISO8601TimeZone
                 TwoLetterISO8601TimeZone
                 ThreeLetterISO8601TimeZone
         OneLetterISO8601TimeZone:
                 Sign TwoDigitHours
                 Z
         TwoLetterISO8601TimeZone:
                 Sign TwoDigitHours Minutes
                 Z
         ThreeLetterISO8601TimeZone:
                 Sign TwoDigitHours : Minutes
                 Z
    ほかの定義は一般的なタイムゾーンRFC 822タイムゾーンと同様です。

    フォーマットでは、GMTからのオフセット値が0の場合に"Z"が生成されます。 パターン文字の数が1の場合は、1時間の端数は無視されます。 たとえば、パターンが"X"で、タイムゾーンが"GMT+05:30"の場合、"+05"が生成されます。

    解析では、UTCタイムゾーン指示子として"Z"が解析されます。 一般的なタイムゾーン受け入れられません

    パターン文字数が4以上の場合、 SimpleDateFormatを構築するかパターンを適用すると、IllegalArgumentExceptionがスローされます。

SimpleDateFormatローカライズされた日時パターン文字列もサポートします。 この文字列では、前述したパターン文字はロケール依存のほかの文字パターンに置き換えられます。 SimpleDateFormatでは、パターン文字以外のテキストのローカリゼーションが処理されません。この処理はクラスのクライアント次第で決まります。

次の例に、U.S. ロケールで日時パターンがどのように解釈されるかを示します。 指定された日付と時刻はU.S. Pacific Timeタイムゾーンのローカル・タイム2001年7月4日12時8分56秒です。
U.S.ロケールで解釈された日時パターンの例
日時パターン 結果
"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
"yyyy-MM-dd'T'HH:mm:ss.SSSXXX" 2001-07-04T12:08:56.235-07:00
"YYYY-'W'ww-u" 2001-W27-3

Synchronization

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

APIのノート:
DateTimeFormatterを不変でスレッド・セーフな代替として使用することを検討してください。
導入されたバージョン:
1.1
関連項目: