Javaの文字列から日付への変換

Javaで 'January 2, 2010'というフォーマットの文字列日付に変換するには、どのような方法がありますか?

最終的には,月,日,年を整数にして

Date date = new Date();
date.setMonth()..
date.setYear()..
date.setDay()..
date.setlong currentTime = date.getTime();

を使って日付を時間に変換できるようにしたいのです。

ソリューション

これらの java.util.Date セッターメソッドは、Java 1.1 (1997) 以降、非推奨となっています。単純にSimpleDateFormatを使って、入力文字列にマッチするフォーマットパターンを使って日付をフォーマットします

具体的には、入力文字列として "January 2, 2010" を指定した場合です。

  1. "January" は全文月なので、MMMMパターンを使用します。
  2. "2"は、月の短い日なので、dパターンを使用します。
  3. "2010"は4桁の年なので、yyyyパターンを使用してください。
String string = "January 2, 2010";
DateFormat format = new SimpleDateFormat("MMMM d, yyyy", Locale.ENGLISH);
Date date = format.parse(string);
System.out.println(date); // Sat Jan 02 00:00:00 GMT 2010

明示的な Locale 引数の重要性に注意してください。これを省略すると、入力文字列の月名で使用されている英語とは限らないデフォルトロケールが使用されます。ロケールが入力文字列と一致しない場合、フォーマットパターンが有効であるにもかかわらず、紛らわしいことに java.text.ParseException が発生してしまいます。

ここでは、利用可能なすべてのフォーマットパターンをリストアップしたjavadocから関連性のある部分を抜粋しています。

Letter  Date or Time Component  Presentation        Examples
------  ----------------------  ------------------  -------------------------------------
G       Era designator          Text                AD
y       Year                    Year                1996; 96
Y       Week year               Year                2009; 09
M/L     Month in year           Month               July; Jul; 07
w       Week in year            Number              27
W       Week in month           Number              2
D       Day in year             Number              189
d       Day in month            Number              10
F       Day of week in month    Number              2
E       Day in week             Text                Tuesday; Tue
u       Day number of week      Number              1
a       Am/pm marker            Text                PM
H       Hour in day (0-23)      Number              0
k       Hour in day (1-24)      Number              24
K       Hour in am/pm (0-11)    Number              0
h       Hour in am/pm (1-12)    Number              12
m       Minute in hour          Number              30
s       Second in minute        Number              55
S       Millisecond             Number              978
z       Time zone               General time zone   Pacific Standard Time; PST; GMT-08:00
Z       Time zone               RFC 822 time zone   -0800
X       Time zone               ISO 8601 time zone  -08; -0800; -08:00

パターンは大文字小文字を区別し、4文字以上のテキストベースのパターンは完全な形を表すことに注意してください。それ以外の場合は、短いまたは省略された形があればそれが使用されます。そのため、例えば MMMMM 以上のパターンは不要です。

以下は、与えられた文字列を解析して日付を算出するための、有効なSimpleDateFormatパターンの例です。

Input string                            Pattern
------------------------------------    ----------------------------
2001.07.04 AD at 12:08:56 PDT           yyyy.MM.dd G 'at' HH:mm:ss z
Wed, Jul 4, '01                         EEE, MMM d, ''yy
12:08 PM                                h:mm a
12 o'clock PM, Pacific Daylight Time    hh 'o''clock' a, zzzz
0:08 PM, PDT                            K:mm a, z
02001.July.04 AD 12:08 PM               yyyyy.MMMM.dd GGG hh:mm aaa
Wed, 4 Jul 2001 12:08:56 -0700          EEE, d MMM yyyy HH:mm:ss Z
010704120856-0700                       yyMMddHHmmssZ
2001-07-04T12:08:56.235-0700            yyyy-MM-dd'T'HH:mm:ss.SSSZ
2001-07-04T12:08:56.235-07:00           yyyy-MM-dd'T'HH:mm:ss.SSSXXX
2001-W27-3                              YYYY-'W'ww-u

重要な注意点として、SimpleDateFormatスレッドセーフではありません。つまり、これをスタティック変数やインスタンス変数として宣言して割り当て、別のメソッドやスレッドで再利用することは絶対に避けてください。必ずメソッドのローカルスコープ内で新規に作成する必要があります。


Java 8 アップデート

Java 8以降をお使いの方は、DateTimeFormatterをお使いください(こちらのリンクをクリックすると、すべての定義済みフォーマッタと利用可能なフォーマットパターンが表示されます;チュートリアルはこちら)。この新しいAPIはJodaTimeにインスパイアされています。

String string = "January 2, 2010";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("MMMM d, yyyy", Locale.ENGLISH);
LocalDate date = LocalDate.parse(string, formatter);
System.out.println(date); // 2010-01-02

注意:もしあなたのフォーマットパターンがたまたま時間の部分も含んでいるならば、LocalDate#parse(text, formatter)の代わりにLocalDateTime#parse(text, formatter)を使ってください。また、フォーマットパターンにたまたまタイムゾーンが含まれている場合は、ZonedDateTime#parse(text, formatter)を使用してください。

ここでは、利用可能なすべてのフォーマットパターンを列挙したthe javadocから関連性のある部分を抜粋しています。

Symbol  Meaning                     Presentation  Examples
------  --------------------------  ------------  ----------------------------------------------
G       era                         text          AD; Anno Domini; A
u       year                        year          2004; 04
y       year-of-era                 year          2004; 04
D       day-of-year                 number        189
M/L     month-of-year               number/text   7; 07; Jul; July; J
d       day-of-month                number        10

