Course contentsShow
← Java
Lesson 1828 of 2,87038. Date and Time API (java.time)Free lesson

Creating Instants: now() and ofEpochSecond()

Learn to create Instant objects representing the current moment or a specific epoch timestamp.

Creating Instants: now() and ofEpochSecond()

You'll learn how to create Instant objects for the current moment and specific points in time using epoch timestamps.

The Two Primary Creation Methods

Now that you understand Instant represents a point on the timeline using epoch time, you need ways to actually create these objects. Java provides two fundamental methods:

Instant.now(): Capturing the Current Moment

The now() method creates an Instant representing right now—the exact moment you call it. Think of it like taking a timestamp photograph of the current time.

Instant currentMoment = Instant.now();
System.out.println(currentMoment); // e.g., 2024-03-15T14:30:45.123Z

Every time you call now(), you get a fresh Instant with the current system time. It's perfect for logging events, measuring durations, or recording when something happened.

Instant.ofEpochSecond(): Creating from a Known Timestamp

When you have a specific epoch timestamp (seconds since January 1, 1970 UTC), use ofEpochSecond():

Instant specificMoment = Instant.ofEpochSecond(1700000000L);
System.out.println(specificMoment); // 2023-11-14T22:13:20Z

This is invaluable when working with databases, APIs, or logs that store timestamps as epoch seconds. You're reconstructing the exact moment that number represents.

Nanosecond precision: You can even add nanoseconds as a second argument:

Instant preciseInstant = Instant.ofEpochSecond(1700000000L, 500000000);
// Adds 500 million nanoseconds (0.5 seconds)

When to Use Each

Use now() when you need the current time. Use ofEpochSecond() when you're working with historical timestamps or data from external systems that use epoch time.

Key Takeaway: Instant.now() captures the current moment, while Instant.ofEpochSecond() reconstructs a specific point in time from an epoch timestamp—these are your primary tools for creating Instant objects.