Класс TimerTask

java.lang.Object

java.util.TimerTask

Все реализуемые интерфейсы:: Runnable

public abstract class TimerTask extends Object implements Runnable

Задача, которую можно запланировать для однократного или повторного выполнения с помощью Timer.

Задачу таймера нельзя использовать повторно. После того как задача запланирована для выполнения в Timer или отменена, последующие попытки запланировать её выполнение приведут к выбросу IllegalStateException.

Начиная с версии:: 1.3

Краткое описание конструкторов

TimerTask()

Модификатор	Конструктор	Описание
`protected`	Создает новую задачу таймера.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`cancel()`	Отменяет эту задачу таймера.
`abstract void`	`run()`	Действие, выполняемое этой задачей таймера.
`long`	`scheduledExecutionTime()`	Возвращает запланированное время последнего фактического выполнения этой задачи.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

TimerTask

protected TimerTask()

Создает новую задачу таймера.

Подробное описание методов

run

public abstract void run()

Действие, выполняемое этой задачей таймера.

Определено в:: run в интерфейсе Runnable

cancel

public boolean cancel()

Отменяет эту задачу таймера. Если задача была запланирована для однократного выполнения и еще не запускалась либо еще не была запланирована, она никогда не запустится. Если задача была запланирована для повторного выполнения, она больше не запустится. (Если в момент вызова этого метода задача выполняется, она завершится, но больше не запустится.)

Обратите внимание: вызов этого метода из метода run повторяющейся задачи таймера гарантирует, что задача таймера больше не запустится.

Этот метод можно вызывать многократно; второй и последующие вызовы не имеют эффекта.

Возвращает:: true, если эта задача запланирована для однократного выполнения и еще не запускалась или если эта задача запланирована для повторного выполнения. Возвращает false, если задача была запланирована для однократного выполнения и уже запускалась, если задача никогда не была запланирована или если задача уже была отменена. (В общих чертах, этот метод возвращает true, если он предотвращает выполнение одного или нескольких запланированных запусков.)

scheduledExecutionTime

public long scheduledExecutionTime()

Возвращает запланированное время последнего фактического выполнения этой задачи. (Если этот метод вызван во время выполнения задачи, возвращаемое значение будет запланированным временем текущего выполнения задачи.)

Этот метод обычно вызывается из метода run задачи, чтобы определить, достаточно ли своевременно выполняется текущий запуск задачи для выполнения запланированного действия:

  public void run() {
      if (System.currentTimeMillis() - scheduledExecutionTime() >=
          MAX_TARDINESS)
              return;  // Too late; skip this execution.
      // Perform the task
  }

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

Возвращает:

время, на которое было запланировано последнее выполнение этой задачи, в формате, возвращаемом методом Date.getTime(). Возвращаемое значение не определено, если задача еще не приступила к первому выполнению.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/TimerTask.html