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" を指定した場合です。
MMMM
パターンを使用します。d
パターンを使用します。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以降をお使いの方は、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`参照)。
またしても、Javaの日付に関する議論です。 日付の操作には、Date、Calendar、[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
SimpleDateFormatクラスを扱う上で、Dateはスレッドセーフではなく、1つのDateオブジェクトを複数のスレッドで共有することはできないことを覚えておきましょう。
また、"m"と"M"には大きな違いがあり、分には小文字が、月には大文字が使われます。また、"d"と"D"も同様です。これは見落とされがちな微妙なバグの原因となります。詳細はJavadocまたはGuide to Convert String to Date in Javaを参照してください。