The truncatedTo() method of a ZonedDateTime class is used to return the value of this ZonedDateTime in the specified unit. This method takes a parameter Unit, which is the Unit in which this ZonedDateTime is to be truncated to. It returns a truncated immutable ZonedDateTime with the value in the specified unit.
Syntax:
public ZonedDateTime truncatedTo(TemporalUnit unit)
Parameters: This method accepts one single parameter unit which is the unit in which this ZonedDateTime is to be truncated to. It should not be null.
Return value: This method returns a immutable truncated ZonedDateTime with the value in the specified unit.
Exception: This method throws following Exceptions:
- DateTimeException: if unable to truncate.
- UnsupportedTemporalTypeException: if the unit is not supported.
Below programs illustrate the truncatedTo() method:
Program 1:
// Java program to demonstrate// ZonedDateTime.truncatedTo() method import java.time.*;import java.time.temporal.ChronoUnit; public class GFG { public static void main(String[] args) { // create a ZonedDateTime object ZonedDateTime zonedDT = ZonedDateTime .parse( "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]"); // print ZonedDateTime System.out.println("ZonedDateTime before" + " truncate: " + zonedDT); // truncate to ChronoUnit.HOURS // means unit smaller than Hour // will be Zero ZonedDateTime returnvalue = zonedDT.truncatedTo(ChronoUnit.HOURS); // print result System.out.println("ZonedDateTime after " + " truncate: " + returnvalue); }} |
Output:
ZonedDateTime before truncate: 2018-12-06T19:21:12.123+05:30[Asia/Calcutta] ZonedDateTime after truncate: 2018-12-06T19:00+05:30[Asia/Calcutta]
Program 2:
// Java program to demonstrate// ZonedDateTime.truncatedTo() method import java.time.*;import java.time.temporal.ChronoUnit; public class GFG { public static void main(String[] args) { // create a ZonedDateTime object ZonedDateTime zonedDT = ZonedDateTime .parse( "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]"); // print ZonedDateTime System.out.println("ZonedDateTime before" + " truncate: " + zonedDT); // truncate to ChronoUnit.DAYS // means unit smaller than DAY // will be Zero ZonedDateTime returnvalue = zonedDT.truncatedTo(ChronoUnit.DAYS); // print result System.out.println("ZonedDateTime after " + " truncate: " + returnvalue); }} |
Output:
ZonedDateTime before truncate: 2018-12-06T19:21:12.123+05:30[Asia/Calcutta] ZonedDateTime after truncate: 2018-12-06T00:00+05:30[Asia/Calcutta]
