Saturday, June 13, 2026
HomeLanguagesJavaZonedDateTime truncatedTo() method in Java with Examples

ZonedDateTime truncatedTo() method in Java with Examples

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]

Reference: https://docs.oracle.com/javase/10/docs/api/java/time/ZonedDateTime.html#withZoneSameInstant(java.time.ZoneId)

RELATED ARTICLES

1 COMMENT

Most Popular

Dominic
32515 POSTS0 COMMENTS
Milvus
131 POSTS0 COMMENTS
Nango Kala
6897 POSTS0 COMMENTS
Nicole Veronica
12013 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12109 POSTS0 COMMENTS
Shaida Kate Naidoo
7019 POSTS0 COMMENTS
Ted Musemwa
7262 POSTS0 COMMENTS
Thapelo Manthata
6976 POSTS0 COMMENTS
Umr Jansen
6964 POSTS0 COMMENTS