Класс 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, если период бесконечен, или NaN, если период неизвестен.

Возвращает:: продолжительность в дробных миллисекундах

toSeconds

public double toSeconds()

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

Возвращает:: продолжительность в дробных секундах

toMinutes

public double toMinutes()

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

Возвращает:: продолжительность в дробных минутах

toHours

public double toHours()

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

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

add

public Duration add(Duration other)

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

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

subtract

public Duration subtract(Duration other)

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

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

multiply

@Deprecated public Duration multiply(Duration other)

Устарело.

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

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

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

multiply

public Duration multiply(double n)

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

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

divide

public Duration divide(double n)

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

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

divide

@Deprecated public Duration divide(Duration other)

Устарело.

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

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

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

negate

public Duration negate()

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

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

isIndefinite

public boolean isIndefinite()

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

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

isUnknown

public boolean isUnknown()

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

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

lessThan

public boolean lessThan(Duration other)

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

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

lessThanOrEqualTo

public boolean lessThanOrEqualTo(Duration other)

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

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

greaterThan

public boolean greaterThan(Duration other)

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

Параметры:: other - не может быть null
Возвращает:: 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.