Класс Duration

java.lang.Object

javafx.util.Duration

Все реализуемые интерфейсы:: Serializable, Comparable<Duration>

public class Duration
extends Object
implements Comparable<Duration>, Serializable

Класс, определяющий продолжительность времени. Экземпляры Duration неизменяемы и, следовательно, заменяются, а не изменяются, аналогично BigDecimal. Продолжительности могут быть созданы с помощью конструктора или одного из статических методов создания, таких как seconds(double) или minutes(double).

С:: JavaFX 2.0
См. также:: Сериализованная форма

Краткое описание полей

Поля
Модификатор и тип	Поле	Описание
`static Duration`	`INDEFINITE`	Бесконечная продолжительность.
`static Duration`	`ONE`	Продолжительность 1 миллисекунды.
`static Duration`	`UNKNOWN`	Продолжительность с неизвестной величиной.
`static Duration`	`ZERO`	Продолжительность 0 (без времени).

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

Конструкторы
Конструктор	Описание
`Duration(double millis)`	Создаёт новую продолжительность с потенциальным дробным разрешением миллисекунд.

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

Модификатор и тип	Метод	Описание
`Duration`	`add(Duration other)`	Добавляет этот экземпляр и другой экземпляр Duration, чтобы вернуть новый экземпляр Duration.
`int`	`compareTo(Duration d)`	Сравнивает продолжительности, представленные этим объектом и указанным объектом.
`Duration`	`divide(double n)`	Делит этот экземпляр на число, чтобы вернуть новый экземпляр Duration.
`Duration`	`divide(Duration other)`	Устарело. Этот метод даёт неожиданные результаты, не учитывая единицы измерения.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект "равным" этому.
`boolean`	`greaterThan(Duration other)`	Возвращает true, если указанная продолжительность больше (>) этого экземпляра.
`boolean`	`greaterThanOrEqualTo(Duration other)`	Возвращает true, если указанная продолжительность больше или равна (>=) этому экземпляру.
`int`	`hashCode()`	Возвращает хэш-код для этого объекта `Duration`.
`static Duration`	`hours(double h)`	Метод фабрики, возвращающий экземпляр Duration, представляющий указанное количество часов.
`boolean`	`isIndefinite()`	Получает, является ли этот экземпляр Duration неопределённым.
`boolean`	`isUnknown()`	Получает, является ли этот экземпляр Duration неизвестным.
`boolean`	`lessThan(Duration other)`	Возвращает true, если указанная продолжительность меньше (<) этого экземпляра.
`boolean`	`lessThanOrEqualTo(Duration other)`	Возвращает true, если указанная продолжительность меньше или равна (<=) этому экземпляру.
`static Duration`	`millis(double ms)`	Метод фабрики, возвращающий экземпляр Duration для заданного количества миллисекунд.
`static Duration`	`minutes(double m)`	Метод фабрики, возвращающий экземпляр Duration, представляющий указанное количество минут.
`Duration`	`multiply(double n)`	Умножает этот экземпляр на число, представляющее миллисекунды, и возвращает новый Duration.
`Duration`	`multiply(Duration other)`	Устарело. Этот метод даёт неожиданные результаты, не учитывая единицы измерения.
`Duration`	`negate()`	Возвращает новый экземпляр Duration, имеющий отрицательное количество миллисекунд от этого экземпляра.
`static Duration`	`seconds(double s)`	Метод фабрики, возвращающий экземпляр Duration, представляющий указанное количество секунд.
`Duration`	`subtract(Duration other)`	Вычитает другой экземпляр Duration из этого экземпляра, чтобы вернуть новый экземпляр Duration.
`double`	`toHours()`	Возвращает количество часов в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.
`double`	`toMillis()`	Возвращает количество миллисекунд в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.
`double`	`toMinutes()`	Возвращает количество минут в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.
`double`	`toSeconds()`	Возвращает количество секунд в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.
`String`	`toString()`	Возвращает строковое представление этого объекта `Duration`.
`static Duration`	`valueOf(String time)`	Метод фабрики, возвращающий экземпляр Duration для указанного промежутка времени.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание полей

ZERO

public static final Duration ZERO

Продолжительность 0 (нет времени).

ONE

public static final Duration ONE

Продолжительность 1 миллисекунда.

INDEFINITE

public static final Duration INDEFINITE

Бесконечная продолжительность.

UNKNOWN

public static final Duration UNKNOWN

Продолжительность неизвестной величины.

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

Duration

public Duration(double millis)

Создаёт новую продолжительность с потенциально дробным разрешением миллисекунд.