Q/q     quarter-of-year             number/text   3; 03; Q3; 3rd quarter
Y       week-based-year             year          1996; 96
w       week-of-week-based-year     number        27
W       week-of-month               number        4
E       day-of-week                 text          Tue; Tuesday; T
e/c     localized day-of-week       number/text   2; 02; Tue; Tuesday; T
F       week-of-month               number        3

a       am-pm-of-day                text          PM
h       clock-hour-of-am-pm (1-12)  number        12
K       hour-of-am-pm (0-11)        number        0
k       clock-hour-of-am-pm (1-24)  number        0

H       hour-of-day (0-23)          number        0
m       minute-of-hour              number        30
s       second-of-minute            number        55
S       fraction-of-second          fraction      978
A       milli-of-day                number        1234
n       nano-of-second              number        987654321
N       nano-of-day                 number        1234000000

V       time-zone ID                zone-id       America/Los_Angeles; Z; -08:30
z       time-zone name              zone-name     Pacific Standard Time; PST
O       localized zone-offset       offset-O      GMT+8; GMT+08:00; UTC-08:00;
X       zone-offset 'Z' for zero    offset-X      Z; -08; -0830; -08:30; -083015; -08:30:15;
x       zone-offset                 offset-x      +0000; -08; -0830; -08:30; -083015; -08:30:15;
Z       zone-offset                 offset-Z      +0000; -0800; -08:00;

なお、よく使われるパターンについては、いくつかの定義済みフォーマッタが用意されています。ですから、たとえば DateTimeFormatter.ofPattern("EEE, d MMM yyyy HH:mm:ss Z", Locale.ENGLISH); の代わりに DateTimeFormatter.RFC_1123_DATE_TIME を使用することができます。これが可能なのは、SimpleDateFormat とは対照的に、スレッドセーフだからです。必要に応じて独自に定義することもできます。

2016-09-26T17:44:57Zのような標準的なISO 8601の日付は、LocalDateTime#parse(text)で直接解析することができます。これはISO_LOCAL_DATE_TIMEフォーマッタを既に使用しているからです。同様に,LocalDate#parse(text)はISOの日付から時間成分を除いたものを解析し(ISO_LOCAL_DATE`参照),ZonedDateTime#parse(text)はISOの日付にオフセットとタイムゾーンを加えたものを解析します(ISO_ZONED_DATE_TIME`参照)。

解説 (4)

またしても、Javaの日付に関する議論です。 日付の操作には、DateCalendar、[GregorianCalendar][3]、[SimpleDateFormat][4]を使います。 例えば、1月の日付を入力とすると

Calendar mydate = new GregorianCalendar();
String mystring = "January 2, 2010";
Date thedate = new SimpleDateFormat("MMMM d, yyyy", Locale.ENGLISH).parse(mystring);
mydate.setTime(thedate);
//breakdown
System.out.println("mydate -> "+mydate);
System.out.println("year   -> "+mydate.get(Calendar.YEAR));
System.out.println("month  -> "+mydate.get(Calendar.MONTH));
System.out.println("dom    -> "+mydate.get(Calendar.DAY_OF_MONTH));
System.out.println("dow    -> "+mydate.get(Calendar.DAY_OF_WEEK));
System.out.println("hour   -> "+mydate.get(Calendar.HOUR));
System.out.println("minute -> "+mydate.get(Calendar.MINUTE));
System.out.println("second -> "+mydate.get(Calendar.SECOND));
System.out.println("milli  -> "+mydate.get(Calendar.MILLISECOND));
System.out.println("ampm   -> "+mydate.get(Calendar.AM_PM));
System.out.println("hod    -> "+mydate.get(Calendar.HOUR_OF_DAY));

と入力すると、次のような操作が可能になります。

Calendar now = Calendar.getInstance();
mydate.set(Calendar.YEAR,2009);
mydate.set(Calendar.MONTH,Calendar.FEBRUARY);
mydate.set(Calendar.DAY_OF_MONTH,25);
mydate.set(Calendar.HOUR_OF_DAY,now.get(Calendar.HOUR_OF_DAY));
mydate.set(Calendar.MINUTE,now.get(Calendar.MINUTE));
mydate.set(Calendar.SECOND,now.get(Calendar.SECOND));
// or with one statement
//mydate.set(2009, Calendar.FEBRUARY, 25, now.get(Calendar.HOUR_OF_DAY), now.get(Calendar.MINUTE), now.get(Calendar.SECOND));
System.out.println("mydate -> "+mydate);
System.out.println("year   -> "+mydate.get(Calendar.YEAR));
System.out.println("month  -> "+mydate.get(Calendar.MONTH));
System.out.println("dom    -> "+mydate.get(Calendar.DAY_OF_MONTH));
System.out.println("dow    -> "+mydate.get(Calendar.DAY_OF_WEEK));
System.out.println("hour   -> "+mydate.get(Calendar.HOUR));
System.out.println("minute -> "+mydate.get(Calendar.MINUTE));
System.out.println("second -> "+mydate.get(Calendar.SECOND));
System.out.println("milli  -> "+mydate.get(Calendar.MILLISECOND));
System.out.println("ampm   -> "+mydate.get(Calendar.AM_PM));
System.out.println("hod    -> "+mydate.get(Calendar.HOUR_OF_DAY));

[3]: http://download.oracle.com/javase/6/docs/api/java/util/GregorianCalendar.html [4]: http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html

解説 (1)

SimpleDateFormatクラスを扱う上で、Dateはスレッドセーフではなく、1つのDateオブジェクトを複数のスレッドで共有することはできないことを覚えておきましょう。

また、"m"と"M"には大きな違いがあり、分には小文字が、月には大文字が使われます。また、"d"と"D"も同様です。これは見落とされがちな微妙なバグの原因となります。詳細はJavadocまたはGuide to Convert String to Date in Javaを参照してください。

解説 (2)