User guide for the Instant class

The Instant class represents an instant in time.

It is an ideal object for storing time-stamps of log events. For example, the instant of an event such as saving a file to GitHub can be recorded in an Instant.

The time-line of human experience consists of a continuous set of instants. In ThreeTen, these instants can be recorded at nanosecond precision in the Instant class.

Creating an Instant

There are a number of ways to create an Instant.


Creating the current instant is achieved using one of the now methods:

Instant a =;
Instant b =;

The first method (a) obtains the current instant from the system clock, which is a wrapper around System.currentTimeMillis(). The second method (b) uses a Clock object to provide further control over the current instant.

View all articles or the home page

ThreeTen documentation is licensed under a Creative Commons Attribution 4.0 International License.   Creative Commons Licence