JDK Tutorials - Herong's Tutorial Examples - v6.32, by Herong Yang
java.time.OffsetDateTime Usage Examples
This section provides a tutorial example on how to use the java.time.OffsetDateTime class to record and manipulate date and time local to specific UTC offset. Operations on java.time.OffsetDateTime objects respect ISO 8601 calendar rules. But they do not respect local timezone rules.
To test out the java.time.OffsetDateTime class, I wrote the following example program, OffsetDateTimeTest.java:
/* OffsetDateTimeTest.java * Copyright (c) HerongYang.com. All Rights Reserved. */ import java.time.OffsetDateTime; import java.time.temporal.ChronoField; class OffsetDateTimeTest { public static void main(String[] a) { java.io.PrintStream out = System.out; // OffsetDateTime now = new OffsetDateTime(); // not supported OffsetDateTime now = OffsetDateTime.now(); out.println("Current moment of time:"); out.println("toString() = " + now.toString()); out.println("getYear() = " + now.getYear()); out.println("getMonthValue() = " + now.getMonthValue()); out.println("getDayOfMonth() = " + now.getDayOfMonth()); out.println("getHour() = " + now.getHour()); out.println("getMinute() = " + now.getMinute()); out.println("getSecond() = " + now.getSecond()); out.println("getNano() = " + now.getNano()); out.println("getOffset() = " + now.getOffset()); OffsetDateTime leap = OffsetDateTime.parse("2012-02-29T12:00:00+01:00"); out.println(); out.println("Leap day:"); out.println("toString() = " + leap.toString()); OffsetDateTime nextYear = leap.plusYears(1); out.println("1 year later:"); out.println("toString() = " + nextYear.toString()); OffsetDateTime summer = OffsetDateTime.parse("2014-11-02T01:30:00-04:00"); out.println(); out.println("Summer hour:"); out.println("toString() = " + summer.toString()); OffsetDateTime winter = summer.plusHours(1); out.println("1 hour later:"); out.println("toString() = " + winter.toString()); } }
When running OffsetDateTimeTest.java, I got the following output:
herong> java OffsetDateTimeTest.java Current moment of time: toString() = 2024-02-19T17:02:54.994790-03:00 getYear() = 2024 getMonthValue() = 2 getDayOfMonth() = 19 getHour() = 17 getMinute() = 2 getSecond() = 54 getNano() = 994790000 getOffset() = -03:00 Leap day: toString() = 2012-02-29T12:00+01:00 1 year later: toString() = 2013-02-28T12:00+01:00 Summer hour: toString() = 2014-11-02T01:30-04:00 1 hour later: toString() = 2014-11-02T02:30-04:00
Interesting notes from the output:
Table of Contents
java.time.Instant - Representing a Moment of Time
java.time.Instant Usage Examples
java.time.Instant - get(INSTANT_SECONDS) Error
Converting java.util.Date to java.time.Instant
java.time.ZonedDateTime - Calendar and Timezone
java.time.ZonedDateTime Usage Examples
Converting java.util.GregorianCalendar to java.time.ZonedDateTime
java.time.OffsetDateTime - Calendar and UTC Offset
►java.time.OffsetDateTime Usage Examples
java.time.LocalDateTime - Local Date and time without Timezone
Partial Date and Time Objects and Classes
java.time.format.DateTimeFormatter - Date-Time Strings
java.time.Duration - Time Durations
java.time.Duration Usage Examples
java.time.Period - Periods in Days and Months
java.time.Period Usage Examples
Date, Time and Calendar Classes
Date and Time Object and String Conversion
Number Object and Numeric String Conversion
Locales, Localization Methods and Resource Bundles
Calling and Importing Classes Defined in Unnamed Packages
HashSet, Vector, HashMap and Collection Classes
Character Set Encoding Classes and Methods
Encoding Conversion Programs for Encoded Text Files
Datagram Network Communication
DOM (Document Object Model) - API for XML Files
DTD (Document Type Definition) - XML Validation
XSD (XML Schema Definition) - XML Validation
XSL (Extensible Stylesheet Language)
Message Digest Algorithm Implementations in JDK
Private key and Public Key Pair Generation
PKCS#8/X.509 Private/Public Encoding Standards
Digital Signature Algorithm and Sample Program
"keytool" Commands and "keystore" Files
KeyStore and Certificate Classes
Secret Key Generation and Management
Cipher - Encryption and Decryption
The SSL (Secure Socket Layer) Protocol
SSL Socket Communication Testing Programs