Why does java.time.Clock has zone information?

Alternate clock behaviors

Quoting the Clock documentation (emphasis mine):

Use of a Clock is optional. All key date-time classes also have a now() factory method that uses the system clock in the default time zone. The primary purpose of this abstraction is to allow alternate clocks to be plugged in as and when required. Applications use an object to obtain the current time rather than a static method. This can simplify testing.

For example, Clock.fixed( Instant fixedInstant, ZoneId zone ) always reports the current moment as a specific moment, a fixed (non-changing) point in time.


I suppose it takes a bit of mind reading or guessing to answer your question, but let me try anyway. As far as I can see, the Clock knowing a time zone is very convenient when using any of the now methods taking a Clock argument. None of the following methods could work correctly if the Clock wasn’t able to provide a time zone:

  • LocalDate.now(Clock)
  • LocalDateTime.now(Clock)
  • LocalTime.now(Clock)
  • MonthDay.now(Clock)
  • OffsetDateTime.now(Clock)
  • OffsetTime.now(Clock)
  • Year.now(Clock)
  • YearMonth.now(Clock)
  • ZonedDateTime.now(Clock)
  • HijrahDate.now(Clock)
  • JapaneseDate.now(Clock)
  • MinguoDate.now(Clock)
  • ThaiBuddhistDate.now(Clock)

The list may not be complete. Only Instant.now(Clock) doesn’t need a time zone and ignores the time zone of the Clock.

And yes, the alternative design where Clock had a zonedDateTime method providing the same result as ZonedDateTime.now(Clock) would have made sense too. However: Someone wanting to develop, say, a JewishDate class would never be able to insert a jewishDate method into the Clock class. With the existing design they can design their JewishDate class along the exact same lines as the existing date and time classes, including a JewishDate.now(Clock) method.