JDK Tutorials - Herong's Tutorial Examples - v6.32, by Herong Yang
java.time.Period Usage Examples
This section provides a tutorial example on how to use the java.time.Period class to capture and apply calendar periods in terms of years, months and days.
To test out the java.time.Period class, I wrote the following example program, PeriodTest.java:
/* PeriodTest.java * Copyright (c) HerongYang.com. All Rights Reserved. */ import java.time.Period; import java.time.*; import java.time.temporal.*; class PeriodTest { public static void main(String[] a) { java.io.PrintStream out = System.out; Period p111 = Period.of(1,1,1); out.println("java.time.Period:"); out.println("toString() = " + p111.toString()); out.println("getYears() = " + p111.getYears()); out.println("getMonths() = " + p111.getMonths()); out.println("getDays() = " + p111.getDays()); out.println("get(YEARS) = " + p111.get(java.time.temporal.ChronoUnit.YEARS)); Period p345 = Period.parse("P8Y16M32D"); out.println(); out.println("normalized() Method:"); out.println("Before = " + p345.toString()); out.println("After = " + p345.normalized().toString()); LocalDate leap = LocalDate.parse("2012-02-29"); Period year1d = Period.of(1,0,-1); Temporal later = year1d.addTo(leap); out.println(); out.println("addTo() Method:"); out.println("Leap day = " + leap.toString()); out.println("1 year minus 1 day = " + year1d.toString()); out.println("Adds together = " + later.toString()); Period p1d = Period.of(0,0,1); out.println(); out.println("Daylight saving time change test 1:"); ZonedDateTime time1 = ZonedDateTime.parse( "2014-03-08T02:45:00.000-05:00[America/Montreal]"); out.println("Time 1 before p1d.addTo() = " + time1.toString()); time1 = (ZonedDateTime) p1d.addTo(time1); out.println("Time 1 after p1d.addTo() = " + time1.toString()); out.println(); out.println("Daylight saving time change test 2:"); ZonedDateTime time2 = ZonedDateTime.parse( "2014-03-08T03:05:00.000-05:00[America/Montreal]"); out.println("Time 2 before p1d.addTo() = " + time2.toString()); time2 = (ZonedDateTime) p1d.addTo(time2); out.println("Time 2 after p1d.addTo() = " + time2.toString()); } }
When running PeriodTest.java, I got the following output:
herong> java PeriodTest.java java.time.Period: toString() = P1Y1M1D getYears() = 1 getMonths() = 1 getDays() = 1 get(YEARS) = 1 normalized() Method: Before = P8Y16M32D After = P9Y4M32D addTo() Method: Leap day = 2012-02-29 1 year minus 1 day = P1Y-1D Adds together = 2013-02-27 Daylight saving time change test 1: Time 1 before p1d.addTo() = 2014-03-08T02:45-05:00[America/Montreal] Time 1 after p1d.addTo() = 2014-03-09T03:45-04:00[America/Montreal] Daylight saving time change test 2: Time 2 before p1d.addTo() = 2014-03-08T03:05-05:00[America/Montreal] Time 2 after p1d.addTo() = 2014-03-09T03:05-04:00[America/Montreal]
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