How to Add a Time Zone in the Java 8 Date/Time API

See Java: Tips and Tricks for similar articles.
Looking to improve your Java skills? Check out Webucator’s Java classes.

When working with date and time objects in Java 8 you will probably need to add a time zone sooner or later. A time zone can be expressed as an offset from UTC (Coordinated Universal Time, or the time at the prime meridian running through Greenwich, England), a time zone ID (e.g., "America/New York"), or a time zone name (e.g., EST). In order to add a time zone you will need the ZonedDateTime, the ZoneOffset, or the ZoneId class. Each class is located in the java.time package. To understand how to add a time zone to a date/time object in Java 8, follow these four steps.

  1. Open your text editor and create the Java program that will add time zone expressions to date time objects. Type in the following Java statements:
    import java.time.*;
    import java.time.format.*;
    public class AddTimeZone {
    	public static void main (String args[]) {
    		// Create a date time object with time zone for current date time and default time zone:
    		ZonedDateTime todayWithDefaultTimeZone=ZonedDateTime.now();
    		DateTimeFormatter formatTodayWithZoneOffset=DateTimeFormatter.ofPattern("MM/dd/yy hh:mm:ss Z");
    		System.out.format("Formatted date time with default zone offset is %s\n", todayWithDefaultTimeZone.format(formatTodayWithZoneOffset));
    		DateTimeFormatter formatTodayWithZoneName=DateTimeFormatter.ofPattern("MM/dd/yy hh:mm:ss z");
    		System.out.format("Formatted date time with default zone name is %s\n", todayWithDefaultTimeZone.format(formatTodayWithZoneName));
    		DateTimeFormatter formatTodayWithZoneId=DateTimeFormatter.ofPattern("MM/dd/yy hh:mm:ss VV");
    		System.out.format("Formatted date time with default zone ID is %s\n", todayWithDefaultTimeZone.format(formatTodayWithZoneId));
    		
    		// Create a zoned date time object with current date and time and New York time zone ID:
    		LocalDateTime today=LocalDateTime.now();
    		ZoneId timeZone=ZoneId.of("America/New_York");
    		ZonedDateTime todayWithTimeZone=ZonedDateTime.of(today, timeZone);
    		System.out.format("Formatted date time with zone ID of New York is %s\n", todayWithTimeZone.format(formatTodayWithZoneId));
    		
    		// Create a zoned date time object with current date and time and zone offset UTC -5 hours:
    		LocalDateTime todayZoneOffset=LocalDateTime.now();
    		ZoneId timeZoneOffset=ZoneOffset.of("-0500");
    		ZonedDateTime todayWithTimeZoneOffset=ZonedDateTime.of(todayZoneOffset, timeZoneOffset);
    		System.out.format("Formatted date time with zone offset of UTC -5 hours is %s\n", todayWithTimeZone.format(formatTodayWithZoneOffset));
    	}
    }

    The ZonedDateTime class permits you to create a date/time object with a time zone. The default time zone will be used; i.e., the time zone you have established on your computer. You can use the DateTimeFormatter class to display the time zone. In the Java code, the time zone is displayed as zone offset, zone name and zone ID. Note that the date time formatter pattern is "Z", "z", and "VV", respectively. The program also creates a date/time object and then adds the zone ID using the of method of the ZoneId class. Finally, a time zone is added to another date/time object using the of method of the ZoneOffset class.

  2. Save your file as AddTimeZone.java.
  3. Open a command prompt and navigate to the directory containing your new Java program. Then type in the command to compile the source and hit Enter.Compile Program with Time Zone
  4. You are ready to test your Java program. Type in the command to run the Java runtime launcher and hit Enter. Notice the output shows the formatted values of the various time zone expressions associated with the date and time objects that you created.Run Program with Time Zone

Related Articles

  1. How to Check Object Type in Java
  2. How to Create a Jar File in Java
  3. How to Compile Packages in Java
  4. How to Throw an Exception in Java
  5. How to Create an Exception Class in Java
  6. How to Use the super Keyword to Call a Base Class Constructor in Java
  7. How to Use the Comparator.comparing Method in Java 8
  8. How to Use System.in in Java
  9. How to Call an Interface Method in Java
  10. How to Add a Time Zone in the Java 8 Date/Time API (this article)
  11. How to Rethrow an Exception in Java
  12. How to Use the instanceof Operator with a Generic Class in Java
  13. How to Instantiate an Object in Java
  14. How to Filter Distinct Elements from a Collection in Java 8
  15. How to Create a Derived Class in Java
  16. How to Skip Elements with the Skip Method in Java 8
  17. How to Create a Java Bean
  18. How to Implement an Interface in Java
  19. How to Compare Two Objects with the equals Method in Java
  20. How to Set PATH from JAVA_HOME
  21. How to Prevent Race Conditions in Java 8
  22. How to Write a Block of Code in Java
  23. How to Display the Contents of a Directory in Java
  24. How to Group and Partition Collectors in Java 8
  25. How to Create a Reference to an Object in Java
  26. How to Reduce the Size of the Stream with the Limit Method in Java 8
  27. How to Write an Arithmetic Expression in Java
  28. How to Format Date and Time in the Java 8 Date/Time API
  29. How to Use Comparable and Comparator in Java
  30. How to Break a Loop in Java
  31. How to Use the this Keyword to Call Another Constructor in Java
  32. How to Write a Unit Test in Java
  33. How to Declare Variables in Java
  34. How to Override Base Class Methods with Derived Class Methods in Java
  35. How to Use Serialized Objects in Java
  36. How to Write Comments in Java
  37. How to Implement Functional Interfaces in Java 8
  38. How to Write Type Parameters with Multiple Bounds in Java
  39. How to Add Type and Repeating Annotations to Code in Java 8
  40. How to Use Basic Generics Syntax in Java
  41. How to Map Elements Using the Map Method in Java 8
  42. How to Work with Properties in Java
  43. How to Write while and do while Loops in Java
  44. How to Use the finally Block in Java
  45. How to Write for-each Loops in Java
  46. How to Create a Method in Java
  47. How to Continue a Loop in Java
  48. How to Handle Java Files with Streams
  49. How to Create an Interface Definition in Java
  50. How Default Base Class Constructors Are Used with Inheritance