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]
