Класс 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 final Duration`	`INDEFINITE`	Бесконечная продолжительность.
`static final Duration`	`ONE`	Продолжительность 1 миллисекунды.
`static final Duration`	`UNKNOWN`	Продолжительность неизвестной длительности.
`static final 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)

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

Параметры:: millis - Количество миллисекунд

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

valueOf

public static Duration valueOf(String time)

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

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

millis

public static Duration millis(double ms)

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

Параметры:: ms - количество миллисекунд
Возвращает:: экземпляр Duration заданного количества миллисекунд

seconds

public static Duration seconds(double s)

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

Параметры:: s - количество секунд
Возвращает:: экземпляр Duration указанного количества секунд

minutes

public static Duration minutes(double m)

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

Параметры:: m - количество минут
Возвращает:: экземпляр Duration указанного количества минут

hours

public static Duration hours(double h)

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

Параметры:: h - количество часов
Возвращает:: экземпляр Duration, представляющий указанное количество часов

toMillis

public double toMillis()

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

Возвращает:: Продолжительность в миллисекундах с дробной частью

toSeconds

public double toSeconds()

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

Возвращает:: Продолжительность в секундах с дробной частью

toMinutes

public double toMinutes()

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

Возвращает:: Продолжительность в минутах с дробной частью

toHours

public double toHours()

Возвращает количество часов в этом периоде или Double.POSITIVE_INFINITY, если период — INDEFINITE, или NaN, если период — UNKNOWN.

Возвращает:: Продолжительность в часах с дробной частью

add

public Duration add(Duration other)

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

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

subtract

public Duration subtract(Duration other)

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

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

multiply

@Deprecated public Duration multiply(Duration other)

Устарело.

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

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

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

multiply

public Duration multiply(double n)

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

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

divide

public Duration divide(double n)

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

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

divide

@Deprecated public Duration divide(Duration other)

Устарело.

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

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

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

negate

public Duration negate()

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

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

isIndefinite

public boolean isIndefinite()

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

Возвращает:: true, если этот Duration эквивалентен Duration.INDEFINITE или Double.POSITIVE_INFINITY.

isUnknown

public boolean isUnknown()

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

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

lessThan

public boolean lessThan(Duration other)

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

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

меньшеИлиРавно

public boolean lessThanOrEqualTo(Duration other)

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

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

больше

public boolean greaterThan(Duration other)

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

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

большеИлиРавно

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, если этот объект равен переданному obj аргументу; 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.