Instant atZone() method in Java with Examples
The atZone(ZoneId zone) method of Instant class is used to combine this instant with a time-zone whose ZoneId is given as parameter to create an ZonedDateTime object. This method takes ZoneId as a parameter and combines the time-zone with this instant after operation returns a ZonedDateTime object. If the instant is too large to fit into a zoned date-time then this method will throw an exception. This method is same as ZonedDateTime.ofInstant(this, zone).
Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready. To complete your preparation from learning a language to DS Algo and many more, please refer Complete Interview Preparation Course.
public ZonedDateTime atZone(ZoneId zone)
Parameters: This method accepts one parameter zone which is the zone to combine to this instant object. It should not be null.
Return Value: This method returns a ZonedDateTime which is the combination of current zone of Instant and the zone passed as the parameter.
Exception: This method throws DateTimeException if the instant is too large to fit into a zoned date-time.
Below programs illustrate the Instant.atZone() method:
Instant: 2018-10-20T16:55:30Z ZonedDateTime: 2018-10-20T18:55:30+02:00[Europe/Paris]
Instant: 2018-11-18T06:55:30Z ZonedDateTime: 2018-11-18T09:55:30+03:00[Asia/Aden]
Instant: 2018-11-22T08:11:48.029Z ZonedDateTime: 2018-11-21T21:11:48.029-11:00[Pacific/Midway]