Java Programming Tutorials

Java programming tutorials with many code examples!

Java Time Clock Tutorial

The java.time.Clock class provides access to the current instant, date and time using a time-zone. These are the main properties of the class:

  • Use of the Clock class is optional, because all key date-time classes have a now() factory method that uses the system clock in the default time zone.
  • Use Dependency Injection framework to provide Clock implementations.

The class declaration is:

public abstract class Clock
       extends Object

Methods inheritance

Objects of this class inherit methods from the following classes:

  • java.lang.Object

Methods of java.time.Clock:

  • boolean equals(Object obj)
    Checks if this clock is equal to another clock.
  • static Clock fixed(Instant fixedInstant, ZoneId zone)
    This method returns a clock that always returns the same time.
  • abstract ZoneId getZone()
    Gets the time-zone being used to create dates and times.
  • int hashCode()
    A hash code for this clock.
  • abstract Instant instant()
    Gets the current instant of the clock.
  • long millis()
    Gets the current millisecond instant of the clock.
  • static Clock offset(Clock baseClock, Duration offsetDuration)
    Obtains a clock based on the given clock with the duration added.
  • static Clock system(ZoneId zone)
    Returns a clock that returns the current instant using best available system clock in the specified zone.
  • static Clock systemDefaultZone()
    Returns a clock that returns the current instant using the best available system clock, converting to date and time using the default time-zone.
  • static Clock systemUTC()
    Returns a clock that returns the current instant using the best available system clock, converting to date and time using the UTC time-zone.
  • static Clock tick(Clock baseClock, Duration tickDuration)
    Returns a clock that returns instants from the specified clock truncated to the nearest occurrence of the specified duration.
  • static Clock tickMinutes(ZoneId zone)
    Obtains a clock that returns the current instant ticking in whole minutes using best available system clock.
  • static Clock tickSeconds(ZoneId zone)
    Returns a clock that returns the current instant ticking in whole seconds using best available system clock.
  • abstract Clock withZone(ZoneId zone)
    Returns a copy of this clock with a different time-zone.
Share with the World!