Java SimpleDateFormat – Java日付のフォーマット

イントロダクション

JavaのSimpleDateFormatおよびDateFormatクラスは、日付のフォーマットに使用されます。これは主に、Javaの日付および時刻機能を表示または利用する必要がある場合に使用されます。

JavaのDateFormat

• DateFormatは、指定されたロケールに基づいて日付をStringにフォーマットするために使用されます。
• ロケールは、ユーザーにとってよりローカルなコードを作成するために、地域と言語を指定するために使用されます。
• 世界の異なる地域では、日付の書き方が異なります。たとえば、2017年12月31日は、インドでは31-12-2017として書かれますが、アメリカでは12-31-2017として書かれます。
• DateFormatクラスは同期されていないため、各スレッドごとに別のインスタンスを作成することが推奨されています。

A DateFormat object can be created using the getDateInstance() and getTimeInstance() method of the DateFormat class.

Locale loc = new Locale("en", "US");
DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.DEFAULT, loc);

Locale loc = new Locale.Builder().setLanguage("en").setRegion("US").build();

DateFormatのgetDateInstanceメソッドには2つの入力パラメータが必要です。最初のパラメータは使用するDateFormatを指定し、2番目のパラメータはロケールです。

formatを使用

DateFormatクラスには、フォーマットを担当するformatメソッドがあります。

Locale locale = new Locale("fr", "FR");
DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.DEFAULT, locale);
String date = dateFormat.format(new Date());
System.out.print(date);

このコードは、フランス語(fr)とフランス(FR)地域で日付をフォーマットします:

Output
3 janv. 2018

getTimeInstance()を使用

DateFormatのインスタンスを作成するには、getDateInstance()メソッドを使用しています。

時間のフォーマットを行うには、時間のインスタンスが必要です。時間のインスタンスを取得するために、getTimeInstance()メソッドを使用します。

Locale locale = new Locale("fr", "FR");
DateFormat dateFormat = DateFormat.getTimeInstance(DateFormat.DEFAULT, locale);
String date = dateFormat.format(new Date());
System.out.print(date);

このコードは、フランス語(fr)とフランス(FR)地域で時間をフォーマットします:

Output
11:03:01

Java SimpleDateFormat

SimpleDateFormatはDateFormatに似ています。 それらの間の唯一の主な違いは、SimpleDateFormatがロケールサポート付きでフォーマット（DateをStringに変換）および解析（StringをDateに変換）に使用できることであり、一方DateFormatはロケールサポートを持たないことです。 DateFormatは日付のフォーマットと解析のための基本的なサポートを提供する抽象クラスです。SimpleDateFormatはDateFormatクラスを拡張した具象クラスです。

SimpleDateFormatはSimpleDateFormatコンストラクタを使用して作成できます。 このコンストラクタはパラメーターとしてStringパターンが必要です。

String pattern = "MM-dd-yyyy";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);

文字列patternは、日付をフォーマットするために使用されるパターンであり、出力はそのパターンで生成されます、例えば“MM-dd-yyyy”。

パターン

フォーマットパターンに使用する構文を見てみましょう。

月の場合、異なる結果を得るために異なる量の文字が使用される必要があります。

例

今度は、日付と時刻の異なる形式のいくつかの例を見てみましょう。

SimpleDateFormat()を使用する

日付を解析するためには、コンストラクタを使用してSimpleDateFormatのインスタンスを作成し、format()メソッドを使用します：

String pattern = "MM-dd-yyyy";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
String date = simpleDateFormat.format(new Date());
System.out.println(date);

このコードは「MM-dd-yyyy」を出力します：

Output
01-02-2018

このパターンは「年の中の月」、「月の中の日」、「年」を生成します。文字の種類（大文字小文字）と文字の数が文字列に寄与します。月は2桁、日は2桁、年は4桁で表されます。

このコードは日付「2018年1月2日」を「01-02-2018」として表示します。

時間を解析する場合、SimpleDateFormatのインスタンスを作成する際にパターンを変更する必要があります。

String pattern = "HH:mm:ss.SSSZ";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
String date = simpleDateFormat.format(new Date());
System.out.println(date);

このコードは「HH:mm:ss.SSSZ」を出力します：

Output
13:03:15.454+0530

このパターンは「時」、「分」、「秒」、「ミリ秒」、「タイムゾーンオフセット（RFCパターン）」を生成します。

このコードは時間を「13:03:15.454+0530」として表示します。

parse()を使用する

解析は文字列を`java.util.Date`インスタンスに変換することです。`SimpleDateFormat`クラスの`parse()`メソッドを使用して文字列を日付インスタンスに解析できます。日付を解析するには、`SimpleDateFormat`クラスのインスタンスとクラスのコンストラクタの入力として文字列パターンが必要です。

String pattern = "MM-dd-yyyy";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
Date date = simpleDateFormat.parse("12-01-2018");
System.out.println(date);

これにより、指定された時刻なしで日付（12-01-2018）が出力されます。

Output
Sat Dec 01 00:00:00 IST 2018

さて、時間を解析するためのSimpleDateFormatの例を見てみましょう。

String pattern = "HH:mm:ss";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
Date date = simpleDateFormat.parse("22:00:03");
System.out.println(date);

これにより、指定された日付なしで時間（22:00:03）が出力されます。

Output
Thu Jan 01 22:00:03 IST 1970

日付が指定されていないため、プログラムはエポックを日付として考慮しました（つまり、01-Jan-1970）。

Localeの使用

ロケールは、地域に基づいて使用されることがわかるように、DateFormatの一部としてLocaleで作業しました。

String pattern = "EEEEE MMMMM yyyy HH:mm:ss.SSSZ";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern, new Locale("fr", "FR"));
Date date = simpleDateFormat.format(new Date());
System.out.println(date);

このコードは、現在の時刻をフランス語（fr）の言語とフランス（FR）の地域でフォーマットします。

Output
mardi janvier 2018 14:51:02.354+0530

日付と月は、入力として提供されたLocaleに基づいてフランス語で名前が付けられます – mardiは「火曜日」で、janvierは「1月」です。

結論

この記事では、JavaのSimpleDateFormatとDateFormatについて学びました。

参考:

• SimpleDateFormat API ドキュメント
• DateFormat API ドキュメント