java.time.Duration - Time Durations

JDK Tutorials - Herong's Tutorial Examples

∟Java Date-Time API

∟java.time.Duration - Time Durations

This section describes the java.time.Duration class that represents a duration of time measured in seconds with fractions in nanosecond resolution.

When manipulating moments of time, we have to handle time durations that measure amounts of time passed between given moments. The java.time.Duration class in the Date-Time API is designed to help us do this. It represents a duration between two given moments of time. A duration of time is actually represented by a java.time.Duration object with 2 components:

Seconds - Representing the number of whole seconds in this duration.
Nanoseconds-of-Second - Representing the fraction part of a second in this duration.

The java.time.Duration class does not respect any calendar rules or timezone rules.

Main methods offered on the java.time.Duration class are:

ofSeconds() - A static method returning a Duration object representing the duration of time constructed with the given number of seconds and the given number of nanoseconds. Note that there are no constructors in Duration class. So "new Duration()" is not a valid expression.
getSeconds() - An object method returning the second value of this Duration object.
getNano() - An object method returning the Nanosecond-of-Second value of this Duration object.
get() - An object method returning the value of a given temporal field, SECONDS or NANOS from this Duration object.
toString() - An object method returning a string representing this Duration object in ISO 8601 duration format with the second value normalized into hours, minutes and seconds. Here is an example of toString() output, "PT8H6M12.345S".
plus() - An object method returns a copy of this Duration object with a duration expressed Duration object, or units of DAYS, HOURS, MINUTES, SECONDS, MILLIS, MICROS, NONOS etc. added. Note that the plus() cannot be used to construct duration by adding duration in YEARS or MONTHS.
minus() - An object method returns a copy of this Duration object with a duration expressed Duration object, or units of DAYS, HOURS, MINUTES, SECONDS, MILLIS, MICROS, NONOS etc. removed. Note that the minus() cannot be used to construct duration by adding duration in YEARS or MONTHS.
parse() - A static method returning a Duration object representing a duration of time constructed by parsing the given character sequence using the ISO 8601 duration format of "PnDTnHnMn.nS".
between() - A static method returning a Duration object representing the duration of time between two given moments in time.
addTo() - An object method returning a date-time object representing the moment of time constructed by adding this duration to a given moment of time.
subtractFrom() - An object method returning a date-time object representing the moment of time constructed by subtracting this duration from a given moment of time.

Table of Contents

About This JDK Tutorial Book

JDK (Java Development Kit)

►Java Date-Time API

What Is Date-Time API

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

Character Set Encoding Maps

Encoding Conversion Programs for Encoded Text Files

Socket Network Communication

Datagram Network Communication

DOM (Document Object Model) - API for XML Files

SAX (Simple API for XML)

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

SSL Client Authentication

HTTPS (Hypertext Transfer Protocol Secure)

Outdated Tutorials

Full Version in PDF/EPUB