Класс Clock

• java.lang.Object
• • java.time.Clock

public abstract class Clock
extends Object

public class MyBean {
    private Clock clock;  // dependency inject
    ...
    public void process(LocalDate eventDate) {
      if (eventDate.isBefore(LocalDate.now(clock)) {
        ...
      }
    }
  }

Требования к реализации:

Этот абстрактный класс должен быть реализован с осторожностью, чтобы обеспечить корректную работу других классов. Все реализуемые экземпляры должны быть конечными, неизменяемыми и потокобезопасными.

Основные методы определены для возможности выбрасывания исключения. В обычном использовании исключения не выбрасываются, однако одной из возможных реализаций будет получение времени с центрального сервера времени через сеть. Очевидно, что в этом случае поиск может завершиться неудачей, поэтому метод допускается выбрасывать исключение.

Возвращаемые мгновения из Clock работают на шкале времени, игнорирующей високосные секунды, как описано в Instant. Если реализация оборачивает источник, предоставляющий информацию о високосных секундах, то необходимо использовать механизм для «сглаживания» високосной секунды. Java Time-Scale предписывает использование UTC-SLS, однако реализации часов могут выбирать, насколько точны они со шкалой времени, при условии, что они документируют, как они работают. Поэтому реализации не обязаны фактически выполнять сдвиг UTC-SLS или каким-либо другим образом учитывать високосные секунды.

Реализации должны реализовывать Serializable по возможности и должны документировать, поддерживают ли они сериализацию.

Примечание по реализации:

Реализация часов, предоставленная здесь, основана на тех же базовых часах, что и System.currentTimeMillis(), но может иметь точность, более высокую чем миллисекунды, если доступна. Однако, никакой гарантии не предоставляется относительно точности базовых часов. Приложения, требующие более точных часов, должны реализовать этот абстрактный класс самостоятельно, используя другие внешние часы, такие как сервер NTP.

С тех пор:

1.8

protected Clock()