A Temporal.Instant is an exact point in time, with a precision in
nanoseconds. No time zone or calendar information is present. Therefore,
Temporal.Instant has no concept of days, months, or even hours.
A Temporal.PlainDate represents a calendar date without time or time zone information.
For example, it could be used to represent an event on a calendar which happens during
the whole day no matter which time zone it’s happening in.
The date fields accepted by PlainDate.with(), PlainMonthDay.with() and the
toPlainDate() methods: era/era_year, year, month/month_code and day,
each optional.
The property bag accepted by PlainDate.from(): the PlainDateFields plus
calendar. from() requires year (or era and era_year), month (or month_code) and day.
The property bag accepted by PlainDateTime.from(): the PlainDateTimeFields
plus calendar. from() requires year (or era and era_year), month (or month_code) and day.
Omitted time fields default to zero.
A Temporal.PlainMonthDay represents a particular day on the calendar, but without
a year. For example, it could be used to represent a yearly recurring event, like
“Bastille Day is on the 14th of July.”
The property bag accepted by PlainMonthDay.from(): the PlainDateFields plus
calendar. from() requires day and either month_code, or month together
with year in calendars other than ISO 8601.
A Temporal.PlainYearMonth represents a particular month on the calendar. For example,
it could be used to represent a particular instance of a monthly recurring event, like
“the June 2019 meeting”.
The property bag accepted by PlainYearMonth.from(): the PlainYearMonthFields
plus calendar. from() requires year (or era and era_year) and month
(or month_code).
A Temporal.ZonedDateTime is a timezone-aware, calendar-aware date/time object
that represents a real event that has happened (or will happen) at a particular
exact time from the perspective of a particular region on Earth.
The property bag accepted by ZonedDateTime.from(): the ZonedDateTimeFields
plus calendar and time_zone. from() requires time_zone, year (or era
and era_year), month (or month_code) and day.