Parameters:: millis - Количество миллисекунд

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

valueOf

public static Duration valueOf(String time)

Метод-фабрика, возвращающий экземпляр Duration для заданной продолжительности. Синтаксис: "[число][мс|с|м|ч]".

Parameters:: time - Непустая строка с правильным форматом. Пробелы в начале или конце строки не будут обработаны корректно. Бросает NullPointerException, если время равно null.
Returns:: экземпляр Duration, представляющий time

millis

public static Duration millis(double ms)

Метод-фабрика, возвращающий экземпляр Duration для заданного количества миллисекунд.

Parameters:: ms - Количество миллисекунд
Returns:: экземпляр Duration для указанного количества миллисекунд

seconds

public static Duration seconds(double s)

Метод-фабрика, возвращающий экземпляр Duration, представляющий заданное количество секунд.

Parameters:: s - Количество секунд
Returns:: экземпляр Duration для указанного количества секунд

minutes

public static Duration minutes(double m)

Метод-фабрика, возвращающий экземпляр Duration, представляющий заданное количество минут.

Parameters:: m - Количество минут
Returns:: экземпляр Duration для указанного количества минут

hours

public static Duration hours(double h)

Метод-фабрика, возвращающий экземпляр Duration, представляющий заданное количество часов.

Parameters:: h - Количество часов
Returns:: экземпляр Duration, представляющий заданное количество часов

toMillis

public double toMillis()

Возвращает количество миллисекунд в данном интервале или Double.POSITIVE_INFINITY, если интервал неопределён, или NaN, если интервал неизвестен.

Returns:: Продолжительность в дробных миллисекундах

toSeconds

public double toSeconds()

Возвращает количество секунд в данном интервале или Double.POSITIVE_INFINITY, если интервал неопределён, или NaN, если интервал неизвестен.

Returns:: Продолжительность в дробных секундах

toMinutes

public double toMinutes()

Возвращает количество минут в данном интервале или Double.POSITIVE_INFINITY, если интервал неопределён, или NaN, если интервал неизвестен.

Returns:: Продолжительность в дробных минутах

toHours

public double toHours()

Возвращает количество часов в данном интервале или Double.POSITIVE_INFINITY, если интервал неопределён, или NaN, если интервал неизвестен.

Returns:: Продолжительность в дробных часах

add

public Duration add(Duration other)

Добавляет текущий экземпляр и другой экземпляр Duration, возвращая новый экземпляр Duration. Если любой из экземпляров — INDEFINITE, возвращает INDEFINITE. Если любой из экземпляров — UNKNOWN, возвращает UNKNOWN. Этот метод не изменяет значение вызываемого экземпляра Duration.

Parameters:: other - не должен быть null
Returns:: результат добавления текущей продолжительности к другой продолжительности. Это эквивалентно millis + other.millis с использованием двойной арифметики

subtract

public Duration subtract(Duration other)

Вычитает другой экземпляр Duration из текущего, возвращая новый экземпляр Duration. Если любой из экземпляров — UNKNOWN, возвращает UNKNOWN. В противном случае, если любой из экземпляров — INDEFINITE, возвращает INDEFINITE. Этот метод не изменяет значение вызываемого экземпляра Duration.

Parameters:: other - не должен быть null
Returns:: результат вычитания другой продолжительности из текущей продолжительности. Это эквивалентно millis - other.millis с использованием двойной арифметики

multiply

@Deprecated public Duration multiply(Duration other)

Устарело.

Этот метод даёт неожиданные результаты, так как не учитывает единицы измерения. Используйте multiply(double) вместо этого.

Умножает текущий экземпляр на число, возвращая новый экземпляр Duration. Если любой из экземпляров — INDEFINITE, возвращает INDEFINITE. Если любой из экземпляров — UNKNOWN, возвращает UNKNOWN. Этот метод не изменяет значение вызываемого экземпляра Duration.

Parameters:: other - не должен быть null
Returns:: результат умножения текущей продолжительности на другую продолжительность. Это эквивалентно millis * other.millis с использованием двойной арифметики

multiply

public Duration multiply(double n)

Умножает текущий экземпляр на число, представляющее миллисекунды, и возвращает новый Duration. Если текущий экземпляр Duration — INDEFINITE, возвращает INDEFINITE. Если текущий экземпляр Duration — UNKNOWN, возвращает UNKNOWN. Этот метод не изменяет значение вызываемого экземпляра Duration.

