これは難しい方法であり、それらのjava.util.Date
セッターメソッドはJava 1.1(1997)以降廃止されています。入力文字列に一致するフォーマットパターンをSimpleDateFormat
使用して日付をフォーマットするだけです。
入力文字列としての「2010年1月2日」の特定のケースでは、次のようになります。
- 「January」はフルテキストの月なので、
MMMM
パターンを使用します
- 「2」は短い月なので、
d
パターンを使用します。
- 「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
注:書式パターンに時間の部分も含まれている場合は、のLocalDateTime#parse(text, formatter)
代わりにを使用してくださいLocalDate#parse(text, formatter)
。また、フォーマットパターンにタイムゾーンも含まれている場合は、ZonedDateTime#parse(text, formatter)
代わりに使用してください。
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のようなDateTimeFormatter
標準のISO 8601日付は、LocalDateTime#parse(text)
既にISO_LOCAL_DATE_TIME
フォーマッターを使用しているため、直接解析できます。同様に、LocalDate#parse(text)
時刻コンポーネントなしでISO日付を解析し(を参照ISO_LOCAL_DATE
)、ZonedDateTime#parse(text)
オフセットとタイムゾーンを追加してISO日付を解析します(を参照ISO_ZONED_DATE_TIME
)。