public final class DateTimeFormatter extends Object
ãã®ã¯ã©ã¹ã¯ãåºåãšè§£æãè¡ãããã®ã¢ããªã±ãŒã·ã§ã³ã®ã¡ã€ã³ã»ãšã³ããªã»ãã€ã³ããšãªããDateTimeFormatterã®å
±éã®å®è£
ãæäŸããŸãã
ISO_LOCAL_DATEãªã©uuuu-MMM-ddãªã©longãmediumãªã©
ããè€éãªãã©ãŒããã¿ã¯DateTimeFormatterBuilderã«ãã£ãŠæäŸãããŸãã
äž»èŠãªæ¥ä»/æéã¯ã©ã¹ã«ã¯2ã€ã®ã¡ãœãããçšæãããŠããŸãã1ã€ã¯æžåŒèšå®çšã®format(DateTimeFormatter formatter)ããã1ã€ã¯è§£æçšã®parse(CharSequence text, DateTimeFormatter formatter)ã§ãã
ããšãã°ã
LocalDate date = LocalDate.now(); String text = date.format(formatter); LocalDate parsedDate = LocalDate.parse(text, formatter);
ãã®ãã©ãŒãããã«å ããå¿ èŠãªLocaleãChronologyãZoneIdãããã³DecimalStyleãæã€ãã©ãŒããã¿ãäœæã§ããŸãã
withLocaleã¡ãœããã¯ããã±ãŒã«ããªãŒããŒã©ã€ãããæ°ãããã©ãŒããã¿ãè¿ããŸãã ãã±ãŒã«ã¯ãæžåŒèšå®ãšè§£æã®ããã€ãã®åŽé¢ã«åœ±é¿ããŸãã ããšãã°ãofLocalizedDateã¯ãã±ãŒã«åºæã®æ¥ä»ãã©ãŒãããã䜿çšãããã©ãŒããã¿ãæäŸããŸãã
withChronologyã¡ãœããã¯ãæŠããªãŒããŒã©ã€ãããæ°ãããã©ãŒããã¿ãè¿ããŸãã ãªãŒããŒã©ã€ããããå Žåãæ¥ä»/æéã®å€ã¯æžåŒèšå®ã®åã«ãã®æŠã«å€æãããŸãã è§£ææã«ã¯ãæ¥ä»/æéã®å€ã¯ãã®æŠã«å€æãããŠããè¿ãããŸãã
withZoneã¡ãœããã¯ããŸãŒã³ããªãŒããŒã©ã€ãããæ°ãããã©ãŒããã¿ãè¿ããŸãã ãªãŒããŒã©ã€ããããå Žåãæ¥ä»/æéã®å€ã¯ãèŠæ±ãããZoneIdãæã€ZonedDateTimeã«å€æãããŠããæžåŒèšå®ãããŸãã è§£ææã«ã¯ãZoneIdãé©çšãããåŸã§å€ãè¿ãããŸãã
withDecimalStyleã¡ãœããã¯ãDecimalStyleããªãŒããŒã©ã€ãããæ°ãããã©ãŒããã¿ãè¿ããŸãã DecimalStyleã®èšå·ã¯ãæžåŒèšå®ãšè§£æã«äœ¿çšãããŸãã
äžéšã®ã¢ããªã±ãŒã·ã§ã³ã§ã¯ãå€ãjava.text.Formatã¯ã©ã¹ãæžåŒèšå®ã«äœ¿çšããªããã°ãªããªãå ŽåããããŸãã toFormat()ã¡ãœããã¯ãjava.text.Formatã®å®è£
ãè¿ããŸãã
| ãã©ãŒããã¿ | 説æ | äŸ |
|---|---|---|
ofLocalizedDate(dateStyle) |
ãã±ãŒã«ã®æ¥ä»ã¹ã¿ã€ã«ãæã€ãã©ãŒããã¿ | '2011-12-03' |
ofLocalizedTime(timeStyle) |
ãã±ãŒã«ã®æéã¹ã¿ã€ã«ãæã€ãã©ãŒããã¿ | '10:15:30' |
ofLocalizedDateTime(dateTimeStyle) |
ãã±ãŒã«ã®æ¥ä»ãšæéã®ã¹ã¿ã€ã«ãæã€ãã©ãŒããã¿ | '3 Jun 2008 11:05:30' |
ofLocalizedDateTime(dateStyle,timeStyle)
|
ãã±ãŒã«ã®æ¥ä»ã¹ã¿ã€ã«ããã³æéã¹ã¿ã€ã«ãæã€ãã©ãŒããã¿ | '3 Jun 2008 11:05' |
BASIC_ISO_DATE |
åºæ¬çãªISOæ¥ä» | '20111203' |
ISO_LOCAL_DATE |
ISOããŒã«ã«æ¥ä» | '2011-12-03' |
ISO_OFFSET_DATE |
ãªãã»ããä»ãã®ISOæ¥ä» | '2011-12-03+01:00' |
ISO_DATE |
ãªãã»ããä»ããŸãã¯ãªãã»ãããªãã®ISOæ¥ä» | '2011-12-03+01:00'; '2011-12-03' |
ISO_LOCAL_TIME |
ãªãã»ãããªãã®æé | '10:15:30' |
ISO_OFFSET_TIME |
ãªãã»ããä»ãã®æé | '10:15:30+01:00' |
ISO_TIME |
ãªãã»ããä»ããŸãã¯ãªãã»ãããªãã®æé | '10:15:30+01:00'; '10:15:30' |
ISO_LOCAL_DATE_TIME |
ISOããŒã«ã«æ¥ä»ããã³æé | '2011-12-03T10:15:30' |
ISO_OFFSET_DATE_TIME |
ãªãã»ããä»ãã®æ¥ä»æé | 2011-12-03T10:15:30+01:00' |
ISO_ZONED_DATE_TIME |
ãŸãŒã³æå®ã®æ¥ä»æé | '2011-12-03T10:15:30+01:00[Europe/Paris]' |
ISO_DATE_TIME |
ãŸãŒã³IDä»ãã®æ¥ä»ããã³æé | '2011-12-03T10:15:30+01:00[Europe/Paris]' |
ISO_ORDINAL_DATE |
幎ããã³å¹Žã®æ¥ä» | '2012-337' |
ISO_WEEK_DATE |
幎ããã³é± | 2012-W48-6' |
ISO_INSTANT |
ã€ã³ã¹ã¿ã³ãã®æ¥ä»ããã³æé | '2011-12-03T10:15:30Z' |
RFC_1123_DATE_TIME |
RFC 1123 / RFC 822 | 'Tue, 3 Jun 2008 11:05:30 GMT' |
ofPattern(String)ã¡ãœããããã³ofPattern(String, Locale)ã¡ãœããã䜿çšããŠFormatterãäœæããå Žåã«äœ¿çšãããŸãã ããšãã°ã"d MMM uuuu"ã䜿çšãããšã2011-12-03ã¯ã3 Dec 2011ããšæžåŒèšå®ãããŸãã ãã¿ãŒã³ããäœæããããã©ãŒããã¿ã¯ãå¿
èŠã«å¿ããŠäœåºŠã§ã䜿çšã§ããäžå€ã§ã¹ã¬ããã»ãŒãã§ãã
ããšãã°ã
LocalDate date = LocalDate.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy MM dd");
String text = date.format(formatter);
LocalDate parsedDate = LocalDate.parse(text, formatter);
'A'ãã'Z'ããã³'a'ãã'z'ã®ãã¹ãŠã®æåã¯ããã¿ãŒã³æåãšããŠäºçŽãããŠããŸãã æ¬¡ã®ãã¿ãŒã³æåãå®çŸ©ãããŠããŸãã
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;
p pad next pad modifier 1
' escape for text delimiter
'' single quote literal '
[ optional section start
] optional section end
# reserved for future use
{ reserved for future use
} reserved for future use
ãã¿ãŒã³æåã®æ°ã«ãã£ãŠãã©ãŒããããæ±ºãŸããŸãã
ããã¹ã: ããã¹ãã»ã¹ã¿ã€ã«ã¯ã䜿çšããããã¿ãŒã³æåã®æ°ã«åºã¥ããŠæ±ºãŸããŸãã ãã¿ãŒã³æåã4ã€æªæºã®å Žåã¯ãç瞮圢åŒã䜿çšãããŸãã ãã¿ãŒã³æåãã¡ããã©4ã€ã®å Žåã¯ããã«åœ¢åŒã䜿çšãããŸãã ãã¿ãŒã³æåãã¡ããã©5ã€ã®å Žåã¯ãçž®å°åœ¢åŒã䜿çšãããŸãã ãã¿ãŒã³æå'L'ã'c'ãããã³'q'ã¯ãã¹ã¿ã³ãã¢ãã³åœ¢åŒã®ããã¹ãã»ã¹ã¿ã€ã«ãæå®ããŸãã
æ°å€: æåæ°ã1ã®å Žåã¯ãããã£ã³ã°ã䜿çšããæå°ã®æ¡æ°ã§å€ãåºåãããŸãã ãã以å€ã®å Žåã¯ãæåæ°ãåºåãã£ãŒã«ãã®å¹ ãšããŠäœ¿çšãããå€ã¯å¿ èŠã«å¿ããŠãŒãã§ããã£ã³ã°ãããŸãã æ¬¡ã®ãã¿ãŒã³æåã«ã¯ãæåæ°ã«å¶çŽããããŸãã æå'c'ããã³'F'ã¯ã1ã€ã ãæå®ã§ããŸãã æå'd'ã'H'ã'h'ã'K'ã'k'ã'm'ãããã³'s'ã¯ã2ã€ãŸã§æå®ã§ããŸãã æå'D'ã¯ã3ã€ãŸã§æå®ã§ããŸãã
æ°å€/ããã¹ã: ãã¿ãŒã³æåã®æ°ã3以äžã®å Žåã¯ãäžèšã®ãããã¹ããã®ã«ãŒã«ã䜿çšãããŸãã ãã以å€ã®å Žåã¯ãäžèšã®ãæ°å€ãã®ã«ãŒã«ã䜿çšãããŸãã
å°æ°: ç§ã®å°æ°éšãšããŠããç§ãã£ãŒã«ããåºåããŸãã ããç§ã®å€ã¯9æ¡ãªã®ã§ããã¿ãŒã³æåã®æ°ã¯1ãã9ãŸã§ã§ãã 9æªæºã®å Žåãããç§ã®å€ã¯åãæšãŠãããäžäœã®æ¡ã ããåºåãããŸãã
幎: ãã¿ãŒã³æåã®æ°ã«ãã£ãŠæå°ã®ãã£ãŒã«ãå¹
ãæ±ºãŸãããã®å¹
ã«æºããªãå Žåã¯ããã£ã³ã°ã䜿çšãããŸãã æåæ°ã2ã®å Žåã¯ã2æ¡ã®çž®å°åœ¢åŒã䜿çšãããŸãã åºåã®å Žåã¯ãå³2æ¡ãåºåãããŸãã è§£æã®å Žåã¯ãããŒã¹å€ãšããŠ2000ã䜿çšãããããã幎ã®ç¯å²ã¯2000ãã2099ãŸã§ã«ãªããŸãã æåæ°ã4æªæº(ãã ã2以å€)ã®å Žåã¯ãSignStyle.NORMALã®ããã«ãè² ã®å¹Žã«å¯ŸããŠã®ã¿ç¬Šå·ãåºåãããŸãã ãã以å€ã®å Žåã¯ãSignStyle.EXCEEDS_PADã®ããã«ãããã£ã³ã°å¹
ãè¶
ããå Žåã«ç¬Šå·ãåºåãããŸãã
ãŸãŒã³ID: ãEurope/Parisããªã©ã®ã¿ã€ã ãŸãŒã³IDãåºåããŸãã æåæ°ã2ã®å Žåã¯ãã¿ã€ã ãŸãŒã³IDãåºåãããŸãã ãã以å€ã®æåæ°ã§ã¯ãIllegalArgumentExceptionãã¹ããŒãããŸãã
ãŸãŒã³å: ã¿ã€ã ãŸãŒã³IDã®è¡šç€ºåãåºåããŸãã æåæ°ã1ã2ããŸãã¯3ã®å Žåã¯ãçãååãåºåãããŸãã æåæ°ã4ã®å Žåã¯ãå®å
šãªååãåºåãããŸãã 5æå以äžã®å Žåã¯ãIllegalArgumentExceptionãã¹ããŒãããŸãã
ãªãã»ããXããã³x: ãã¿ãŒã³æåã®æ°ã«åºã¥ããŠãªãã»ãããæžåŒèšå®ããŸãã 1æåã®å ŽåãåããŒãã®ãšãã¯æã ããåºåãããŠã+01ãã®ããã«ãªããåããŒãã§ãªããšãã¯åãåºåãããŠã+0130ãã®ããã«ãªããŸãã 2æåã®å Žåã¯ãæãšåãã³ãã³ãªãã§åºåãããã+0130ãã®ããã«ãªããŸãã 3æåã®å Žåã¯ãæãšåãã³ãã³ä»ãã§åºåãããã+01:30ãã®ããã«ãªããŸãã 4æåã®å Žåã¯ãæãšåãããã³ãªãã·ã§ã³ã®ç§ãã³ãã³ãªãã§åºåãããã+013015ãã®ããã«ãªããŸãã 5æåã®å Žåã¯ãæãšåãããã³ãªãã·ã§ã³ã®ç§ãã³ãã³ä»ãã§åºåãããã+01:30:15ãã®ããã«ãªããŸãã 6æå以äžã®å Žåã¯ãIllegalArgumentExceptionãã¹ããŒãããŸãã åºåããããªãã»ããããŒãã«ãªããšãã¯ããã¿ãŒã³æå'X' (倧æå)ã®å Žåã¯ãZããåºåããããã¿ãŒã³æå'x' (å°æå)ã®å Žåã¯ã+00ããã+0000ãããŸãã¯ã+00:00ããåºåãããŸãã
ãªãã»ããO: ãã¿ãŒã³æåã®æ°ã«åºã¥ããŠãããŒã«ã©ã€ãºããããªãã»ãããæžåŒèšå®ããŸãã 1æåã®å Žåã¯ãããŒã«ã©ã€ãºããããªãã»ããã®ç瞮圢åŒãåºåãããŸããããã¯ããŒã«ã©ã€ãºããããªãã»ããã®ããã¹ã(ãGMTããªã©)ãæ(å
é ã®ãŒããå«ãŸãªã)ããªãã·ã§ã³ã®2æ¡ã®åãšç§(ãŒãã§ãªãå Žå)ãããã³ã³ãã³ãããªããããšãã°ãGMT+8ããšãªããŸãã 4æåã®å Žåã¯ããã«åœ¢åŒãåºåãããŸããããã¯ããŒã«ã©ã€ãºããããªãã»ããã®ããã¹ã(ãGMTããªã©)ã2æ¡ã®æãšåã®ãã£ãŒã«ãããªãã·ã§ã³ã®ç§ãã£ãŒã«ã(ãŒãã§ãªãå Žå)ãããã³ã³ãã³ãããªããããšãã°ãGMT+08:00ããšãªããŸãã ãã以å€ã®æåæ°ã§ã¯ãIllegalArgumentExceptionãã¹ããŒãããŸãã
ãªãã»ããZ: ãã¿ãŒã³æåã®æ°ã«åºã¥ããŠãªãã»ãããæžåŒèšå®ããŸãã 1ã2ããŸãã¯3æåã®å Žåã¯ãæãšåãã³ãã³ãªãã§åºåãããã+0130ãã®ããã«ãªããŸãã ãªãã»ããããŒãã®å Žåãåºåã¯ã+0000ãã«ãªããŸãã 4æåã®å Žåã¯ãããŒã«ã©ã€ãºããããªãã»ããã®ãã«åœ¢åŒãåºåãããŸããããã¯ãªãã»ããOã®4æåãšç䟡ã§ãã ãªãã»ããããŒãã®ãšãã¯ã察å¿ããããŒã«ã©ã€ãºããããªãã»ããã®ããã¹ããåºåãããŸãã 5æåã®å Žåã¯ãæãšåãããã³ãªãã·ã§ã³ã®ç§(ãŒãã§ãªãå Žå)ãã³ãã³ä»ãã§åºåãããŸãã ãªãã»ããããŒãã®å Žåã¯ãZããåºåãããŸãã 6æå以äžã®å Žåã¯ãIllegalArgumentExceptionãã¹ããŒãããŸãã
ãªãã·ã§ã³ã®ã»ã¯ã·ã§ã³: ãªãã·ã§ã³ã®ã»ã¯ã·ã§ã³ã®ããŒã«ãŒã¯ãDateTimeFormatterBuilder.optionalStart()ããã³DateTimeFormatterBuilder.optionalEnd()ã®åŒåºããšãŸã£ããåæ§ã«æ©èœããŸãã
ããã£ã³ã°ä¿®é£Ÿå: çŽåŸã®ãã¿ãŒã³ãã¹ããŒã¹ã§ããã£ã³ã°ãããããã«å€æŽããŸãã ããã£ã³ã°å¹
ã¯ããã¿ãŒã³æåã®æ°ã«ãã£ãŠæ±ºãŸããŸãã ããã¯ãDateTimeFormatterBuilder.padNext(int)ãåŒã³åºãã®ãšåãã§ãã
ããšãã°ãppHãã䜿çšãããšãæã¯ãå¹ ã2ã«ãªããŸã§å·Šã«ã¹ããŒã¹ã远å ãããŠåºåãããŸãã
èªèãããªãæåã¯ãšã©ãŒã§ãã è±æåã§ãªãæåã¯ã'['ã']'ã'{'ã'}'ã'#'ãããã³äžéåŒçšç¬Šãé€ããçŽæ¥åºåãããŸãã ãã ããå°æ¥ã®å€æŽã«ãã£ãŠã¢ããªã±ãŒã·ã§ã³ãç Žå£ãããªãããã«ããã«ã¯ãçŽæ¥åºåããããã¹ãŠã®æåãäžéåŒçšç¬Šã§å²ãããšããèŠãããŸãã
MapãZoneIdãããã³ChronologyãçæãããŸãã æ¬¡ã«ãããŸããŸãªãã£ãŒã«ãã®æ€èšŒãçµåãç°¡çŽ åãè¡ã£ãŠããæçšãªãã£ãŒã«ããåŸãããšã«ãããè§£æãããããŒã¿ã解決ãããŸãã
ãã®ã¯ã©ã¹ã«ã¯5ã€ã®è§£æã¡ãœãããçšæãããŠããŸãã ãããã®ãã¡4ã€ã¯ãè§£æãã§ãŒãºãšè§£æ±ºãã§ãŒãºã®äž¡æ¹ãå®è¡ããŸãã 5çªç®ã®ã¡ãœããparseUnresolved(CharSequence, ParsePosition)ã¯æåã®ãã§ãŒãºã ããå®è¡ãããã®çµæã¯æªè§£æ±ºã®ãŸãŸã«ãªããŸãã ãããã£ãŠãããã¯æ¬è³ªçã«äœã¬ãã«ã®åŠçã§ãã
解決ãã§ãŒãºã¯ããã®ã¯ã©ã¹ã«èšå®ããã2ã€ã®ãã©ã¡ãŒã¿ã«ãã£ãŠå¶åŸ¡ãããŸãã
ResolverStyleã¯ãå³å¯ãã¹ããŒããããã³éå³å¯ãšããç°ãªã3ã€ã®æ¹æ³ãæäŸããåæã§ãã ã¹ããŒãã»ãªãã·ã§ã³ãããã©ã«ãã§ãã withResolverStyle(ResolverStyle)ã䜿çšããŠèšå®ã§ããŸãã
withResolverFields(TemporalField...)ãã©ã¡ãŒã¿ã䜿çšãããšã解決ãããã£ãŒã«ãã®ã»ããããã£ã«ã¿ãªã³ã°ããŠãã解決ãéå§ã§ããŸãã ããšãã°ããã©ãŒããã¿ã幎ãæããæã®æ¥ããããã³ãå¹Žã®æ¥ããè§£æããå Žåãæ¥ä»ã解決ããæ¹æ³ã«ã¯ã(幎+æ+ãæã®æ¥ã)ãš(幎+ãå¹Žã®æ¥ã)ã®2ã€ããããŸãã ãªãŸã«ãã»ãã£ãŒã«ãã䜿çšããŠã2ã€ã®æ¹æ³ã®ãããããéžæã§ããŸãã ãªãŸã«ãã»ãã£ãŒã«ããèšå®ãããŠããªãå Žåãäž¡æ¹ã®æ¹æ³ã®çµæã¯åãæ¥ä»ã«ãªãã¯ãã§ãã
åå¥ã®ãã£ãŒã«ãã解決ããŠå®å šãªæ¥ä»ãšæéãæ§ç¯ããããšã¯ã倿°ã®ã¯ã©ã¹ã«åäœã忣ãããè€éãªåŠçã§ãã æ¬¡ã®ã¹ãããã«åŸã£ãŠè¡ãããŸãã
IsoChronologyã«ãªããŸãã
ChronoFieldæ¥ä»ãã£ãŒã«ãã解決ãããŸãã ããã¯Chronology.resolveDate(Map, ResolverStyle)ã䜿çšããŠå®çŸãããŸãã ãã£ãŒã«ã解決ã«é¢ããããã¥ã¡ã³ãã¯ãChronologyã®å®è£
å
ã«ãããŸãã
ChronoFieldæéãã£ãŒã«ãã解決ãããŸãã ãã®ããã¥ã¡ã³ãã¯ChronoFieldäžã«ããããã¹ãŠã®æå»ç³»ã«å¯ŸããŠåãã«ãªããŸãã
ChronoFieldã§ã¯ãªãä»»æã®ãã£ãŒã«ããåŠçãããŸãã ããã¯TemporalField.resolve(Map, TemporalAccessor, ResolverStyle)ã䜿çšããŠå®çŸãããŸãã ãã£ãŒã«ã解決ã«é¢ããããã¥ã¡ã³ãã¯ãTemporalFieldã®å®è£
å
ã«ãããŸãã
ChronoFieldæ¥ä»ãã£ãŒã«ãããã³æéãã£ãŒã«ããå床解決ãããŸãã ããã«ãããã¹ããã4ã®ãã£ãŒã«ãããChronoFieldå€ãçæããããããåŠçããŠæ¥ä»ãšæéã«ããããšãã§ããŸãã
LocalTimeãæ§ç¯ãããŸãã ãã®ãšããåãç§ãããã³ç§ã®å°æ°éšã®ããã©ã«ãå€ã䜿çšãããŸãã
| 修食åãšå | ãã£ãŒã«ã | 説æ |
|---|---|---|
static DateTimeFormatter |
BASIC_ISO_DATE |
æ¥ä»ããªãã»ãããªãã§æžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»ãã©ãŒããã¿(ã20111203ããªã©)ã
|
static DateTimeFormatter |
ISO_DATE |
䜿çšå¯èœãªå Žåã¯ãªãã»ããä»ãã§æ¥ä»ãæžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»ãã©ãŒããã¿(ã2011-12-03ããã2011-12-03+01:00ããªã©)ã
|
static DateTimeFormatter |
ISO_DATE_TIME |
䜿çšå¯èœãªå Žåã¯ãªãã»ããããã³ãŸãŒã³ä»ãã§æ¥ä»/æéãæžåŒèšå®ãŸãã¯è§£æãããISOã«äŒŒãæ¥ä»/æéãã©ãŒããã¿(ã2011-12-03T10:15:30ããã2011-12-03T10:15:30+01:00ããã2011-12-03T10:15:30+01:00[Europe/Paris]ããªã©)ã
|
static DateTimeFormatter |
ISO_INSTANT |
UTCã®ã€ã³ã¹ã¿ã³ããæžåŒèšå®ãŸãã¯è§£æããISOã€ã³ã¹ã¿ã³ãã»ãã©ãŒããã¿(ã2011-12-03T10:15:30Zããªã©)ã
|
static DateTimeFormatter |
ISO_LOCAL_DATE |
æ¥ä»ããªãã»ãããªãã§æžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»ãã©ãŒããã¿(ã2011-12-03ããªã©)ã
|
static DateTimeFormatter |
ISO_LOCAL_DATE_TIME |
æ¥ä»/æéããªãã»ãããªãã§æžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»/æéãã©ãŒããã¿(ã2011-12-03T10:15:30ããªã©)ã
|
static DateTimeFormatter |
ISO_LOCAL_TIME |
æéããªãã»ãããªãã§æžåŒèšå®ãŸãã¯è§£æããISOæéãã©ãŒããã¿(ã10:15ããã10:15:30ããªã©)ã
|
static DateTimeFormatter |
ISO_OFFSET_DATE |
æ¥ä»ããªãã»ããä»ãã§æžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»ãã©ãŒããã¿(ã2011-12-03+01:00ããªã©)ã
|
static DateTimeFormatter |
ISO_OFFSET_DATE_TIME |
æ¥ä»/æéããªãã»ããä»ãã§æžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»/æéãã©ãŒããã¿(ã2011-12-03T10:15:30+01:00ããªã©)ã
|
static DateTimeFormatter |
ISO_OFFSET_TIME |
æéããªãã»ããä»ãã§æžåŒèšå®ãŸãã¯è§£æããISOæéãã©ãŒããã¿(ã10:15+01:00ããã10:15:30+01:00ããªã©)ã
|
static DateTimeFormatter |
ISO_ORDINAL_DATE |
åºæ°åœ¢åŒã®æ¥ä»ããªãã»ãããªãã§æžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»ãã©ãŒããã¿(ã2012-337ããªã©)ã
|
static DateTimeFormatter |
ISO_TIME |
䜿çšå¯èœãªå Žåã¯ãªãã»ããä»ãã§æéãæžåŒèšå®ãŸãã¯è§£æããISOæéãã©ãŒããã¿(ã10:15ããã10:15:30ããã10:15:30+01:00ããªã©)ã
|
static DateTimeFormatter |
ISO_WEEK_DATE |
é±ããŒã¹ã®æ¥ä»ããªãã»ãããªãã§æžåŒèšå®ãŸãã¯è§£æããISOæ¥ä»ãã©ãŒããã¿(ã2012-W48-6ããªã©)ã
|
static DateTimeFormatter |
ISO_ZONED_DATE_TIME |
ãªãã»ããããã³ãŸãŒã³ä»ãã§æ¥ä»/æéãæžåŒèšå®ãŸãã¯è§£æãããISOã«äŒŒãæ¥ä»/æéãã©ãŒããã¿(ã2011-12-03T10:15:30+01:00[Europe/Paris]ããªã©)ã
|
static DateTimeFormatter |
RFC_1123_DATE_TIME |
RFC-1123æ¥ä»/æéãã©ãŒããã¿(ãTue, 3 Jun 2008 11:05:30 GMTããªã©)ã
|
| 修食åãšå | ã¡ãœãã | 説æ |
|---|---|---|
String |
format(TemporalAccessor temporal) |
ãã®ãã©ãŒããã¿ã䜿çšããŠãæ¥ä»/æéãªããžã§ã¯ããæžåŒèšå®ããŸãã
|
void |
formatTo(TemporalAccessor temporal, Appendable appendable) |
ãã®ãã©ãŒããã¿ã䜿çšããŠãæ¥ä»/æéãªããžã§ã¯ãã
Appendableã«æžåŒèšå®ããŸãã |
Chronology |
getChronology() |
æžåŒèšå®æã«äœ¿çšãããªãŒããŒã©ã€ãããæŠãååŸããŸãã
|
DecimalStyle |
getDecimalStyle() |
æžåŒèšå®æã«äœ¿çšãããDecimalStyleãååŸããŸãã
|
Locale |
getLocale() |
æžåŒèšå®æã«äœ¿çšããããã±ãŒã«ãååŸããŸãã
|
Set<TemporalField> |
getResolverFields() |
è§£ææã«äœ¿çšãããªãŸã«ãã»ãã£ãŒã«ããååŸããŸãã
|
ResolverStyle |
getResolverStyle() |
è§£ææã«äœ¿çšãããªãŸã«ãã»ã¹ã¿ã€ã«ãååŸããŸãã
|
ZoneId |
getZone() |
æžåŒèšå®æã«äœ¿çšããããªãŒããŒã©ã€ãã»ãŸãŒã³ãååŸããŸãã
|
static DateTimeFormatter |
ofLocalizedDate(FormatStyle dateStyle) |
ISOæŠã«å¯Ÿãããã±ãŒã«åºæã®æ¥ä»ãã©ãŒããããè¿ããŸãã
|
static DateTimeFormatter |
ofLocalizedDateTime(FormatStyle dateTimeStyle) |
ISOæŠã«å¯Ÿãããã±ãŒã«åºæã®æ¥ä»/æéãã©ãŒããã¿ãè¿ããŸãã
|
static DateTimeFormatter |
ofLocalizedDateTime(FormatStyle dateStyle, FormatStyle timeStyle) |
ISOæŠã«å¯Ÿãããã±ãŒã«åºæã®æ¥ä»ãšæéã®ãã©ãŒããããè¿ããŸãã
|
static DateTimeFormatter |
ofLocalizedTime(FormatStyle timeStyle) |
ISOæŠã«å¯Ÿãããã±ãŒã«åºæã®æéãã©ãŒããããè¿ããŸãã
|
static DateTimeFormatter |
ofPattern(String pattern) |
æå®ããããã¿ãŒã³ã䜿çšããŠãã©ãŒããã¿ãäœæããŸãã
|
static DateTimeFormatter |
ofPattern(String pattern, Locale locale) |
æå®ããããã¿ãŒã³ããã³ãã±ãŒã«ã䜿çšããŠãã©ãŒããã¿ãäœæããŸãã
|
TemporalAccessor |
parse(CharSequence text) |
ããã¹ããå®å
šã«è§£æããŠãæéçãªããžã§ã¯ããçæããŸãã
|
TemporalAccessor |
parse(CharSequence text, ParsePosition position) |
ãã®ãã©ãŒããã¿ã䜿çšããŠããã¹ããè§£æããããã¹ãäœçœ®ã«å¯Ÿããå¶åŸ¡ãæäŸããŸãã
|
<T> T |
parse(CharSequence text, TemporalQuery<T> query) |
ããã¹ããå®å
šã«è§£æããŠãæå®ãããåã®ãªããžã§ã¯ããçæããŸãã
|
TemporalAccessor |
parseBest(CharSequence text, TemporalQuery<?>... queries) |
ããã¹ããå®å
šã«è§£æããŠãæå®ãããããããã®ã¿ã€ãã®ãªããžã§ã¯ããçæããŸãã
|
static TemporalQuery<Period> |
parsedExcessDays() |
è§£æãããè¶
鿥æ°ãžã®ã¢ã¯ã»ã¹ãæäŸããååãã
|
static TemporalQuery<Boolean> |
parsedLeapSecond() |
ãããç§ãè§£æãããã©ãããžã®ã¢ã¯ã»ã¹ãæäŸããååãã
|
TemporalAccessor |
parseUnresolved(CharSequence text, ParsePosition position) |
ãã®ãã©ãŒããã¿ã䜿çšããŠããã¹ããè§£æããŸãããé«åºŠãªãŠãŒã¹ã»ã±ãŒã¹åãã«ãçµæã解決ããŸããã
|
Format |
toFormat() |
ãã®ãã©ãŒããã¿ã
java.text.Formatã€ã³ã¹ã¿ã³ã¹ãšããŠè¿ããŸãã |
Format |
toFormat(TemporalQuery<?> parseQuery) |
ãã®ãã©ãŒããã¿ããæå®ãããååããã䜿çšããŠè§£æãã
java.text.Formatã€ã³ã¹ã¿ã³ã¹ãšããŠè¿ããŸãã |
String |
toString() |
ããŒã¹ãšãªããã©ãŒããã¿ã®èª¬æãè¿ããŸãã
|
DateTimeFormatter |
withChronology(Chronology chrono) |
ãªãŒããŒã©ã€ããããæ°ããæŠã䜿ã£ãŠããã®ãã©ãŒããã¿ã®ã³ããŒãè¿ããŸãã
|
DateTimeFormatter |
withDecimalStyle(DecimalStyle decimalStyle) |
æ°ããDecimalStyleã䜿ã£ãŠããã®ãã©ãŒããã¿ã®ã³ããŒãè¿ããŸãã
|
DateTimeFormatter |
withLocale(Locale locale) |
æ°ãããã±ãŒã«ã䜿ã£ãŠããã®ãã©ãŒããã¿ã®ã³ããŒãè¿ããŸãã
|
DateTimeFormatter |
withResolverFields(Set<TemporalField> resolverFields) |
æ°ãããªãŸã«ãã»ãã£ãŒã«ãã®ã»ããã䜿ã£ãŠããã®ãã©ãŒããã¿ã®ã³ããŒãè¿ããŸãã
|
DateTimeFormatter |
withResolverFields(TemporalField... resolverFields) |
æ°ãããªãŸã«ãã»ãã£ãŒã«ãã®ã»ããã䜿ã£ãŠããã®ãã©ãŒããã¿ã®ã³ããŒãè¿ããŸãã
|
DateTimeFormatter |
withResolverStyle(ResolverStyle resolverStyle) |
æ°ãããªãŸã«ãã»ã¹ã¿ã€ã«ã䜿ã£ãŠããã®ãã©ãŒããã¿ã®ã³ããŒãè¿ããŸãã
|
DateTimeFormatter |
withZone(ZoneId zone) |
æ°ãããªãŒããŒã©ã€ããŸãŒã³ã䜿ã£ãŠããã®ãã©ãŒããã¿ã®ã³ããŒãè¿ããŸãã
|
public static final DateTimeFormatter ISO_LOCAL_DATE
ããã¯ãISO-8601æ¡åŒµã®ããŒã«ã«æ¥ä»ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
幎ã衚ã4ã€ä»¥äžã®æ¡ã 0000ãã9999ã®ç¯å²å
ã«ãã幎ã¯ãå¿
ã4æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã ãã®ç¯å²å€ã®å¹Žã«ã¯ãå
é ã«æ£ç¬Šå·ãŸãã¯è² 笊å·ã远å ãããŸãã
æã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ãæã®æ¥ãã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_OFFSET_DATE
ããã¯ãISO-8601æ¡åŒµã®ãªãã»ããæ¥ä»ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_LOCAL_DATE
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_DATE
ããã¯ãISO-8601æ¡åŒµã®æ¥ä»ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_LOCAL_DATE
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ãã®ãã©ãŒããã¿ã«ã¯ãªãã·ã§ã³èŠçŽ ããããããparseBest(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...)ã䜿çšããŠè§£æããå¿
èŠãããå ŽåããããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_LOCAL_TIME
ããã¯ãISO-8601æ¡åŒµã®ããŒã«ã«æéãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
æã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
åã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ç§ã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ããç§ã衚ã1ã€ãã9ã€ãŸã§ã®æ¡ã æ¡æ°ã¯å¿
èŠãªã ãåºåãããŸãã
è¿ããããã©ãŒããã¿ã¯ããªãŒããŒã©ã€ãããæŠããŸãŒã³ãæã¡ãŸããã STRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_OFFSET_TIME
ããã¯ãISO-8601æ¡åŒµã®ãªãã»ããæéãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_LOCAL_TIME
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
è¿ããããã©ãŒããã¿ã¯ããªãŒããŒã©ã€ãããæŠããŸãŒã³ãæã¡ãŸããã STRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_TIME
ããã¯ãISO-8601æ¡åŒµã®ãªãã»ããæéãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_LOCAL_TIME
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ãã®ãã©ãŒããã¿ã«ã¯ãªãã·ã§ã³èŠçŽ ããããããparseBest(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...)ã䜿çšããŠè§£æããå¿
èŠãããå ŽåããããŸãã
è¿ããããã©ãŒããã¿ã¯ããªãŒããŒã©ã€ãããæŠããŸãŒã³ãæã¡ãŸããã STRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_LOCAL_DATE_TIME
ããã¯ãISO-8601æ¡åŒµã®ãªãã»ããæ¥ä»/æéãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_LOCAL_DATE
ISO_LOCAL_TIME
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_OFFSET_DATE_TIME
ããã¯ãISO-8601æ¡åŒµã®ãªãã»ããæ¥ä»/æéãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_LOCAL_DATE_TIME
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_ZONED_DATE_TIME
ããã¯ãISO-8601æ¡åŒµã®ãªãã»ããæ¥ä»/æéãã©ãŒããããæ¡åŒµããŠã¿ã€ã ãŸãŒã³ã远å ãããã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã è§æ¬åŒ§å ã®ã»ã¯ã·ã§ã³ã¯ISO-8601æšæºã«ã¯å«ãŸããŠããŸããã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_OFFSET_DATE_TIME
ZoneOffsetã§ããå ŽåãæžåŒèšå®ã¯å®äºã§ãã
ãŸãŒã³IDã ããã¯ISO-8601æšæºã«ã¯å«ãŸããŠããŸããã è§£æã§ã¯å€§æåãšå°æåãåºå¥ãããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_DATE_TIME
ããã¯ãISO-8601æ¡åŒµã®ããŒã«ã«ãŸãã¯ãªãã»ããæ¥ä»/æéãã©ãŒããããããã³ã¿ã€ã ãŸãŒã³ãæå®ããISO以å€ã®æ¡åŒµåœ¢åŒã®ãæžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ISO_LOCAL_DATE_TIME
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã
ZoneOffsetã§ããå ŽåãæžåŒèšå®ã¯å®äºã§ãã
ãŸãŒã³IDã ããã¯ISO-8601æšæºã«ã¯å«ãŸããŠããŸããã è§£æã§ã¯å€§æåãšå°æåãåºå¥ãããŸãã
ãã®ãã©ãŒããã¿ã«ã¯ãªãã·ã§ã³èŠçŽ ããããããparseBest(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...)ã䜿çšããŠè§£æããå¿
èŠãããå ŽåããããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_ORDINAL_DATE
ããã¯ãISO-8601æ¡åŒµã®åºæ°åœ¢åŒæ¥ä»ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
幎ã衚ã4ã€ä»¥äžã®æ¡ã 0000ãã9999ã®ç¯å²å
ã«ãã幎ã¯ãå¿
ã4æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã ãã®ç¯å²å€ã®å¹Žã«ã¯ãå
é ã«æ£ç¬Šå·ãŸãã¯è² 笊å·ã远å ãããŸãã
ãå¹Žã®æ¥ãã衚ã3æ¡ã ããã¯å¿
ã3æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ãã®ãã©ãŒããã¿ã«ã¯ãªãã·ã§ã³èŠçŽ ããããããparseBest(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...)ã䜿çšããŠè§£æããå¿
èŠãããå ŽåããããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_WEEK_DATE
ããã¯ãISO-8601æ¡åŒµã®é±ããŒã¹æ¥ä»ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
é±ããŒã¹ã®å¹Žã衚ã4ã€ä»¥äžã®æ¡ã 0000ãã9999ã®ç¯å²å
ã«ãã幎ã¯ãå¿
ã4æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã ãã®ç¯å²å€ã®å¹Žã«ã¯ãå
é ã«æ£ç¬Šå·ãŸãã¯è² 笊å·ã远å ãããŸãã
é±ããŒã¹ã®å¹Žã®é±ã衚ã2æ¡ã ããã¯å¿
ã3æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ææ¥ã衚ã1æ¡ã å€ã®ç¯å²ã¯ææ(1)ããæ¥æ(7)ãŸã§ã§ãã
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ãã®ãã©ãŒããã¿ã«ã¯ãªãã·ã§ã³èŠçŽ ããããããparseBest(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...)ã䜿çšããŠè§£æããå¿
èŠãããå ŽåããããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter ISO_INSTANT
ããã¯ãISO-8601ã€ã³ã¹ã¿ã³ãã»ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã æžåŒèšå®æã«ãç§ã¯åžžã«åºåãããŸãã ããç§ã¯ãå¿ èŠã«å¿ããŠ0ã3ã6ããŸãã¯9æ¡ã§åºåãããŸãã è§£ææãæéã«ã¯å°ãªããšãç§ã®ãã£ãŒã«ããŸã§ãå¿ èŠã§ãã 0ãã9ãŸã§ã®å°æ°ç¹ä»¥äžã®ç§ãè§£æãããŸãã ããŒã«ã©ã€ãºããã10é²ã¹ã¿ã€ã«ã¯äœ¿çšãããŸããã
ããã¯ã人éãèªãã圢åŒã®Instantã䜿çšå¯èœã«ããããã®ç¹æ®ãªãã©ãŒããã¿ã§ãã Instantã¯ã©ã¹ã¯ãæéã®ãã1ç¹ã衚ãããã ãã«èšèšãããŠãããåºå®ã®å
æ1970-01-01Zããã®ããç§åäœã®å€ãå
éšã«æ ŒçŽããŠããŸãã ãããã£ãŠãInstantãæ¥ä»ãæéãšããŠæžåŒèšå®ããã«ã¯ããªãããã®åœ¢åŒã®ã¿ã€ã ãŸãŒã³ãæå®ããå¿
èŠããããŸãã ãã®ãã©ãŒããã¿ã§ã¯ãZoneOffset.UTCã䜿çšããŠé©åãªå€æãæäŸããããšã«ãããInstantãæžåŒèšå®ã§ããŸãã
ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
UTCãªãã»ããã䜿çšããŠChronoField.INSTANT_SECONDSããã³ChronoField.NANO_OF_SECONDããã€ã³ã¹ã¿ã³ãã倿ããISO_OFFSET_DATE_TIMEã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
è¿ããããã©ãŒããã¿ã¯ããªãŒããŒã©ã€ãããæŠããŸãŒã³ãæã¡ãŸããã STRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter BASIC_ISO_DATE
ããã¯ãISO-8601åºæ¬ã®ããŒã«ã«æ¥ä»ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
幎ã衚ã4æ¡ã 0000ãã9999ã®ç¯å²å
ã«ãã幎ã ãããµããŒããããŸãã
æã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ãæã®æ¥ãã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ãªãã»ããIDã ãªãã»ããã«ç§ãå«ãŸããŠããå ŽåãISO-8601æšæºã«ã¯å«ãŸããŠããŸãããç§ãåŠçãããŸãã è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ãã®ãã©ãŒããã¿ã«ã¯ãªãã·ã§ã³èŠçŽ ããããããparseBest(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...)ã䜿çšããŠè§£æããå¿
èŠãããå ŽåããããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSTRICTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static final DateTimeFormatter RFC_1123_DATE_TIME
ããã¯ãã»ãšãã©ã®RFC-1123ãã©ãŒãããã®æžåŒèšå®ããã³è§£æãè¡ããäžå€ã®ãã©ãŒããã¿ãè¿ããŸãã RFC-1123ã¯ã幎ã2æ¡ãã4æ¡ã«å€æŽããRFC-822ã®æŽæ°ã§ãã ãã®å®è£ ã«ã¯4æ¡ã®å¹Žãå¿ èŠã§ãã ãŸãããã®å®è£ ã§ã¯ãGMTããšãªãã»ããéã ããåŠçãããåç±³ã®ãŸãŒã³åãããªã¿ãªãŒã»ãŸãŒã³åã¯åŠçãããŸããã
ãã©ãŒãããã¯æ¬¡ã®ãã®ã§æ§æãããŸãã
ææ¥ãè±èªã§è¡šã3æåã
ãæã®æ¥ãã衚ã1æ¡ãŸãã¯2æ¡ã
æãè±èªã§è¡šã3æåã
幎ã衚ã4æ¡ã 0000ãã9999ã®ç¯å²å
ã«ãã幎ã ãããµããŒããããŸãã
æã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
åã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ç§ã衚ã2æ¡ã ããã¯å¿
ã2æ¡ã«ãªãããã«åã«ãŒãã远å ãããŸãã
ãªãã»ããIDã ãªãã»ããããŒãã®å Žåã¯ãGMTãã䜿çšãããŸãã åç±³ã®ãŸãŒã³åãšããªã¿ãªãŒã»ãŸãŒã³åã¯åŠçãããŸããã
è§£æã§ã¯å€§æåãšå°æåã¯åºå¥ãããŸããã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSMARTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
public static DateTimeFormatter ofPattern(String pattern)
ãã®ã¡ãœããã¯ãã¯ã©ã¹ã®ããã¥ã¡ã³ãã«èª¬æãããŠããåçŽãªæåãšèšå·ã®ãã¿ãŒã³ã«åºã¥ããã©ãŒããã¿ãäœæããŸãã ããšãã°ãd MMM uuuuã䜿çšãããšã2011-12-03ã¯ã3 Dec 2011ããšæžåŒèšå®ãããŸãã
ãã©ãŒããã¿ã¯ããã©ã«ãã®FORMATãã±ãŒã«ã䜿çšããŸãã ããã倿Žããã«ã¯ãè¿ããããã©ãŒããã¿ã«å¯ŸããŠwithLocale(Locale)ã䜿çšãããããã®ã¡ãœããã®ããªã¢ã³ãã§ããofPattern(String, Locale)ã䜿çšããŸãã
è¿ããããã©ãŒããã¿ã¯ããªãŒããŒã©ã€ãããæŠããŸãŒã³ãæã¡ãŸããã SMARTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
pattern - 䜿çšãããã¿ãŒã³ãnull以å€IllegalArgumentException - ãã¿ãŒã³ãç¡å¹ãªå ŽåDateTimeFormatterBuilder.appendPattern(String)public static DateTimeFormatter ofPattern(String pattern, Locale locale)
ãã®ã¡ãœããã¯ãã¯ã©ã¹ã®ããã¥ã¡ã³ãã«èª¬æãããŠããåçŽãªæåãšèšå·ã®ãã¿ãŒã³ã«åºã¥ããã©ãŒããã¿ãäœæããŸãã ããšãã°ãd MMM uuuuã䜿çšãããšã2011-12-03ã¯ã3 Dec 2011ããšæžåŒèšå®ãããŸãã
ãã©ãŒããã¿ã¯æå®ããããã±ãŒã«ã䜿çšããŸãã ããã倿Žããã«ã¯ãè¿ããããã©ãŒããã¿ã«å¯ŸããŠwithLocale(Locale)ã䜿çšããŸã
è¿ããããã©ãŒããã¿ã¯ããªãŒããŒã©ã€ãããæŠããŸãŒã³ãæã¡ãŸããã SMARTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
pattern - 䜿çšãããã¿ãŒã³ãnull以å€locale - 䜿çšãããã±ãŒã«ãnull以å€IllegalArgumentException - ãã¿ãŒã³ãç¡å¹ãªå ŽåDateTimeFormatterBuilder.appendPattern(String)public static DateTimeFormatter ofLocalizedDate(FormatStyle dateStyle)
ããã¯ãæ¥ä»ã®æžåŒèšå®ãŸãã¯è§£æãè¡ããã©ãŒããã¿ãè¿ããŸãã 䜿çšãããæ£ç¢ºãªãã©ãŒãããã»ãã¿ãŒã³ã¯ãã±ãŒã«ã«ãã£ãŠç°ãªããŸãã
ãã±ãŒã«ã¯ãã©ãŒããã¿ããå€å®ãããŸãã çŽæ¥ãã®ã¡ãœããããè¿ããããã©ãŒããã¿ã¯ãããã©ã«ãã®FORMATãã±ãŒã«ã䜿çšããŸãã ãã®ã¡ãœããã®çµæã«å¯ŸããŠwithLocale(Locale)ã䜿çšããããšã«ããããã±ãŒã«ãå¶åŸ¡ã§ããŸãã
ããŒã«ã©ã€ãºããããã¿ãŒã³ã®æ€çŽ¢ã¯é
å»¶çã«è¡ãããŸãã ãã®DateTimeFormatterã¯ãèŠæ±ãããã¹ã¿ã€ã«ãšãã±ãŒã«ãä¿æããèŠæ±ããããã¿ãŒã³ããªã³ã»ããã³ãã§æ€çŽ¢ããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSMARTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
dateStyle - ååŸãããã©ãŒããã¿ã»ã¹ã¿ã€ã«ãnull以å€public static DateTimeFormatter ofLocalizedTime(FormatStyle timeStyle)
ããã¯ãæéã®æžåŒèšå®ãŸãã¯è§£æãè¡ããã©ãŒããã¿ãè¿ããŸãã 䜿çšãããæ£ç¢ºãªãã©ãŒãããã»ãã¿ãŒã³ã¯ãã±ãŒã«ã«ãã£ãŠç°ãªããŸãã
ãã±ãŒã«ã¯ãã©ãŒããã¿ããå€å®ãããŸãã çŽæ¥ãã®ã¡ãœããããè¿ããããã©ãŒããã¿ã¯ãããã©ã«ãã®FORMATãã±ãŒã«ã䜿çšããŸãã ãã®ã¡ãœããã®çµæã«å¯ŸããŠwithLocale(Locale)ã䜿çšããããšã«ããããã±ãŒã«ãå¶åŸ¡ã§ããŸãã
ããŒã«ã©ã€ãºããããã¿ãŒã³ã®æ€çŽ¢ã¯é
å»¶çã«è¡ãããŸãã ãã®DateTimeFormatterã¯ãèŠæ±ãããã¹ã¿ã€ã«ãšãã±ãŒã«ãä¿æããèŠæ±ããããã¿ãŒã³ããªã³ã»ããã³ãã§æ€çŽ¢ããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSMARTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
timeStyle - ååŸãããã©ãŒããã¿ã»ã¹ã¿ã€ã«ãnull以å€public static DateTimeFormatter ofLocalizedDateTime(FormatStyle dateTimeStyle)
ããã¯ãæ¥ä»/æéã®æžåŒèšå®ãŸãã¯è§£æãè¡ããã©ãŒããã¿ãè¿ããŸãã 䜿çšãããæ£ç¢ºãªãã©ãŒãããã»ãã¿ãŒã³ã¯ãã±ãŒã«ã«ãã£ãŠç°ãªããŸãã
ãã±ãŒã«ã¯ãã©ãŒããã¿ããå€å®ãããŸãã çŽæ¥ãã®ã¡ãœããããè¿ããããã©ãŒããã¿ã¯ãããã©ã«ãã®FORMATãã±ãŒã«ã䜿çšããŸãã ãã®ã¡ãœããã®çµæã«å¯ŸããŠwithLocale(Locale)ã䜿çšããããšã«ããããã±ãŒã«ãå¶åŸ¡ã§ããŸãã
ããŒã«ã©ã€ãºããããã¿ãŒã³ã®æ€çŽ¢ã¯é
å»¶çã«è¡ãããŸãã ãã®DateTimeFormatterã¯ãèŠæ±ãããã¹ã¿ã€ã«ãšãã±ãŒã«ãä¿æããèŠæ±ããããã¿ãŒã³ããªã³ã»ããã³ãã§æ€çŽ¢ããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSMARTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
dateTimeStyle - ååŸãããã©ãŒããã¿ã»ã¹ã¿ã€ã«ãnull以å€public static DateTimeFormatter ofLocalizedDateTime(FormatStyle dateStyle, FormatStyle timeStyle)
ããã¯ãæ¥ä»/æéã®æžåŒèšå®ãŸãã¯è§£æãè¡ããã©ãŒããã¿ãè¿ããŸãã 䜿çšãããæ£ç¢ºãªãã©ãŒãããã»ãã¿ãŒã³ã¯ãã±ãŒã«ã«ãã£ãŠç°ãªããŸãã
ãã±ãŒã«ã¯ãã©ãŒããã¿ããå€å®ãããŸãã çŽæ¥ãã®ã¡ãœããããè¿ããããã©ãŒããã¿ã¯ãããã©ã«ãã®FORMATãã±ãŒã«ã䜿çšããŸãã ãã®ã¡ãœããã®çµæã«å¯ŸããŠwithLocale(Locale)ã䜿çšããããšã«ããããã±ãŒã«ãå¶åŸ¡ã§ããŸãã
ããŒã«ã©ã€ãºããããã¿ãŒã³ã®æ€çŽ¢ã¯é
å»¶çã«è¡ãããŸãã ãã®DateTimeFormatterã¯ãèŠæ±ãããã¹ã¿ã€ã«ãšãã±ãŒã«ãä¿æããèŠæ±ããããã¿ãŒã³ããªã³ã»ããã³ãã§æ€çŽ¢ããŸãã
ä»ã®æŠäœç³»ã®æ¥ä»ãæ£ãã倿ãããããã«ããããã«ãè¿ããããã©ãŒããã¿ã«ã¯ISOæŠãèšå®ãããŸãã ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæãããSMARTãªãŸã«ãã»ã¹ã¿ã€ã«ã䜿çšããŸãã
dateStyle - ååŸããæ¥ä»ãã©ãŒããã¿ã»ã¹ã¿ã€ã«ãnull以å€timeStyle - ååŸããæéãã©ãŒããã¿ã»ã¹ã¿ã€ã«ãnull以å€public static final TemporalQuery<Period> parsedExcessDays()
ããã¯ãè§£æããã®è¿œå æ å ±ãžã®ã¢ã¯ã»ã¹ãæäŸããåäœååãããè¿ããŸãã ååããã¯åžžã«null以å€ã®æéãè¿ããnullã®ä»£ããã«ãŒãã®æéãè¿ããŸãã
ãã®ååããããŒã以å€ã®æéãè¿ãç¶æ³ã¯2ã€ãããŸãã
ResolverStyleãLENIENTã®å Žåãæ¥ä»ãå«ãŸãªãæéãè§£æããããšãå®å
šãªè§£æçµæã¯LocalTimeãšè¶
éPeriod (æ¥æ°)ããæ§æãããŸãã
ResolverStyleãSMARTã®å Žåãæ¥ä»ãå«ãŸãªãæéãè§£æããããã®æéã24:00:00ã§ãããšããå®å
šãªè§£æçµæã¯LocalTime 00:00:00ãšè¶
éPeriod 1æ¥ããæ§æãããŸãã
ã©ã¡ãã®å Žåããå®å
šãªChronoLocalDateTimeãŸãã¯Instantãè§£æããããšãæ¥ä»éšåã«è¶
鿥æ°ãå ç®ãããŸãã çµæãšããŠããã®ååããã¯ãŒãã®æéãè¿ããŸãã
SMARTåäœã§ã¯ãã1æ¥ã®çµããããšããŠãã䜿çšãããå€24:00ãåŠçãããŸãã LENIENTã¢ãŒãã§åŠçããå Žåããåãçµæã«ãªããŸãã
Text to parse Parsed object Excess days "2012-12-03T00:00" LocalDateTime.of(2012, 12, 3, 0, 0) ZERO "2012-12-03T24:00" LocalDateTime.of(2012, 12, 4, 0, 0) ZERO "00:00" LocalTime.of(0, 0) ZERO "24:00" LocalTime.of(0, 0) Period.ofDays(1)ååããã¯æ¬¡ã®ããã«äœ¿çšã§ããŸãã
TemporalAccessor parsed = formatter.parse(str); LocalTime time = parsed.query(LocalTime::from); Period extraDays = parsed.query(DateTimeFormatter.parsedExcessDays());
public static final TemporalQuery<Boolean> parsedLeapSecond()
ããã¯ãè§£æããã®è¿œå æ å ±ãžã®ã¢ã¯ã»ã¹ãæäŸããåäœååãããè¿ããŸãã ååããã¯åžžã«null以å€ã®ããŒã«å€ãè¿ããŸãããããç§ãè§£æãããå Žåã¯trueããã以å€ã®å Žåã¯falseã§ãã
ã€ã³ã¹ã¿ã³ãã®è§£æã§ã¯ãç¹æ®ãªããããç§ãæéã23:59:60ããåŠçãããŸãã ãããç§ã¯ãUTCã¿ã€ã ãŸãŒã³ã§ã¯ã23:59:60ãã«çºçããŸãããã¿ã€ã ãŸãŒã³ã«ãã£ãŠã¯ä»ã®ããŒã«ã«æéã«çºçããŸãã ãã®æœåšçãªãããŸãããåé¿ããããã«ããããç§ã®åŠçã¯DateTimeFormatterBuilder.appendInstant()ã«éå®ãããŠããŸãããã®ã¡ãœããã¯åžžã«UTCãŸãŒã³ã»ãªãã»ããã§ã€ã³ã¹ã¿ã³ããè§£æããããã§ãã
æéã23:59:60ããåãåãããå Žåã¯ãç§60ã59ã§çœ®ãæããåçŽãªå€æãé©çšãããŸãã ãã®ååãããè§£æçµæã«å¯ŸããŠäœ¿çšãããšããããç§ã®èª¿æŽãè¡ããããã©ãããå€å®ã§ããŸãã ååãã¯ããããç§ãåé€ãã調æŽãè¡ãããå Žåã¯trueãè¿ãããã以å€ã®å Žåã¯falseãè¿ããŸãã UTC-SLSãšãã£ããããç§ã®å¹³æ»åã¡ã«ããºã ã®é©çšã¯ã次ã®ããã«ã¢ããªã±ãŒã·ã§ã³ã§è¡ãå¿
èŠããããŸãã
TemporalAccessor parsed = formatter.parse(str);
Instant instant = parsed.query(Instant::from);
if (parsed.query(DateTimeFormatter.parsedLeapSecond())) {
// validate leap-second is correct and apply correct smoothing
}
public Locale getLocale()
ããã¯ãç¹å®ã®ããŒã«ãªãŒãŒã·ã§ã³ãå¿ èŠãšãããã©ãŒããã¿ã®éšå(ããã¹ããããŒã«ã©ã€ãºããããã¿ãŒã³ãªã©)ãæ€çŽ¢ããããã«äœ¿çšãããŸãã
public DateTimeFormatter withLocale(Locale locale)
ããã¯ãç¹å®ã®ããŒã«ãªãŒãŒã·ã§ã³ãå¿ èŠãšãããã©ãŒããã¿ã®éšå(ããã¹ããããŒã«ã©ã€ãºããããã¿ãŒã³ãªã©)ãæ€çŽ¢ããããã«äœ¿çšãããŸãã
ãã®ã€ã³ã¹ã¿ã³ã¹ã¯äžå€ã§ããã®ã¡ãœããåŒã³åºãã«ãã£ãŠåœ±é¿ãåããŸããã
locale - æ°ãããã±ãŒã«ãnull以å€public DecimalStyle getDecimalStyle()
public DateTimeFormatter withDecimalStyle(DecimalStyle decimalStyle)
ãã®ã€ã³ã¹ã¿ã³ã¹ã¯äžå€ã§ããã®ã¡ãœããåŒã³åºãã«ãã£ãŠåœ±é¿ãåããŸããã
decimalStyle - æ°ããDecimalStyleãnull以å€public Chronology getChronology()
ããã¯ãæ¥ä»ã®å€æã«äœ¿çšããããªãŒããŒã©ã€ãæŠãè¿ããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯ãªãŒããŒã©ã€ãæŠãæããªããããnullãè¿ãããŸãã ãªãŒããŒã©ã€ãã®è©³çްã«ã€ããŠã¯ãwithChronology(Chronology)ãåç
§ããŠãã ããã
public DateTimeFormatter withChronology(Chronology chrono)
ããã¯ããã®ãã©ãŒããã¿ã«äŒŒãç¶æ ã®ãã©ãŒããã¿ãè¿ããŸãããã ãããªãŒããŒã©ã€ãæŠãèšå®ãããŠããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯ãªãŒããŒã©ã€ãæŠãæããªããããnullãè¿ãããŸãã
ãªãŒããŒã©ã€ãã远å ãããå ŽåãæžåŒèšå®ãŸãã¯è§£æãããä»»æã®æ¥ä»ã圱é¿ãåããŸãã
æžåŒèšå®æã¯ãæéçãªããžã§ã¯ãã«æ¥ä»ãå«ãŸããŠããå ŽåããªãŒããŒã©ã€ãæŠã®æ¥ä»ã«å€æãããŸãã æéçãªããžã§ã¯ãã«æ¥ä»ãå«ãŸããŠãããã©ããã¯ãEPOCH_DAYãã£ãŒã«ããç
§äŒããããšã«ãã£ãŠå€å®ãããŸãã æéãšãŸãŒã³ã¯ããªãŒããŒã©ã€ããããªãããã倿ŽãããŸããã
æéçãªããžã§ã¯ãã«æ¥ä»ãå«ãŸããŠããªãã«ããããããã1ã€ä»¥äžã®ChronoFieldæ¥ä»ãã£ãŒã«ããå«ãŸããŠããå Žåã¯ãDateTimeExceptionãã¹ããŒãããŸãã ãã®ä»ã®å Žåã¯ãã¹ãŠããªãŒããŒã©ã€ãæŠãæéçãªããžã§ã¯ãã«è¿œå ãããŸããããã«ãã£ãŠä»¥åã®æŠã¯çœ®ãæããããŸãããæ¥ä»/æéã¯å€æŽãããŸããã
è§£ææã¯ãç°ãªã2ã€ã®å Žåãèæ
®ããå¿
èŠããããŸãã ããããDateTimeFormatterBuilder.appendChronologyId()ã䜿çšãããããã«ãæŠãããã¹ãããçŽæ¥è§£æãããå Žåããã®ãªãŒããŒã©ã€ãæŠã¯äœã®å¹æãæã¡ãŸããã ãŸãŒã³ãè§£æãããªãã£ãå Žåã¯ããã®ãªãŒããŒã©ã€ãæŠã䜿çšããŠãæŠã®æ¥ä»è§£æ±ºã«ãŒã«ã«åŸã£ãŠChronoFieldå€ãæ¥ä»ã«è§£éãããŸãã
ãã®ã€ã³ã¹ã¿ã³ã¹ã¯äžå€ã§ããã®ã¡ãœããåŒã³åºãã«ãã£ãŠåœ±é¿ãåããŸããã
chrono - æ°ããæŠããªãŒããŒã©ã€ãããªãå Žåã¯nullpublic ZoneId getZone()
ããã¯ãã€ã³ã¹ã¿ã³ãã®å€æã«äœ¿çšããããªãŒããŒã©ã€ãã»ãŸãŒã³ãè¿ããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæããªããããnullãè¿ãããŸãã ãªãŒããŒã©ã€ãã®è©³çްã«ã€ããŠã¯ãwithZone(ZoneId)ãåç
§ããŠãã ããã
public DateTimeFormatter withZone(ZoneId zone)
ããã¯ããã®ãã©ãŒããã¿ã«äŒŒãç¶æ ã®ãã©ãŒããã¿ãè¿ããŸãããã ãããªãŒããŒã©ã€ãã»ãŸãŒã³ãèšå®ãããŠããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯ãªãŒããŒã©ã€ãã»ãŸãŒã³ãæããªããããnullãè¿ãããŸãã
ãªãŒããŒã©ã€ãã远å ãããå ŽåãæžåŒèšå®ãŸãã¯è§£æãããä»»æã®ã€ã³ã¹ã¿ã³ãã圱é¿ãåããŸãã
æžåŒèšå®æã¯ãæéçãªããžã§ã¯ãã«ã€ã³ã¹ã¿ã³ããå«ãŸããŠããå ŽåããªãŒããŒã©ã€ãã»ãŸãŒã³ã䜿çšããŠãŸãŒã³æå®ã®æ¥ä»/æéã«å€æãããŸãã æéçãªããžã§ã¯ããã€ã³ã¹ã¿ã³ãã§ãããã©ããã¯ãINSTANT_SECONDSãã£ãŒã«ããç
§äŒããããšã«ãã£ãŠå€å®ãããŸãã å
¥åã«æŠãå«ãŸããŠããå Žåã¯ãããããªãŒããŒã©ã€ããããªããããç¶æãããŸãã Instantã®ããã«ãå
¥åã«æŠãå«ãŸããŠããªãå Žåã¯ãISOæŠã䜿çšãããŸãã
æéçãªããžã§ã¯ãã«ã€ã³ã¹ã¿ã³ããå«ãŸããŠããªãã«ããããããããªãã»ãããå«ãŸããŠããå Žåã¯ã远å ãã§ãã¯ãè¡ãããŸãã æ£èŠåããããªãŒããŒã©ã€ãã»ãŸãŒã³ããæéçãªããžã§ã¯ãã®ãªãã»ãããšã¯ç°ãªããªãã»ããã§ããå ŽåãDateTimeExceptionãã¹ããŒãããŸãã ãã®ä»ã®å Žåã¯ãã¹ãŠããªãŒããŒã©ã€ãã»ãŸãŒã³ãæéçãªããžã§ã¯ãã«è¿œå ãããŸããããã«ãã£ãŠä»¥åã®ãŸãŒã³ã¯çœ®ãæããããŸãããæ¥ä»/æéã¯å€æŽãããŸããã
è§£ææã¯ãç°ãªã2ã€ã®å Žåãèæ
®ããå¿
èŠããããŸãã ããããDateTimeFormatterBuilder.appendZoneId()ã䜿çšãããããã«ããŸãŒã³ãããã¹ãããçŽæ¥è§£æãããå Žåããã®ãªãŒããŒã©ã€ãã»ãŸãŒã³ã¯äœã®å¹æãæã¡ãŸããã ãŸãŒã³ãè§£æãããªãã£ãå Žåããã®ãªãŒããŒã©ã€ãã»ãŸãŒã³ã¯è§£æçµæã«å«ããããã€ã³ã¹ã¿ã³ãããã³æ¥ä»/æéã®æ§ç¯ã«äœ¿çšãããŸãã
ãã®ã€ã³ã¹ã¿ã³ã¹ã¯äžå€ã§ããã®ã¡ãœããåŒã³åºãã«ãã£ãŠåœ±é¿ãåããŸããã
zone - æ°ãããªãŒããŒã©ã€ãã»ãŸãŒã³ããªãŒããŒã©ã€ãããªãå Žåã¯nullpublic ResolverStyle getResolverStyle()
ããã¯ããã£ãŒã«ããæ¥ä»ãšæéã«è§£æ±ºããè§£æã®ç¬¬2ãã§ãŒãºã§äœ¿çšããããªãŸã«ãã»ã¹ã¿ã€ã«ãè¿ããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯SMARTãªãŸã«ãã»ã¹ã¿ã€ã«ãæã¡ãŸãã 詳现ã¯ãwithResolverStyle(ResolverStyle)ãåç
§ããŠãã ããã
public DateTimeFormatter withResolverStyle(ResolverStyle resolverStyle)
ããã¯ããã®ãã©ãŒããã¿ã«äŒŒãç¶æ
ã®ãã©ãŒããã¿ãè¿ããŸãããã ãããªãŸã«ãã»ã¹ã¿ã€ã«ãèšå®ãããŠããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯SMARTãªãŸã«ãã»ã¹ã¿ã€ã«ãæã¡ãŸãã
ãªãŸã«ãã»ã¹ã¿ã€ã«ã®å€æŽã广ãæã€ã®ã¯ãè§£ææã®ã¿ã§ãã ããã¹ãæååã®è§£æã¯2段éã§è¡ãããŸãã ãã§ãŒãº1ã¯ããã«ããŒã«è¿œå ããããã£ãŒã«ãã«åŸã£ãŠè¡ãããåºæ¬çãªããã¹ãè§£æã§ãã ãã§ãŒãº2ã§ã¯ãè§£æããããã£ãŒã«ããšå€ã®ãã¢ããæ¥ä»ãŸãã¯æéãªããžã§ã¯ãããããã¯ãã®äž¡æ¹ã«è§£æ±ºãããŸãã ãªãŸã«ãã»ã¹ã¿ã€ã«ã¯ããã§ãŒãº2 (解決)ãã©ã®ããã«è¡ãããå¶åŸ¡ããããã«äœ¿çšãããŸãã 䜿çšå¯èœãªãªãã·ã§ã³ã®è©³çްã«ã€ããŠã¯ãResolverStyleãåç
§ããŠãã ããã
ãã®ã€ã³ã¹ã¿ã³ã¹ã¯äžå€ã§ããã®ã¡ãœããåŒã³åºãã«ãã£ãŠåœ±é¿ãåããŸããã
resolverStyle - æ°ãããªãŸã«ãã»ã¹ã¿ã€ã«ãnull以å€public Set<TemporalField> getResolverFields()
ããã¯ããã£ãŒã«ããæ¥ä»ãšæéã«è§£æ±ºããè§£æã®ç¬¬2ãã§ãŒãºã§äœ¿çšããããªãŸã«ãã»ãã£ãŒã«ããè¿ããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯ãªãŸã«ãã»ãã£ãŒã«ããæããªããããnullãè¿ãããŸãã 詳现ã¯ãwithResolverFields(Set)ãåç
§ããŠãã ããã
public DateTimeFormatter withResolverFields(TemporalField... resolverFields)
ããã¯ããã®ãã©ãŒããã¿ã«äŒŒãç¶æ ã®ãã©ãŒããã¿ãè¿ããŸãããã ãããªãŸã«ãã»ãã£ãŒã«ããèšå®ãããŠããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯ãªãŸã«ãã»ãã£ãŒã«ããæã¡ãŸããã
ãªãŸã«ãã»ãã£ãŒã«ãã®å€æŽã广ãæã€ã®ã¯ãè§£ææã®ã¿ã§ãã ããã¹ãæååã®è§£æã¯2段éã§è¡ãããŸãã ãã§ãŒãº1ã¯ããã«ããŒã«è¿œå ããããã£ãŒã«ãã«åŸã£ãŠè¡ãããåºæ¬çãªããã¹ãè§£æã§ãã ãã§ãŒãº2ã§ã¯ãè§£æããããã£ãŒã«ããšå€ã®ãã¢ããæ¥ä»ãŸãã¯æéãªããžã§ã¯ãããããã¯ãã®äž¡æ¹ã«è§£æ±ºãããŸãã ãªãŸã«ãã»ãã£ãŒã«ãã¯ããã§ãŒãº1ãš2ã®éã§ãã£ãŒã«ããšå€ã®ãã¢ããã£ã«ã¿ãªã³ã°ããããã«äœ¿çšãããŸãã
æ¥ä»ãŸãã¯æéã®è§£æ±ºæ¹æ³ã2ã€ä»¥äžããéžæããå Žåã«äœ¿çšã§ããŸãã ããšãã°ããã©ãŒããã¿ã幎ãæããæã®æ¥ããããã³ãå¹Žã®æ¥ãããæ§æãããŠããå Žåãæ¥ä»ã解決ããæ¹æ³ã¯2ã€ãããŸãã åŒæ°YEARããã³DAY_OF_YEARãæå®ããŠãã®ã¡ãœãããåŒã³åºããšãæ¥ä»ã¯å¿
ã幎ãšãå¹Žã®æ¥ãã䜿çšããŠè§£æ±ºãããŸããããã¯å®è³ªçã«ã解決ãã§ãŒãºã§æãšãæã®æ¥ãã¯ç¡èŠãããããšãæå³ããŸãã
åæ§ã«ããã®ã¡ãœããã䜿çšãããšããã以å€ã®å Žåã«ã¯ç
§åããã2次çãªãã£ãŒã«ããç¡èŠããããšãã§ããŸãã ããšãã°ããã©ãŒããã¿ã幎ãæããæã®æ¥ããããã³ææ¥ããæ§æãããŠããå Žåãæ¥ä»ã解決ããæ¹æ³ã¯1ã€ã ãã§ãããè§£æãããææ¥ã®å€ã解決ãããæ¥ä»ãšç
§åãããŸãã åŒæ°YEARãMONTH_OF_YEARãããã³DAY_OF_MONTHãæå®ããŠãã®ã¡ãœãããåŒã³åºããšãæ¥ä»ã¯å¿
ãæ£ãã解決ãããŸãããã ããææ¥ã®ç
§åã¯è¡ãããŸããã
å®è£ ã®èгç¹ããã¯ããã®ã¡ãœããã¯æ¬¡ã®ããã«åäœããŸãã è§£æãã§ãŒãºã®çµæã¯ããã£ãŒã«ãããå€ãžã®ããããšã¿ãªãããšãã§ããŸãã ãã®ã¡ãœããã¯ããã§ãŒãº1ãš2ã®éã§ãã®ãããã®ãã£ã«ã¿ãªã³ã°ãçºçãããŠããã®ã¡ãœããã®åŒæ°ãšããŠæå®ããããã£ãŒã«ã以å€ã®ãã£ãŒã«ãããã¹ãŠåé€ããŸãã
ãã®ã€ã³ã¹ã¿ã³ã¹ã¯äžå€ã§ããã®ã¡ãœããåŒã³åºãã«ãã£ãŠåœ±é¿ãåããŸããã
resolverFields - ãªãŸã«ãã»ãã£ãŒã«ãã®æ°ããã»ããããã£ãŒã«ãããªãå Žåã¯nullpublic DateTimeFormatter withResolverFields(Set<TemporalField> resolverFields)
ããã¯ããã®ãã©ãŒããã¿ã«äŒŒãç¶æ ã®ãã©ãŒããã¿ãè¿ããŸãããã ãããªãŸã«ãã»ãã£ãŒã«ããèšå®ãããŠããŸãã ããã©ã«ãã§ã¯ããã©ãŒããã¿ã¯ãªãŸã«ãã»ãã£ãŒã«ããæã¡ãŸããã
ãªãŸã«ãã»ãã£ãŒã«ãã®å€æŽã广ãæã€ã®ã¯ãè§£ææã®ã¿ã§ãã ããã¹ãæååã®è§£æã¯2段éã§è¡ãããŸãã ãã§ãŒãº1ã¯ããã«ããŒã«è¿œå ããããã£ãŒã«ãã«åŸã£ãŠè¡ãããåºæ¬çãªããã¹ãè§£æã§ãã ãã§ãŒãº2ã§ã¯ãè§£æããããã£ãŒã«ããšå€ã®ãã¢ããæ¥ä»ãŸãã¯æéãªããžã§ã¯ãããããã¯ãã®äž¡æ¹ã«è§£æ±ºãããŸãã ãªãŸã«ãã»ãã£ãŒã«ãã¯ããã§ãŒãº1ãš2ã®éã§ãã£ãŒã«ããšå€ã®ãã¢ããã£ã«ã¿ãªã³ã°ããããã«äœ¿çšãããŸãã
æ¥ä»ãŸãã¯æéã®è§£æ±ºæ¹æ³ã2ã€ä»¥äžããéžæããå Žåã«äœ¿çšã§ããŸãã ããšãã°ããã©ãŒããã¿ã幎ãæããæã®æ¥ããããã³ãå¹Žã®æ¥ãããæ§æãããŠããå Žåãæ¥ä»ã解決ããæ¹æ³ã¯2ã€ãããŸãã åŒæ°YEARããã³DAY_OF_YEARãæå®ããŠãã®ã¡ãœãããåŒã³åºããšãæ¥ä»ã¯å¿
ã幎ãšãå¹Žã®æ¥ãã䜿çšããŠè§£æ±ºãããŸããããã¯å®è³ªçã«ã解決ãã§ãŒãºã§æãšãæã®æ¥ãã¯ç¡èŠãããããšãæå³ããŸãã
åæ§ã«ããã®ã¡ãœããã䜿çšãããšããã以å€ã®å Žåã«ã¯ç
§åããã2次çãªãã£ãŒã«ããç¡èŠããããšãã§ããŸãã ããšãã°ããã©ãŒããã¿ã幎ãæããæã®æ¥ããããã³ææ¥ããæ§æãããŠããå Žåãæ¥ä»ã解決ããæ¹æ³ã¯1ã€ã ãã§ãããè§£æãããææ¥ã®å€ã解決ãããæ¥ä»ãšç
§åãããŸãã åŒæ°YEARãMONTH_OF_YEARãããã³DAY_OF_MONTHãæå®ããŠãã®ã¡ãœãããåŒã³åºããšãæ¥ä»ã¯å¿
ãæ£ãã解決ãããŸãããã ããææ¥ã®ç
§åã¯è¡ãããŸããã
å®è£ ã®èгç¹ããã¯ããã®ã¡ãœããã¯æ¬¡ã®ããã«åäœããŸãã è§£æãã§ãŒãºã®çµæã¯ããã£ãŒã«ãããå€ãžã®ããããšã¿ãªãããšãã§ããŸãã ãã®ã¡ãœããã¯ããã§ãŒãº1ãš2ã®éã§ãã®ãããã®ãã£ã«ã¿ãªã³ã°ãçºçãããŠããã®ã¡ãœããã®åŒæ°ãšããŠæå®ããããã£ãŒã«ã以å€ã®ãã£ãŒã«ãããã¹ãŠåé€ããŸãã
ãã®ã€ã³ã¹ã¿ã³ã¹ã¯äžå€ã§ããã®ã¡ãœããåŒã³åºãã«ãã£ãŠåœ±é¿ãåããŸããã
resolverFields - ãªãŸã«ãã»ãã£ãŒã«ãã®æ°ããã»ããããã£ãŒã«ãããªãå Žåã¯nullpublic String format(TemporalAccessor temporal)
ããã¯ããã©ãŒããã¿ã®ã«ãŒã«ã䜿çšããŠãæ¥ä»/æéãStringã«æžåŒèšå®ããŸãã
temporal - æžåŒèšå®ããæéçãªããžã§ã¯ããnull以å€DateTimeException - æžåŒèšå®äžã«ãšã©ãŒãçºçããå Žåpublic void formatTo(TemporalAccessor temporal, Appendable appendable)
Appendableã«æžåŒèšå®ããŸãã
ããã¯ãæžåŒèšå®ãããæ¥ä»/æéããæå®ãããåºåå
ã«åºåããŸãã Appendableã¯ããã¹ãŠã®äž»èŠãªæååºåã¯ã©ã¹(StringBufferãStringBuilderãPrintStreamãWriterãªã©)ã«ãã£ãŠå®è£
ãããæ±çšã€ã³ã¿ãã§ãŒã¹ã§ãã
Appendableã®ã¡ãœããã¯IOExceptionãã¹ããŒããŸããããã®ã¡ãœããã¯ã¹ããŒããŸããã ãããã«ãIOExceptionã¯ãã¹ãŠå®è¡æäŸå€ã«ã©ãããããŸãã
temporal - æžåŒèšå®ããæéçãªããžã§ã¯ããnull以å€appendable - æžåŒèšå®åŸã®Appendableãnull以å€DateTimeException - æžåŒèšå®äžã«ãšã©ãŒãçºçããå Žåpublic TemporalAccessor parse(CharSequence text)
ããã¯ããã¹ããå®å
šã«è§£æããŠãæéçãªããžã§ã¯ããçæããŸãã éåžžã¯ãparse(CharSequence, TemporalQuery)ã䜿çšããã»ãã䟿å©ã§ãã ãã®ã¡ãœããã®çµæã¯ã解決ãããTemporalAccessorã§ããæå¹ãªæ¥ä»/æéãä¿èšŒããããã«åºæ¬çãªæ€èšŒãã§ãã¯ãé©çšãããŠããŸãã
ããã¹ãã®é·ãå šäœãèªã¿åãããšãªãè§£æãå®äºããå Žåããè§£æäžãŸãã¯ããŒãžäžã«åé¡ãçºçããå Žåã¯ãäŸå€ãã¹ããŒãããŸãã
text - è§£æããããã¹ããnull以å€DateTimeParseException - èŠæ±ãããçµæãè§£æã§ããªãå Žåpublic TemporalAccessor parse(CharSequence text, ParsePosition position)
ããã¯ããã¹ããè§£æããŸãããæååã®å
é ããè§£æãéå§ããããæ«å°Ÿã§çµäºãããããå¿
èŠã¯ãããŸããã ãã®ã¡ãœããã®çµæã¯ã解決ãããTemporalAccessorã§ããæå¹ãªæ¥ä»/æéãä¿èšŒããããã«åºæ¬çãªæ€èšŒãã§ãã¯ãé©çšãããŠããŸãã
ããã¹ãã¯ãæå®ãããéå§äœçœ®ParsePositionããè§£æãããŸãã ããã¹ãã®é·ãå
šäœãè§£æããå¿
èŠã¯ãªããParsePositionã¯è§£æã®çµäºäœçœ®ã®ã€ã³ããã¯ã¹ã§æŽæ°ãããŸãã
ãã®ã¡ãœããã®åŠçã¯ãParsePositionãjava.text.Formatã«å¯ŸããŠäœ¿çšããé¡äŒŒã®ã¡ãœãããšã¯å€å°ç°ãªããŸãã ãã®ã¯ã©ã¹ã¯ãParsePositionã®ãšã©ãŒã»ã€ã³ããã¯ã¹ã䜿çšããŠãšã©ãŒãè¿ããŸãã äžæ¹ããã®ã¡ãœããã¯ãšã©ãŒãçºçãããšDateTimeParseExceptionãã¹ããŒãããã®äŸå€ã«ãšã©ãŒã»ã€ã³ããã¯ã¹ãå«ããŸãã æ¥ä»/æéã®è§£æãšè§£æ±ºããã®APIã§ã¯ããè€éã«ãªã£ãããããã®åäœå€æŽãå¿
èŠã«ãªããŸããã
ãã©ãŒããã¿ãåããã£ãŒã«ããè€æ°åè§£æããå€ãç°ãªã£ãŠããå Žåãçµæã¯ãšã©ãŒã«ãªããŸãã
text - è§£æããããã¹ããnull以å€position - è§£æãéå§ããäœçœ®ãè§£æãããé·ãã§æŽæ°ããããšã©ãŒãããã°ãã®ã€ã³ããã¯ã¹ã§æŽæ°ãããŸããnull以å€DateTimeParseException - èŠæ±ãããçµæãè§£æã§ããªãå ŽåIndexOutOfBoundsException - äœçœ®ãç¡å¹ãªå Žåpublic <T> T parse(CharSequence text, TemporalQuery<T> query)
ã»ãšãã©ã®ã¢ããªã±ãŒã·ã§ã³ã§ã¯ãè§£æã«ãã®ã¡ãœããã䜿çšããããã«ããŠãã ããã ããã¯ããã¹ããå®å
šãè§£æããŠãèŠæ±ãããæ¥ä»/æéãçæããŸãã éåžžãååããã¯from(TemporalAccessor)ã¡ãœãããžã®ã¡ãœããåç
§ã§ãã ããšãã°ã
LocalDateTime dt = parser.parse(str, LocalDateTime::from);ããã¹ãã®é·ãå šäœãèªã¿åãããšãªãè§£æãå®äºããå Žåããè§£æäžãŸãã¯ããŒãžäžã«åé¡ãçºçããå Žåã¯ãäŸå€ãã¹ããŒãããŸãã
T - è§£æãããæ¥ä»/æéã®åtext - è§£æããããã¹ããnull以å€query - è§£æåŸã®åãå®çŸ©ããååãããnull以å€DateTimeParseException - èŠæ±ãããçµæãè§£æã§ããªãå Žåpublic TemporalAccessor parseBest(CharSequence text, TemporalQuery<?>... queries)
ãã®è§£æã¡ãœããã¯ãããŒãµãŒããªãã·ã§ã³èŠçŽ ãåŠçã§ããå Žåã«äœ¿ããããã¡ãœããã§ãã ããšãã°ããuuuu-MM-dd HH.mm[ VV]ããšãããã¿ãŒã³ã¯ãå®å
šã«è§£æããŠZonedDateTimeã«ããããšããéšåçã«è§£æããŠLocalDateTimeã«ããããšãã§ããŸãã ãã£ãšãäžèŽããå®å
šè§£æãªãã·ã§ã³ããå§ããŠããã£ãšãäžèŽã®å°ãªãæå°è§£æãªãã·ã§ã³ãŸã§ãååãããé ã«æå®ããå¿
èŠããããŸãã éåžžãååããã¯from(TemporalAccessor)ã¡ãœãããžã®ã¡ãœããåç
§ã§ãã
çµæã¯ãæ£åžžã«è§£æãããæåã®åã«é¢é£ä»ããããŸãã éåžžãã¢ããªã±ãŒã·ã§ã³ã§ã¯instanceofã䜿çšããŠçµæã確èªããŸãã ããšãã°ã
TemporalAccessor dt = parser.parseBest(str, ZonedDateTime::from, LocalDateTime::from);
if (dt instanceof ZonedDateTime) {
...
} else {
...
}
ããã¹ãã®é·ãå
šäœãèªã¿åãããšãªãè§£æãå®äºããå Žåããè§£æäžãŸãã¯ããŒãžäžã«åé¡ãçºçããå Žåã¯ãäŸå€ãã¹ããŒãããŸããtext - è§£æããããã¹ããnull以å€queries - 詊ã¿ãè§£æåŸã®åãå®çŸ©ããååãããTemporalAccessorãå®è£
ããå¿
èŠããããŸããnull以å€IllegalArgumentException - 2ã€æªæºã®åãæå®ãããå ŽåDateTimeParseException - èŠæ±ãããçµæãè§£æã§ããªãå Žåpublic TemporalAccessor parseUnresolved(CharSequence text, ParsePosition position)
è§£æã¯2段éã®åŠçãšããŠå®è£
ãããŠããŸãã ãŸãããã©ãŒããã¿ã§å®çŸ©ãããã¬ã€ã¢ãŠãã䜿çšããŠããã¹ããè§£æããããã£ãŒã«ãããå€ãžã®MapãZoneIdãããã³ChronologyãçæãããŸãã æ¬¡ã«ãããŸããŸãªãã£ãŒã«ãã®æ€èšŒãçµåãç°¡çŽ åãè¡ã£ãŠããæçšãªãã£ãŒã«ããåŸãããšã«ãããè§£æãããããŒã¿ã解決ãããŸãã ãã®ã¡ãœããã¯è§£æãã§ãŒãºãå®è¡ããŸããã解決ãã§ãŒãºã¯å®è¡ããŸããã
ãã®ã¡ãœããã®çµæã¯ãå
¥åã«çŸãããšããã«ããŒã¿ã衚ãTemporalAccessorã§ãã å€ã¯æ€èšŒãããªããããã2012-00-65ããšããæ¥ä»æååãè§£æãããšã3ã€ã®ãã£ãŒã«ããæã€æéçãªããžã§ã¯ããåŸããã幎ã¯ã2012ããæã¯ã0ãããæã®æ¥ãã¯ã65ãã«ãªããŸãã
ããã¹ãã¯ãæå®ãããéå§äœçœ®ParsePositionããè§£æãããŸãã ããã¹ãã®é·ãå
šäœãè§£æããå¿
èŠã¯ãªããParsePositionã¯è§£æã®çµäºäœçœ®ã®ã€ã³ããã¯ã¹ã§æŽæ°ãããŸãã
ãšã©ãŒã¯ParsePositionã®ãšã©ãŒã»ã€ã³ããã¯ã¹ã»ãã£ãŒã«ãã䜿çšããŠè¿ãããDateTimeParseExceptionã¯äœ¿çšãããŸããã è¿ããããšã©ãŒã»ã€ã³ããã¯ã¹ã¯ããã®ãšã©ãŒã衚ãã€ã³ããã¯ã¹ã«èšå®ãããŸãã åŒåºãå
ã¯ãçµæã䜿çšããåã«ããšã©ãŒããªããã©ããã確èªããå¿
èŠããããŸãã
ãã©ãŒããã¿ãåããã£ãŒã«ããè€æ°åè§£æããå€ãç°ãªã£ãŠããå Žåãçµæã¯ãšã©ãŒã«ãªããŸãã
ãã®ã¡ãœããã¯ãè§£æäžã«å
éšç¶æ
ã«ã¢ã¯ã»ã¹ããå¿
èŠã®ããé«åºŠãªãŠãŒã¹ã»ã±ãŒã¹åãã§ãã éåžžãã¢ããªã±ãŒã·ã§ã³ã»ã³ãŒãã§ã¯ãparse(CharSequence, TemporalQuery)ã䜿çšããããã¿ãŒã²ããã®åã«å¯ŸããŠãã®è§£æã¡ãœããã䜿çšããããã«ããŠãã ããã
text - è§£æããããã¹ããnull以å€position - è§£æãéå§ããäœçœ®ãè§£æãããé·ãã§æŽæ°ããããšã©ãŒãããã°ãã®ã€ã³ããã¯ã¹ã§æŽæ°ãããŸããnull以å€DateTimeException - è§£æäžã«ãªãããã®åé¡ãçºçããå ŽåIndexOutOfBoundsException - äœçœ®ãç¡å¹ãªå Žåpublic Format toFormat()
java.text.Formatã€ã³ã¹ã¿ã³ã¹ãšããŠè¿ããŸãã
è¿ãããFormatã€ã³ã¹ã¿ã³ã¹ã¯ãä»»æã®TemporalAccessorãæžåŒèšå®ãã解決æžã®TemporalAccessorã«è§£æãããŸãã
äŸå€ã¯Formatã®å®çŸ©ã«åŸããŸããæžåŒèšå®æã®IllegalArgumentExceptionãããã³è§£ææã®ParseExceptionãŸãã¯nullã®è©³çްã«ã€ããŠã¯ããããã®ã¡ãœãããåç
§ããŠãã ããã æžåŒèšå®ã§ã¯ãè¿ãããæžåŒèšå®æååã®å±æ§èšå®ã¯ãµããŒããããŸããã
public Format toFormat(TemporalQuery<?> parseQuery)
java.text.Formatã€ã³ã¹ã¿ã³ã¹ãšããŠè¿ããŸãã
è¿ãããFormatã€ã³ã¹ã¿ã³ã¹ã¯ãä»»æã®TemporalAccessorãæžåŒèšå®ããæå®ãããåã«è§£æãããŸãã åã¯ãparse(java.lang.CharSequence)ã§ãµããŒããããŠãããã®ã§ãªããã°ãªããŸããã
äŸå€ã¯Formatã®å®çŸ©ã«åŸããŸããæžåŒèšå®æã®IllegalArgumentExceptionãããã³è§£ææã®ParseExceptionãŸãã¯nullã®è©³çްã«ã€ããŠã¯ããããã®ã¡ãœãããåç
§ããŠãã ããã æžåŒèšå®ã§ã¯ãè¿ãããæžåŒèšå®æååã®å±æ§èšå®ã¯ãµããŒããããŸããã
parseQuery - è§£æåŸã®åãå®çŸ©ããååãããnullä»¥å€ ãã°ãŸãã¯æ©èœãéä¿¡
詳现ãªAPIãªãã¡ã¬ã³ã¹ããã³éçºè
ããã¥ã¡ã³ãã«ã€ããŠã¯ãJava SEã®ããã¥ã¡ã³ããåç
§ããŠãã ããã ãã®ããã¥ã¡ã³ãã«ã¯ãæŠå¿µçãªæŠèŠãçšèªã®å®çŸ©ãåé¿æ¹æ³ãæå¹ãªã³ãŒãäŸãªã©ã®ãéçºè
ã察象ã«ãããã詳现ãªèª¬æãå«ãŸããŠããŸãã
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyãåç
§ããŠãã ããã