Parameters:: n - значение, на которое нужно умножить в дробных миллисекундах
Returns:: результат умножения текущей продолжительности на n. Это эквивалентно millis * n с использованием двойной арифметики

divide

public Duration divide(double n)

Делит текущий экземпляр на число, возвращая новый экземпляр Duration. Если текущий экземпляр Duration — INDEFINITE, возвращает INDEFINITE. Если текущий экземпляр Duration — UNKNOWN, возвращает UNKNOWN. Этот метод не изменяет значение вызываемого экземпляра Duration.

Parameters:: n - значение, на которое нужно разделить в дробных миллисекундах
Returns:: результат деления текущей продолжительности на n. Это эквивалентно millis / n с использованием двойной арифметики

divide

@Deprecated public Duration divide(Duration other)

Устарело.

Этот метод даёт неожиданные результаты, так как не учитывает единицы измерения. Используйте divide(double) вместо этого.

Делит текущий экземпляр на другой Duration, возвращая отношение. Если оба экземпляра — INDEFINITE, возвращает NaN. Если текущий экземпляр — INDEFINITE, возвращает POSITIVE_INFINITY. Если другой экземпляр — INDEFINITE, возвращает 0.0. Эта функция не изменяет значение вызываемого экземпляра Duration.

Parameters:: other - не должен быть null
Returns:: результат деления текущей продолжительности на другую продолжительность. Это эквивалентно millis / other.millis с использованием двойной арифметики

negate

public Duration negate()

Возвращает новый экземпляр Duration с отрицательным количеством миллисекунд, взятым из текущего экземпляра. Например, Duration.millis(50).negate() возвращает продолжительность -50 миллисекунд. Если текущий экземпляр Duration — INDEFINITE, возвращает INDEFINITE. Эта функция не изменяет значение вызываемого экземпляра Duration.

Returns:: результат инвертирования знака продолжительности. Это эквивалентно -millis с использованием двойной арифметики

isIndefinite

public boolean isIndefinite()

Определяет, является ли текущий экземпляр Duration неопределённым. Duration считается неопределённым, если он равен Duration.INDEFINITE.

Returns:: true, если этот Duration эквивалентен Duration.INDEFINITE или Double.POSITIVE_INFINITY.

isUnknown

public boolean isUnknown()

Определяет, является ли текущий экземпляр Duration неизвестным. Duration считается неизвестным, если он равен Duration.UNKNOWN.

Returns:: true, если этот Duration эквивалентен Duration.UNKNOWN или Double.isNaN(millis)

lessThan

public boolean lessThan(Duration other)

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

Parameters:: other - не может быть null
Returns:: true, если millis < other.millis с использованием двойной арифметики

lessThanOrEqualTo

public boolean lessThanOrEqualTo(Duration other)

Возвращает true, если указанная продолжительность меньше или равна текущему экземпляру. INDEFINITE обрабатывается как положительная бесконечность.

Parameters:: other - не может быть null
Returns:: true, если millis <= other.millis с использованием двойной арифметики

greaterThan

public boolean greaterThan(Duration other)

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

Parameters:: other - не может быть null
Returns:: true, если millis > other.millis с использованием двойной арифметики

greaterThanOrEqualTo

public boolean greaterThanOrEqualTo(Duration other)

Возвращает true, если указанная продолжительность больше или равна (>=) текущему экземпляру. INDEFINITE обрабатывается так, как будто это положительная бесконечность.

Параметры:: other - не может быть null
Возвращает:: true, если millis >= other.millis с использованием двойной арифметики

toString

public String toString()

Возвращает строковое представление этого Duration объекта.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого Duration объекта.

compareTo

public int compareTo(Duration d)

Сравнивает продолжительности, представленные этим объектом и указанным объектом. Возвращает отрицательное целое число, ноль или положительное целое число, так как эта продолжительность меньше, равна или больше указанной продолжительности.

Определено в:: compareTo в интерфейсе Comparable<Duration>
Параметры:: d - продолжительность для сравнения.
Возвращает:: отрицательное целое число, ноль или положительное целое число, так как эта продолжительность меньше, равна или больше указанной продолжительности.

equals

public boolean equals(Object obj)

Указывает, является ли какой-либо другой объект "равным" этому.

Переопределяет:: equals в классе Object
Параметры:: obj - ссылка на объект для сравнения.
Возвращает:: true, если этот объект равен переданному аргументу; false в противном случае.

hashCode

public int hashCode()

Возвращает код хэша для этого Duration объекта.

Переопределяет:: hashCode в классе Object
Возвращает:: код хэша для этого Duration объекта.

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.