javatimeZonedDateTime

javatimeZonedDateTime refers to the Java API class java.time.ZonedDateTime, the date-time with a time-zone datatype in the ISO-8601 calendar system. It combines a LocalDateTime with a ZoneId and represents a specific moment in time within a particular zone, including the zone's offset from UTC. Instances are immutable and thread-safe, making them suitable for use in multi-threaded applications.

Creation and parsing are provided by several factory methods. ZonedDateTime.of(LocalDateTime, ZoneId) constructs a date-time in a given zone, while ZonedDateTime.ofInstant(Instant, ZoneId) creates a date-time for the same instant in the specified zone. A string in ISO-8601 format can be parsed with ZonedDateTime.parse(CharSequence).

Converting to other representations is straightforward: toInstant() returns the exact moment, independent of zone; toLocalDateTime() returns the local date-time component. Formatting is supported via DateTimeFormatter, and the default toString produces an ISO-8601-like representation such as 2007-12-03T10:15:30+01:00[Europe/Paris].

Time-zone rules govern the interpretation of offsets and DST transitions. ZoneId plus ZoneRules determine the offset for a given instant. When a local time falls in a DST gap or overlap, methods such as withEarlierOffsetAtOverlap() and withLaterOffsetAtOverlap() allow disambiguation. The object can also be converted between zones with withZoneSameInstant(ZoneId) and withZoneSameLocal(ZoneId).

Arithmetic and comparison methods come from the Temporal and Comparable interfaces, enabling addition and subtraction of time, and ordering of date-times. Typical uses include scheduling events, calendar calculations, and converting times across regions in server-side applications.