public interface Chronology extends Comparable<Chronology>
ã¡ã€ã³ã®æ¥ä»ãšæéAPIã¯ISOæŠäœç³»ã«åºã¥ããŠæ§ç¯ãããŠããŸãã æŠ(chronology)ã¯èåŸã§åäœããæŠäœç³»ã®äžè¬æŠå¿µã衚ããŸãã ããšãã°ãåæŠãæ°åœæŠãã¿ã€ä»æŠãªã©ã§ãã
ãã®ä»ã®å€§åã®æŠäœç³»ã¯ãå°çã倪éœã®åšããåããæãå°çã®åšããåããµã€ã¯ã«ã«çµã³ä»ããããã幎ãæãæ¥ã®å
±éã®æŠå¿µã§ãéçšãããŠããŸãã ãããã®å
±éã®æŠå¿µã¯ãChronoFieldã§å®çŸ©ããããã¹ãŠã®Chronologyã®å®è£
ã§äœ¿çšã§ããŸãã
LocalDate isoDate = ... ThaiBuddhistDate thaiDate = ... int isoYear = isoDate.get(ChronoField.YEAR); int thaiYear = thaiDate.get(ChronoField.YEAR);ããã«ç€ºãããã«ãæ¥ä»ãªããžã§ã¯ãã¯ç°ãªãæŠäœç³»ã«ãããç°ãªã
Chronologyã€ã³ã¹ã¿ã³ã¹ã«ãã£ãŠè¡šãããŠããŸãããã©ã¡ããChronoFieldã®åã宿°ã䜿çšããŠãåãåãããããšãã§ããŸãã ãã®æå³ã®è©³çްã«ã€ããŠã¯ãChronoLocalDateãåç
§ããŠãã ããã äžè¬ã«ãã¢ããã€ã¹ã¯ãChronoLocalDateã§ã¯ãªããæ¢ç¥ã®ISOããŒã¹ã®LocalDateã䜿çšããããšã§ãã
Chronologyãªããžã§ã¯ãã¯äžè¬ã«ChronoFieldã䜿çšããæ¥ä»ã®çŽå
ãçŽå
ã®å¹Žãå¹Žã®æããæã®æ¥ãã¢ãã«ã«åºã¥ããŸãã Chronologyã€ã³ã¹ã¿ã³ã¹ã¯ããã€æŠãªã©ããŸã£ããç°ãªãçš®é¡ã®æŠäœç³»ã衚ãããšãã§ããŸãã
å®éçãªèгç¹ãããChronologyã€ã³ã¹ã¿ã³ã¹ã¯ãã¡ã¯ããªãšããŠãæ©èœããŸãã of(String)ã¡ãœããã§ã¯ã€ã³ã¹ã¿ã³ã¹ãèå¥åã§æ€çŽ¢ã§ããŸãããofLocale(Locale)ã¡ãœããã§ã¯ãã±ãŒã«ã§æ€çŽ¢ã§ããŸãã
Chronologyã€ã³ã¹ã¿ã³ã¹ã¯ãChronoLocalDateã€ã³ã¹ã¿ã³ã¹ãäœæããããã®äžé£ã®ã¡ãœãããæäŸããŸãã æ¥ä»ã¯ã©ã¹ã¯ãç¹å®ã®æ¥ä»ãæäœããããã«äœ¿çšããŸãã
dateNow()
dateNow(clock)
dateNow(zone)
date(yearProleptic, month, day)
date(era, yearOfEra, month, day)
dateYearDay(yearProleptic, dayOfYear)
dateYearDay(era, yearOfEra, dayOfYear)
date(TemporalAccessor)
ChronologyãChronoLocalDateãããã³Eraã®å®è£
ãæžãå¿
èŠããããŸãã æŠäœç³»ã«åºæã®ããžãã¯ã®å€§åã¯ãChronoLocalDateå®è£
ã«ãããŸãã Chronologyå®è£
ã¯ãã¡ã¯ããªãšããŠæ©èœããŸãã
远å ã®æŠã®æ€åºãèš±å¯ããã«ã¯ãServiceLoaderã䜿çšããŸãã å®è£
ã¯ã©ã¹ãäžèŠ§è¡šç€ºãããã¡ã€ã«ããjava.time.chrono.Chronologyããšããååã§ãMETA-INF/servicesãã£ã¬ã¯ããªã«è¿œå ããå¿
èŠããããŸãã ãµãŒãã¹ã®ããŒãã®è©³çްã«ã€ããŠã¯ãServiceLoaderãåç
§ããŠãã ããã idãŸãã¯calendarTypeã«ããæ€çŽ¢ã§ã¯ãæåã«æŠãæäŸããã·ã¹ãã ãèŠã€ãããæ¬¡ã«æŠãæäŸããã¢ããªã±ãŒã·ã§ã³ãç¶ããŸãã
åæŠã§ã¯ãã·ã¹ãã å ã§äžæã®æŠIDãå®çŸ©ããå¿ èŠããããŸãã æŠãCLDR仿§ã§å®çŸ©ãããæŠäœç³»ã衚ãå Žåãã«ã¬ã³ãã»ã¿ã€ãã¯CLDRã®ã¿ã€ããšã該åœããå ŽåãCLDRã®ããªã¢ã³ãã®é£çµã«ãªããŸãã
| 修食åãšå | ã¡ãœãã | 説æ |
|---|---|---|
int |
compareTo(Chronology other) |
ãã®æŠãå¥ã®æŠãšæ¯èŒããŸãã
|
default ChronoLocalDate |
date(Era era, int yearOfEra, int month, int dayOfMonth) |
çŽå
ãçŽå
幎ãæãããã³ãæã®æ¥ããã£ãŒã«ãããããã®æŠã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
ChronoLocalDate |
date(int prolepticYear, int month, int dayOfMonth) |
å
çºæŠã®å¹Žãæãããã³ãæã®æ¥ããã£ãŒã«ãããããã®æŠã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
ChronoLocalDate |
date(TemporalAccessor temporal) |
å¥ã®æéçãªããžã§ã¯ãããããã®æŠã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
ChronoLocalDate |
dateEpochDay(long epochDay) |
ãšããã¯æ¥ããããã®æŠã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
default ChronoLocalDate |
dateNow() |
ããã©ã«ãã®ã¿ã€ã ãŸãŒã³ã®ã·ã¹ãã ã»ã¯ããã¯ãããã®æŠã®çŸåšã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
default ChronoLocalDate |
dateNow(Clock clock) |
æå®ãããã¯ããã¯ãããã®æŠã®çŸåšã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
default ChronoLocalDate |
dateNow(ZoneId zone) |
æå®ãããã¿ã€ã ãŸãŒã³ã®ã·ã¹ãã ã»ã¯ããã¯ãããã®æŠã®çŸåšã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
default ChronoLocalDate |
dateYearDay(Era era, int yearOfEra, int dayOfYear) |
çŽå
ãçŽå
幎ããå¹Žã®æ¥ããã£ãŒã«ãããããã®æŠã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
ChronoLocalDate |
dateYearDay(int prolepticYear, int dayOfYear) |
å
çºæŠã®å¹Žããã³ãå¹Žã®æ¥ããã£ãŒã«ãããããã®æŠã®ããŒã«ã«æ¥ä»ãååŸããŸãã
|
boolean |
equals(Object obj) |
ãã®æŠãå¥ã®æŠãšçãããã©ããããã§ãã¯ããŸãã
|
Era |
eraOf(int eraValue) |
æ°å€ãããæŠã®çŽå
ãªããžã§ã¯ããäœæããŸãã
|
List<Era> |
eras() |
æŠã®çŽå
ã®ãªã¹ããååŸããŸãã
|
static Chronology |
from(TemporalAccessor temporal) |
æéçãªããžã§ã¯ããã
Chronologyã®ã€ã³ã¹ã¿ã³ã¹ãååŸããŸãã |
static Set<Chronology> |
getAvailableChronologies() |
䜿çšå¯èœãªæŠãè¿ããŸãã
|
String |
getCalendarType() |
æŠäœç³»ã®ã«ã¬ã³ãã»ã¿ã€ããååŸããŸãã
|
default String |
getDisplayName(TextStyle style, Locale locale) |
ãã®æŠã®ããã¹ã衚çŸãååŸããŸãã
|
String |
getId() |
æŠã®IDãååŸããŸãã
|
int |
hashCode() |
ãã®æŠã®ããã·ã¥ã»ã³ãŒãã
|
boolean |
isLeapYear(long prolepticYear) |
æå®ããã幎ãããã幎ã§ãããã©ããããã§ãã¯ããŸãã
|
default ChronoLocalDateTime<? extends ChronoLocalDate> |
localDateTime(TemporalAccessor temporal) |
å¥ã®æéçãªããžã§ã¯ãããããã®æŠã®ããŒã«ã«æ¥ä»/æéãååŸããŸãã
|
static Chronology |
of(String id) |
æŠIDãŸãã¯æŠäœç³»ã¿ã€ããã
Chronologyã®ã€ã³ã¹ã¿ã³ã¹ãååŸããŸãã |
static Chronology |
ofLocale(Locale locale) |
ãã±ãŒã«ãã
Chronologyã®ã€ã³ã¹ã¿ã³ã¹ãååŸããŸãã |
default ChronoPeriod |
period(int years, int months, int days) |
ãã®æŠã®æéã幎ãæããã³æ¥ã«åºã¥ããŠååŸããŸãã
|
int |
prolepticYear(Era era, int yearOfEra) |
çŽå
ãšçŽå
幎ãæå®ããŠå
çºæŠã®å¹Žãèšç®ããŸãã
|
ValueRange |
range(ChronoField field) |
æå®ããããã£ãŒã«ãã®æå¹ãªå€ã®ç¯å²ãååŸããŸãã
|
ChronoLocalDate |
resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle) |
è§£æããã
ChronoFieldã®å€ãè§£ææã®æ¥ä»ã«è§£æ±ºããŸãã |
String |
toString() |
ãã®æŠã
StringãšããŠåºåããŸãã |
default ChronoZonedDateTime<? extends ChronoLocalDate> |
zonedDateTime(Instant instant, ZoneId zone) |
Instantãããã®æŠã§ChronoZonedDateTimeãååŸããŸãã |
default ChronoZonedDateTime<? extends ChronoLocalDate> |
zonedDateTime(TemporalAccessor temporal) |
ããäžæ¹ã®temporal (äžæ)ãªããžã§ã¯ããããã®æŠã§
ChronoZonedDateTimeãååŸããŸãã |
static Chronology from(TemporalAccessor temporal)
Chronologyã®ã€ã³ã¹ã¿ã³ã¹ãååŸããŸãã
ããã¯ãæå®ãããæéçãªããžã§ã¯ãã«åºã¥ããŠæŠãååŸããŸãã TemporalAccessorã¯ä»»æã®æ¥ä»ãšæéæ
å ±ã®ã»ããã衚ãããã®ãã¡ã¯ããªãChronologyã®ã€ã³ã¹ã¿ã³ã¹ã«å€æããŸãã
ãã®å€æã§ã¯ãTemporalQueries.chronology()ã䜿çšããŠæŠãååŸããŸãã æå®ãããæéçãªããžã§ã¯ãã«æŠããªãå ŽåãIsoChronologyãè¿ãããŸãã
ãã®ã¡ãœããã¯é¢æ°åã€ã³ã¿ãã§ãŒã¹TemporalQueryã®ã·ã°ããã£ã«äžèŽãããããã¡ãœããåç
§Chronology::fromãä»ããŠãååããšããŠäœ¿çšã§ããŸãã
temporal - 倿ããæéçãªããžã§ã¯ããnull以å€DateTimeException - Chronologyã«å€æã§ããªãå Žåstatic Chronology ofLocale(Locale locale)
Chronologyã®ã€ã³ã¹ã¿ã³ã¹ãååŸããŸãã
ããã¯ãæå®ããããã±ãŒã«ã«åºã¥ããŠãChronologyãè¿ããäžè¬ã«IsoChronologyãè¿ããŸãã ãã®ä»ã®æŠäœç³»ã¯ããããããã±ãŒã«å
ã§æç€ºçã«éžæãããŠããå Žåã«ã®ã¿è¿ãããŸãã
Localeã¯ã©ã¹ã¯ãã¢ããªã±ãŒã·ã§ã³ã®ããŒã«ã©ã€ãºã«åœ¹ç«ã€å¹
åºãæ
å ±ãžã®ã¢ã¯ã»ã¹ãæäŸããŸãã ããã«ã¯ãè±åœã§äœ¿çšãããŠããè±èªã®å Žåã®ãen-GBããªã©ãèšèªãšãªãŒãžã§ã³ãå«ãŸããŸãã
Localeã¯ã©ã¹ã¯ãæŠäœç³»ã®èå¥ã«äœ¿çšã§ããæ¡åŒµã¡ã«ããºã ããµããŒãããŠããŸãã ãã®ã¡ã«ããºã ã¯ããŒãšå€ã®ãã¢ã®åœ¢åŒã§ãããã§ã®æŠäœç³»ã®ããŒã¯ãcaãã§ãã ããšãã°ããã±ãŒã«ãen-JP-u-ca-japaneseãã¯æ¥æ¬ã§æ¥æ¬ã®æŠäœç³»ã§äœ¿çšãããè±èªã衚ããŸãã
ãã®ã¡ãœããã¯ãLocale.getUnicodeLocaleType(String)ã«ãcaããæž¡ãå Žåãšçããæ¹æ³ã§ãç®çã®æŠäœç³»ãèŠã€ããŸãã ãcaãããŒãååšããªãå ŽåãIsoChronologyãè¿ãããŸãã
ãã®ã¡ãœããã®åäœã¯å€ãCalendar.getInstance(Locale)ã¡ãœãããšç°ãªãããšã«æ³šæããŠãã ããã ãã®ã¡ãœããããth_THãã®ãã±ãŒã«ãåãåã£ãå ŽåãBuddhistCalendarãè¿ããŸãã ããã«å¯Ÿãããã®ã¡ãœããã¯IsoChronologyãè¿ããŸãã ããããã®ã¡ãœããã«ãã±ãŒã«ãth-TH-u-ca-buddhistããæž¡ããšãçµæã¯ã¿ã€ä»æŠã«ãªããããã¿ã€ã®æŠäœç³»ã®ããŒã«ã©ã€ãºã®å Žåã«é²ããæšå¥šãããã¢ãããŒãã§ãã
åæŠäœç³»ã§ãåæ§ã®ããã ãããåçŽãªç¶æ³ãçºçããŸãã 以åã¯æŠã«ã¢ã¯ã»ã¹ããããã«ããã±ãŒã«ãjp_JP_JPãã䜿çšãããŠããŸããã ãã ããã¿ã€ã®ãã±ãŒã«ãšç°ãªãããja_JP_JPãã¯Localeã«ãã£ãŠèªåçã«çŸä»£ã®æšå¥šããã圢åŒã®ãja-JP-u-ca-japaneseãã«å€æãããŸãã ãã®ããããã®ã¡ãœãããšCalendar#getInstance(Locale)ã®åäœã«éãã¯ãããŸããã
locale - æŠäœç³»ãååŸããããã«äœ¿çšãããã±ãŒã«ãnull以å€DateTimeException - ãã±ãŒã«ã§æå®ãããæŠãèŠã€ãããªãã£ãå Žåstatic Chronology of(String id)
Chronologyã®ã€ã³ã¹ã¿ã³ã¹ãååŸããŸãã
ããã¯ãIDãŸãã¯ã¿ã€ãã«åºã¥ããŠæŠãååŸããŸãã chronology IDã¯æŠãäžæã«èå¥ããŸãã calendar system typeã¯CLDR仿§ã§å®çŸ©ãããŸãã
æŠã¯ãã·ã¹ãã ã®æŠãŸãã¯ã¢ããªã±ãŒã·ã§ã³ã«ãã£ãŠãServiceLoaderæ§æããæäŸãããæŠã§ãã
äžéšã®æŠã¯ã«ã¹ã¿ãã€ãºå¯èœã§ãããããIDãŸãã¯ã¿ã€ãã¯äžè¬ã«ããã©ã«ãã®ã«ã¹ã¿ãã€ãºã衚ããŸãã ããšãã°ãã°ã¬ãŽãªãªæŠã§ã¯ããŠãªãŠã¹æŠããè€æ°ã®åæãæ¥ãæå®ã§ããŸãããæ€çŽ¢ã§ã¯ãããã©ã«ãã®åæãæ¥ã®ã¿ãæäŸãããŸãã
id - æŠIDãŸãã¯æŠäœç³»ã®ã¿ã€ããnull以å€DateTimeException - æŠãèŠã€ãããªãå Žåstatic Set<Chronology> getAvailableChronologies()
è¿ãããåChronologyã¯ãã·ã¹ãã ã§äœ¿çšã§ããŸãã äžé£ã®æŠã«ã¯ãã·ã¹ãã ã®æŠããã³ã¢ããªã±ãŒã·ã§ã³ã«ãã£ãŠãServiceLoaderæ§æããæäŸãããæŠãå«ãŸããŸãã
String getId()
ãã®IDã¯Chronologyãäžæã«èå¥ããŸãã ããã¯ãof(String)ã䜿çšããŠãChronologyãæ€çŽ¢ããããã«äœ¿çšã§ããŸãã
getCalendarType()String getCalendarType()
ã«ã¬ã³ãã»ã¿ã€ãã¯CLDRãšUnicode Locale Data Markup Language (LDML)ã®ä»æ§ã«ãã£ãŠå®çŸ©ãããèå¥åã§ãæŠãäžæã«èå¥ããŸãã getCalendarTypeã¯ãCLDRã«ã¬ã³ãã»ã¿ã€ããšããªã¢ã³ãã®é£çµã§ã該åœããå Žåãããªã¢ã³ããã-ãã§åºåãããŠè¿œå ãããŸãã ã«ã¬ã³ãã»ã¿ã€ãã¯ãof(String)ã䜿çšããŠãChronologyãæ€çŽ¢ããããã«äœ¿çšãããŸãã
getId()default ChronoLocalDate date(Era era, int yearOfEra, int month, int dayOfMonth)
date(int, int, int)ãåŒã³åºãåã«ãçŽå
ãšçŽå
ã®å¹Žãå
çºæŠã®å¹Žã«çµã¿åãããŸããera - æŠã®æ£ããã¿ã€ãã®çŽå
ãnull以å€yearOfEra - æŠã®çŽå
ã®å¹Žmonth - æŠã®å¹Žã®ædayOfMonth - æŠã®ãæã®æ¥ãDateTimeException - æ¥ä»ãäœæã§ããªãå ŽåClassCastException - eraãæŠã«å¯ŸããŠæ£ããã¿ã€ãã§ãªãå ŽåChronoLocalDate date(int prolepticYear, int month, int dayOfMonth)
prolepticYear - æŠã®å
çºæŠã®å¹Žmonth - æŠã®å¹Žã®ædayOfMonth - æŠã®ãæã®æ¥ãDateTimeException - æ¥ä»ãäœæã§ããªãå Žådefault ChronoLocalDate dateYearDay(Era era, int yearOfEra, int dayOfYear)
dateYearDay(int, int)ãåŒã³åºãåã«ãçŽå
ãšçŽå
ã®å¹Žãå
çºæŠã®å¹Žã«çµã¿åãããŸããera - æŠã®æ£ããã¿ã€ãã®çŽå
ãnull以å€yearOfEra - æŠã®çŽå
ã®å¹ŽdayOfYear - æŠã®å¹Žã®æDateTimeException - æ¥ä»ãäœæã§ããªãå ŽåClassCastException - eraãæŠã«å¯ŸããŠæ£ããã¿ã€ãã§ãªãå ŽåChronoLocalDate dateYearDay(int prolepticYear, int dayOfYear)
prolepticYear - æŠã®å
çºæŠã®å¹ŽdayOfYear - æŠã®å¹Žã®æDateTimeException - æ¥ä»ãäœæã§ããªãå ŽåChronoLocalDate dateEpochDay(long epochDay)
EPOCH_DAYã®å®çŸ©ã¯ããã¹ãŠã®æŠäœç³»ã§åãã§ããããã倿ã§äœ¿çšã§ããŸãã
epochDay - ãšããã¯æ¥DateTimeException - æ¥ä»ãäœæã§ããªãå Žådefault ChronoLocalDate dateNow()
ããã¯ãããã©ã«ãã®ã¿ã€ã ãŸãŒã³ã®system clockãåãåãããçŸåšã®æ¥ä»ãååŸããŸãã
ãã®ã¡ãœããã䜿çšãããšãã¯ããã¯ãããŒãã³ãŒããããŠããããããã¹ãã«ä»£æ¿ã®ã¯ããã¯ã䜿çšã§ããªãããã«ããŸãã
dateNow(Clock)ãåŒã³åºããŸããDateTimeException - æ¥ä»ãäœæã§ããªãå Žådefault ChronoLocalDate dateNow(ZoneId zone)
ããã¯system clockãåãåãããŠãçŸåšã®æ¥ä»ãååŸããŸãã ã¿ã€ã ãŸãŒã³ãæå®ãããšãããã©ã«ãã®ã¿ã€ã ãŸãŒã³ãžã®äŸåãé¿ããããŸãã
ãã®ã¡ãœããã䜿çšãããšãã¯ããã¯ãããŒãã³ãŒããããŠããããããã¹ãã«ä»£æ¿ã®ã¯ããã¯ã䜿çšã§ããªãããã«ããŸãã
dateNow(Clock)ãåŒã³åºããŸããzone - 䜿çšãããŸãŒã³IDãnull以å€DateTimeException - æ¥ä»ãäœæã§ããªãå Žådefault ChronoLocalDate dateNow(Clock clock)
ããã¯æå®ãããã¯ããã¯ãåãåãããçŸåšã®æ¥ä»(仿¥)ãååŸããŸãã ãã®ã¡ãœããã䜿çšãããšããã¹ãã«ä»£æ¿ã®ã¯ããã¯ã䜿çšã§ããŸãã 代æ¿ã®ã¯ããã¯ã¯dependency injectionã䜿çšããŠå°å
¥ã§ããŸãã
date(TemporalAccessor)ãåŒã³åºããŸããclock - 䜿çšããã¯ããã¯ãnull以å€DateTimeException - æ¥ä»ãäœæã§ããªãå ŽåChronoLocalDate date(TemporalAccessor temporal)
ããã¯ãæå®ãããæéçãªããžã§ã¯ãã«åºã¥ããŠãã®æŠã§ã®æ¥ä»ãååŸããŸãã TemporalAccessorã¯ä»»æã®æ¥ä»ãšæéæ
å ±ã®ã»ããã衚ãããã®ãã¡ã¯ããªãChronoLocalDateã®ã€ã³ã¹ã¿ã³ã¹ã«å€æããŸãã
倿ã§ã¯äžè¬ã«ãæŠäœç³»å
šäœã§æšæºåãããEPOCH_DAYãã£ãŒã«ãã䜿çšããŸãã
ãã®ã¡ãœããã¯é¢æ°åã€ã³ã¿ãã§ãŒã¹TemporalQueryã®ã·ã°ããã£ã«äžèŽãããããã¡ãœããåç
§aChronology::dateãä»ããŠãååããšããŠäœ¿çšã§ããŸãã
temporal - 倿ããäžæãªããžã§ã¯ããnull以å€DateTimeException - æ¥ä»ãäœæã§ããªãå ŽåChronoLocalDate.from(TemporalAccessor)default ChronoLocalDateTime<? extends ChronoLocalDate> localDateTime(TemporalAccessor temporal)
ããã¯ãæå®ãããæéçãªããžã§ã¯ãã«åºã¥ããŠãã®æŠã§ã®æ¥ä»/æéãååŸããŸãã TemporalAccessorã¯ä»»æã®æ¥ä»ãšæéæ
å ±ã®ã»ããã衚ãããã®ãã¡ã¯ããªãChronoLocalDateTimeã®ã€ã³ã¹ã¿ã³ã¹ã«å€æããŸãã
倿ã§ã¯ãæéçãªããžã§ã¯ãããChronoLocalDateãšLocalTimeãæœåºããçµã¿åãããŸãã å®è£
ã§ã¯ãé¢é£ãªããžã§ã¯ããšåçã®ãããã®ãã£ãŒã«ãã«ã¢ã¯ã»ã¹ãããªã©ã®æé©åãå®è¡ããããšãèš±å¯ãããŸãã çµæã§ã¯ãã®æŠã䜿çšããŸãã
ãã®ã¡ãœããã¯é¢æ°åã€ã³ã¿ãã§ãŒã¹TemporalQueryã®ã·ã°ããã£ã«äžèŽãããããã¡ãœããåç
§aChronology::localDateTimeãä»ããŠãååããšããŠäœ¿çšã§ããŸãã
temporal - 倿ããäžæãªããžã§ã¯ããnull以å€DateTimeException - æ¥ä»/æéãäœæã§ããªãå ŽåChronoLocalDateTime.from(TemporalAccessor)default ChronoZonedDateTime<? extends ChronoLocalDate> zonedDateTime(TemporalAccessor temporal)
ChronoZonedDateTimeãååŸããŸãã
ããã¯ãæå®ãããæéçãªããžã§ã¯ãã«åºã¥ããŠãã®æŠã§ã®ãŸãŒã³ä»ãã®æ¥ä»/æéãååŸããŸãã TemporalAccessorã¯ä»»æã®æ¥ä»ãšæéæ
å ±ã®ã»ããã衚ãããã®ãã¡ã¯ããªãChronoZonedDateTimeã®ã€ã³ã¹ã¿ã³ã¹ã«å€æããŸãã
倿ã§ã¯ããŸãæéçãªããžã§ã¯ãããZoneIdãååŸããå¿
èŠã«å¿ããŠãZoneOffsetã䜿çšããŸãã æ¬¡ã«ãInstantãååŸããããšããå¿
èŠã«å¿ããŠãChronoLocalDateTimeã䜿çšããŸãã çµæã¯ZoneIdãŸãã¯ZoneOffsetãšInstantãŸãã¯ChronoLocalDateTimeã®ããããã®çµã¿åããã§ãã å®è£
ã§ã¯ãé¢é£ãªããžã§ã¯ããšåçã®ãããã®ãã£ãŒã«ãã«ã¢ã¯ã»ã¹ãããªã©ã®æé©åãå®è¡ããããšãèš±å¯ãããŸãã çµæã§ã¯ãã®æŠã䜿çšããŸãã
ãã®ã¡ãœããã¯é¢æ°åã€ã³ã¿ãã§ãŒã¹TemporalQueryã®ã·ã°ããã£ã«äžèŽãããããã¡ãœããåç
§aChronology::zonedDateTimeãä»ããŠãååããšããŠäœ¿çšã§ããŸãã
temporal - 倿ããäžæãªããžã§ã¯ããnull以å€DateTimeException - æ¥ä»/æéãäœæã§ããªãå ŽåChronoZonedDateTime.from(TemporalAccessor)default ChronoZonedDateTime<? extends ChronoLocalDate> zonedDateTime(Instant instant, ZoneId zone)
Instantãããã®æŠã§ChronoZonedDateTimeãååŸããŸãã
ããã¯ãæå®ãããåãã€ã³ã¹ã¿ã³ãã§ããŸãŒã³ä»ãã®æ¥ä»/æéãååŸããŸãã
instant - æ¥ä»/æéã®äœæå
ã®ã€ã³ã¹ã¿ã³ããnull以å€zone - ã¿ã€ã ãŸãŒã³ãnull以å€DateTimeException - çµæããµããŒããããŠããç¯å²ãè¶
ããå Žåboolean isLeapYear(long prolepticYear)
ããã幎ã¯éåžžããé·ã幎ã§ãã æ£ç¢ºãªæå³ã¯ã次ã®å¶çŽã«åŸã£ãŠãæŠã«ãã£ãŠæ±ºå®ãããŸãã
prolepticYear - ãã§ãã¯ããå
çºæŠã®å¹Žãç¯å²ãæ€èšŒãããªãint prolepticYear(Era era, int yearOfEra)
ããã¯çŽå ãšçŽå ã®å¹Žãåäžã®å çºæŠã®å¹Žãã£ãŒã«ãã«çµã¿åãããŸãã
JapaneseChronologyãªã©ãæŠã§çŽå
ãé »ç¹ã«äœ¿ãããŠããå ŽåãçŽå
ã®å¹ŽãçŽå
ã«ç
§ãããŠæ€èšŒãããŸãã ä»ã®æŠã®å Žåãæ€èšŒã¯ãªãã·ã§ã³ã§ãã
era - æŠã®æ£ããã¿ã€ãã®çŽå
ãnull以å€yearOfEra - æŠã®çŽå
ã®å¹ŽDateTimeException - 幎ããã®çŽå
ã«ç¡å¹ã§ããå Žåãªã©ãå
çºæŠã®å¹Žã«å€æã§ããªãå ŽåClassCastException - eraãæŠã«å¯ŸããŠæ£ããã¿ã€ãã§ãªãå ŽåEra eraOf(int eraValue)
ãã®çŽå ã¯æŠå¿µäžãæç³»åã®æå€§ã®åºåã§ãã ã»ãšãã©ã®æŠäœç³»ã«ã¯ãæç³»åã2ã€ã®çŽå ã«åå²ãã1ã€ã®ãšããã¯ããããŸãã ãã ããäžéšã«ã¯åæå°è ã®çµ±æ²»æéã«1ã€ãã€ãªã©ãè€æ°ã®çŽå ããããŸãã æ£ç¢ºãªæå³ã¯ã次ã®å¶çŽã«åŸã£ãŠãæŠã«ãã£ãŠæ±ºå®ãããŸãã
1970-01-01ã§äœ¿çšããçŽå ã¯å€ã1ã§ããå¿ èŠããããŸãã 以éã®çŽå ã¯ãå€ãé ã«å€§ãããªãå¿ èŠããããŸãã 以åã®çŽå ã¯ãå€ãé ã«å°ãããªãå¿ èŠããããŸãã åæŠã¯åæãŸãã¯é¡äŒŒã®ã·ã³ã°ã«ãã³ãåç §ããŠãçŽå ã®å€ãæäŸããå¿ èŠããããŸãã
ãã®ã¡ãœããã¯ãæå®ãããçŽå ã®å€ã«å¯ŸããŠãæ£ããã¿ã€ãã®ã·ã³ã°ã«ãã³ã®çŽå ãè¿ããŸãã
eraValue - çŽå
ã®å€DateTimeException - çŽå
ãäœæã§ããªãå ŽåList<Era> eras()
ã»ãšãã©ã®æŠäœç³»ã«ã¯ããã®äžã§å¹Žãæå³ãæã€çŽå ããããŸãã æŠäœç³»ãçŽå ã®æŠå¿µããµããŒãããŠããªãå Žåã空ã®ãªã¹ããè¿ãå¿ èŠããããŸãã
ValueRange range(ChronoField field)
ãã¹ãŠã®ãã£ãŒã«ãã¯longæŽæ°ã§è¡šçŸã§ããŸãã ãã®ã¡ãœããã¯ããã®å€ã®æå¹ç¯å²ãèšè¿°ãããªããžã§ã¯ããè¿ããŸãã
çµæã¯æå¹ãªæå°å€ãšæå€§å€ãèšè¿°ããŠããã ããªã®ã§ãããããæ·±ãè§£éããããªãããšãéèŠã§ãã ããšãã°ãç¯å²å ã®å€ã§ãã£ãŠãããã£ãŒã«ãã«å¯ŸããŠç¡å¹ãªå ŽåããããŸãã
ãã®ã¡ãœããã¯ãæŠã§ãã£ãŒã«ãããµããŒãããŠãããã©ããã«é¢ä¿ãªããçµæãè¿ããŸãã
field - ç¯å²ãååŸãããã£ãŒã«ããnull以å€DateTimeException - ãã£ãŒã«ãã®ç¯å²ãååŸã§ããªãå Žådefault String getDisplayName(TextStyle style, Locale locale)
ããã¯ãæŠã®èå¥ã«äœ¿çšããããŠãŒã¶ãŒãžã®è¡šç€ºã«é©ããããã¹ãã®ååãè¿ããŸãã ãã©ã¡ãŒã¿ã¯è¿ãããããã¹ããšãã±ãŒã«ã®ã¹ã¿ã€ã«ãå¶åŸ¡ããŸãã
style - å¿
èŠãªããã¹ãã®ã¹ã¿ã€ã«ãnull以å€locale - 䜿çšãããã±ãŒã«ãnull以å€ChronoLocalDate resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)
ChronoFieldã®å€ãè§£ææã®æ¥ä»ã«è§£æ±ºããŸãã
ã»ãšãã©ã®TemporalFieldå®è£
ã¯ããã£ãŒã«ãäžã®è§£æ±ºã¡ãœããã䜿çšããŠè§£æ±ºãããŸãã ããã«å¯ŸããChronoFieldã¯ã©ã¹ã¯æŠã«é¢é£ããæå³ã®ã¿ãæã€ãã£ãŒã«ããå®çŸ©ããŸãã ãã®ãããChronoFieldæ¥ä»ãã£ãŒã«ãã¯ãããã§ç¹å®ã®æŠã®ã³ã³ããã¹ãã§è§£æ±ºãããŸãã
äžè¬çãªè§£æ±ºåäœã説æããããã©ã«ãã®å®è£
ã¯ãAbstractChronologyã«æäŸãããŠããŸãã
fieldValues - ãã£ãŒã«ããšå€ã®ããããæŽæ°å¯èœãnull以å€resolverStyle - èŠæ±ããã解決ã®ã¿ã€ããnull以å€DateTimeException - äžè¬ã«å
¥åããŒã¿ã®ç«¶åã®ãããæ¥ä»ã解決ã§ããªãå Žådefault ChronoPeriod period(int years, int months, int days)
ããã¯ãæå®ããã幎ãæãæ¥ã䜿çšããŠããã®æŠã«é¢é£ä»ããããæéãè¿ããŸãã æäŸããããã¹ãŠã®æŠã§ã幎ãæãæ¥ã«åºã¥ããŠæéã䜿çšãããŸãããChronoPeriod APIã§ã¯ãä»ã®åäœã䜿çšããŠæéã衚çŸã§ããŸãã
range(ChronoField)ãã1å¹Žã®ææ°ãååŸããŸãã 1å¹Žã®ææ°ãåºå®ã§ããå Žåãå ç®ãæžç®ãæ£èŠåã®èšç®ã¢ãããŒãã¯ããç°ãªããŸãã
幎ãæãããã³æ¥ã«åºã¥ããªãéåžžãšç°ãªãæŠäœç³»ãå®è£
ãããããŸãã¯çŽæ¥å¶åŸ¡ãããå ŽåãChronoPeriodã€ã³ã¿ãã§ãŒã¹ãçŽæ¥å®è£
ããå¿
èŠããããŸãã
è¿ãããæéã¯äžå€ã§ãã¹ã¬ããã»ãŒãã§ããå¿ èŠããããŸãã
years - 幎æ°ãè² ã®å Žåãããmonths - 幎æ°ãè² ã®å Žåãããdays - 幎æ°ãè² ã®å Žåãããint compareTo(Chronology other)
æåã«æŠIDæååãæ¬¡ã«ãµãã¯ã©ã¹ã«åºæã®ä»»æã®è¿œå ã®æ
å ±ã«ããæ¯èŒã®é åºã Comparableã«å®çŸ©ãããŠãããšããã«ããequalsãšäžèŽãããŠããŸãã
Comparable<Chronology>ã®compareToother - ä»ã®æ¯èŒããæŠãnull以å€boolean equals(Object obj)
æ¯èŒã¯ãªããžã§ã¯ãã®å šäœã®ç¶æ ã«åºã¥ããŸãã
equalsãã¯ã©ã¹Objectobj - ãã§ãã¯ãããªããžã§ã¯ããnullã¯falseãè¿ãObject.hashCode()ãHashMapint hashCode()
ããã·ã¥ã»ã³ãŒãã¯ãªããžã§ã¯ãã®å šäœã®ç¶æ ã«åºã¥ãããŠãã ããã
hashCodeãã¯ã©ã¹ObjectObject.equals(java.lang.Object), System.identityHashCode(java.lang.Object) ãã°ãŸãã¯æ©èœãéä¿¡
詳现ãªAPIãªãã¡ã¬ã³ã¹ããã³éçºè
ããã¥ã¡ã³ãã«ã€ããŠã¯ãJava SEã®ããã¥ã¡ã³ããåç
§ããŠãã ããã ãã®ããã¥ã¡ã³ãã«ã¯ãæŠå¿µçãªæŠèŠãçšèªã®å®çŸ©ãåé¿æ¹æ³ãæå¹ãªã³ãŒãäŸãªã©ã®ãéçºè
ã察象ã«ãããã詳现ãªèª¬æãå«ãŸããŠããŸãã
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyãåç
§ããŠãã ããã