What is TimeUnit.toSeconds in Java?

Overview

The TimeUnit is an enumshort for enumeration that deals with different units of time and operations related to it.

For example, it has different units of time, like:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • MINUTES
  • HOURS
  • DAYS

The toSeconds() method of the TimeUnit converts the time represented by the TimeUnit object to seconds since midnight UTC on January 1, 1970.

How to import the TimeUnit enum

The TimeUnit enum is defined in the java.util.concurrent package. Use the import statement below to import the TimeUnit enum:


import java.util.concurrent.TimeUnit;

Syntax


public long toSeconds(long duration)

Parameters

  • long duration: the duration to be converted to seconds.

The duration parameter value relies on the unit of time chosen for the time unit object.


##.

Return value

The method returns the converted duration to seconds or Long.MIN_VALUE if the conversion overflows negatively or Long.MAX_VALUE if it overflows positively.

Code

In the code below, we get the current time in milliseconds using the Calendar class.

Next, we create a TimeUnit object with the help of the MILLISECONDS, a time unit representing one-thousandth of a second.

We pass the current time in milliseconds to the toSeconds method of the TimeUnit object created to get the time in seconds.

import java.util.Calendar;
import java.util.concurrent.TimeUnit;
class Main {
public static void main(String[] args) {
Calendar calendar = Calendar.getInstance();
long currentTimeMilliseconds = calendar.getTimeInMillis();
TimeUnit time = TimeUnit.MILLISECONDS;
System.out.println("The time " + currentTimeMilliseconds + " milliSeconds in Seconds = " + time.toSeconds(currentTimeMilliseconds));
}
}