- 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
- См. также:
- Сериализованная форма
-
Краткое описание конструкторов
Конструкторы Конструктор Описание Duration(double millis)Создаёт новую продолжительность с потенциальным дробным разрешением миллисекунд.
-
Краткое описание методов
Все методыСтатические методыМетоды экземпляраКонкретные методыМетоды устаревшие Модификатор и тип Метод Описание Durationadd(Duration other)Добавляет этот экземпляр и другой экземпляр Duration, чтобы вернуть новый экземпляр Duration.intcompareTo(Duration d)Сравнивает продолжительности, представленные этим объектом и указанным объектом.Durationdivide(double n)Делит этот экземпляр на число, чтобы вернуть новый экземпляр Duration.Durationdivide(Duration other)Устаревший.Этот метод даёт неожиданные результаты, так как не учитывает единицы измерения.booleanequals(Object obj)Указывает, равен ли какой-либо другой объект этому.booleangreaterThan(Duration other)Возвращает true, если указанная продолжительность больше (>) этого экземпляра.booleangreaterThanOrEqualTo(Duration other)Возвращает true, если указанная продолжительность больше или равна (>=) этому экземпляру.inthashCode()Возвращает хэш-код для этого объектаDuration.static Durationhours(double h)Метод-фабрика, возвращающий экземпляр Duration, представляющий указанное количество часов.booleanisIndefinite()Определяет, является ли этот экземпляр Duration неопределённым.booleanisUnknown()Определяет, является ли этот экземпляр Duration неизвестным.booleanlessThan(Duration other)Возвращает true, если указанная продолжительность меньше (<) этого экземпляра.booleanlessThanOrEqualTo(Duration other)Возвращает true, если указанная продолжительность меньше или равна (<=) этому экземпляру.static Durationmillis(double ms)Метод-фабрика, возвращающий экземпляр Duration для указанного количества миллисекунд.static Durationminutes(double m)Метод-фабрика, возвращающий экземпляр Duration, представляющий указанное количество минут.Durationmultiply(double n)Умножает этот экземпляр на число, представляющее миллисекунды, и возвращает новый Duration.Durationmultiply(Duration other)Устаревший.Этот метод даёт неожиданные результаты, так как не учитывает единицы измерения.Durationnegate()Возвращает новый экземпляр Duration, имеющий отрицательное количество миллисекунд от этого экземпляра.static Durationseconds(double s)Метод-фабрика, возвращающий экземпляр Duration, представляющий указанное количество секунд.Durationsubtract(Duration other)Вычитает другой экземпляр Duration из этого экземпляра, чтобы вернуть новый экземпляр Duration.doubletoHours()Возвращает количество часов в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.doubletoMillis()Возвращает количество миллисекунд в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.doubletoMinutes()Возвращает количество минут в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.doubletoSeconds()Возвращает количество секунд в этом периоде или Double.POSITIVE_INFINITY, если период неопределён, или NaN, если период неизвестен.StringtoString()Возвращает строковое представление этого объектаDuration.static DurationvalueOf(String time)Метод-фабрика, возвращающий экземпляр Duration для указанного количества времени.
-
Подробное описание полей
-
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- Количество миллисекунд
-
-
Method Detail
-
valueOf
public static Duration valueOf(String time)
Метод фабрики, который возвращает экземпляр Duration для указанного количества времени. Синтаксис: "[number][ms|s|m|h]".- Parameters:
-
time- Строка, не равная null, отформатированная надлежащим образом. Начальные или конечные пробелы не будут правильно обработаны. Вызывает NullPointerException, если time имеет значение null. - Returns:
- a Duration which is represented by the
time
-
millis
public static Duration millis(double ms)
Метод фабрики, который возвращает экземпляр Duration для указанного количества миллисекунд.- Parameters:
-
ms- the number of milliseconds - Returns:
- a Duration instance of the specified number of milliseconds
-
seconds
public static Duration seconds(double s)
Метод фабрики, который возвращает экземпляр Duration, представляющий указанное количество секунд.- Parameters:
-
s- the number of seconds - Returns:
- a Duration instance of the specified number of seconds
-
minutes
public static Duration minutes(double m)
Метод фабрики, который возвращает экземпляр Duration, представляющий указанное количество минут.- Parameters:
-
m- the number of minutes - Returns:
- a Duration instance of the specified number of minutes
-
hours
public static Duration hours(double h)
Метод фабрики, который возвращает экземпляр Duration, представляющий указанное количество часов.- Parameters:
-
h- the number of hours - Returns:
- a Duration instance representing the specified number of hours
-
toMillis
public double toMillis()
Возвращает количество миллисекунд в этом периоде или Double.POSITIVE_INFINITY, если период INDEFINITE, или NaN, если период UNKNOWN.- Returns:
- the Duration in fractional milliseconds
-
toSeconds
public double toSeconds()
Возвращает количество секунд в этом периоде или Double.POSITIVE_INFINITY, если период INDEFINITE, или NaN, если период UNKNOWN.- Returns:
- the Duration in fractional seconds
-
toMinutes
public double toMinutes()
Возвращает количество минут в этом периоде или Double.POSITIVE_INFINITY, если период INDEFINITE, или NaN, если период UNKNOWN.- Returns:
- the Duration in fractional minutes
-
toHours
public double toHours()
Возвращает количество часов в этом периоде или Double.POSITIVE_INFINITY, если период INDEFINITE, или NaN, если период UNKNOWN.- Returns:
- the Duration in fractional hours
-
add
public Duration add(Duration other)
Сложите этот экземпляр и другой экземпляр Duration, чтобы вернуть новый экземпляр Duration. Если какой-либо экземпляр имеет значение INDEFINITE, верните INDEFINITE. Если какой-либо экземпляр имеет значение UNKNOWN, верните UNKNOWN. Этот метод не изменяет значение вызванного экземпляра Duration.- Parameters:
-
other- must not be null - Returns:
- the result of adding this duration to the other duration. This is the same as millis + other.millis using double arithmetic
-
subtract
public Duration subtract(Duration other)
Вычтите другой экземпляр Duration из этого экземпляра, чтобы вернуть новый экземпляр Duration. Если какой-либо экземпляр имеет значение UNKNOWN, верните UNKNOWN. В противном случае, если какой-либо экземпляр имеет значение INDEFINITE, верните INDEFINITE. Этот метод не изменяет значение вызванного экземпляра Duration.- Parameters:
-
other- must not be null - Returns:
- the result of subtracting the other duration from this duration. This is the same as millis - other.millis using double arithmetic
-
multiply
@Deprecated public Duration multiply(Duration other)
Deprecated.Этот метод дает неожиданные результаты, не учитывая единицы измерения. Используйтеmultiply(double)instead.Умножьте этот экземпляр на число, чтобы вернуть новый экземпляр Duration. Если какой-либо экземпляр имеет значение INDEFINITE, верните INDEFINITE. Если какой-либо экземпляр Duration имеет значение UNKNOWN, верните UNKNOWN. Этот метод не изменяет значение вызванного экземпляра Duration.- Parameters:
-
other- must not be null - Returns:
- the result of multiplying this duration with the other duration. This is the same as millis * other.millis using double arithmetic
-
multiply
public Duration multiply(double n)
Умножьте этот экземпляр на число, представляющее миллисекунды, и верните новый Duration. Если вызванный экземпляр Duration имеет значение INDEFINITE, верните INDEFINITE. Если вызванный экземпляр Duration имеет значение UNKNOWN, верните UNKNOWN. Этот метод не изменяет значение вызванного экземпляра Duration.- Parameters:
-
n- the amount to multiply by in fractional milliseconds - Returns:
- the result of multiplying this duration with n. This is the same as millis * n using double arithmetic
-
divide
public Duration divide(double n)
Разделите этот экземпляр на число, чтобы вернуть новый экземпляр Duration. Если вызванный экземпляр Duration имеет значение INDEFINITE, верните INDEFINITE. Если вызванный экземпляр Duration имеет значение UNKNOWN, верните UNKNOWN. Этот метод не изменяет значение вызванного экземпляра Duration.- Parameters:
-
n- the amount to divide by in fractional milliseconds - Returns:
- the result of dividing this duration with n. This is the same as millis / n using double arithmetic
-
divide
@Deprecated public Duration divide(Duration other)
Deprecated.Этот метод дает неожиданные результаты, не учитывая единицы измерения. Используйтеdivide(double)instead.Разделите этот экземпляр на другой Duration, чтобы вернуть отношение. Если оба экземпляра имеют значение INDEFINITE, верните NaN. Если этот экземпляр имеет значение INDEFINITE, верните POSITIVE_INFINITY Если другой экземпляр имеет значение INDEFINITE, верните 0.0. Эта функция не изменяет значение вызванного экземпляра Duration.- Parameters:
-
other- must not be null - Returns:
- the result of dividing this duration by the other duration. This is the same as millis / other.millis using double arithmetic
-
negate
public Duration negate()
Верните новый экземпляр Duration, имеющий отрицательное количество миллисекунд от этого экземпляра. Например,Duration.millis(50).negate()возвращает Duration, равный -50 миллисекундам. Если вызванный экземпляр Duration имеет значение INDEFINITE, верните INDEFINITE. Эта функция не изменяет значение вызванного экземпляра Duration.- Returns:
- the result of negating this duration. This is the same as -millis using double arithmetic
-
isIndefinite
public boolean isIndefinite()
Получает, является ли этот экземпляр Duration неопределенным. Duration считается неопределенным, если он равен Duration.INDEFINITE.- Returns:
- true if this Duration is equivalent to Duration.INDEFINITE or Double.POSITIVE_INFINITY.
-
isUnknown
public boolean isUnknown()
Получает, является ли этот экземпляр Duration неизвестным. Duration считается неизвестным, если он равен Duration.UNKNOWN.- Returns:
- true if this Duration is equivalent to Duration.UNKNOWN or Double.isNaN(millis)
-
lessThan
public boolean lessThan(Duration other)
Возвращает значение true, если указанная продолжительность меньше (<) этого экземпляра. INDEFINITE рассматривается как положительная бесконечность.- Parameters:
-
other- cannot be null - Returns:
- true if millis < other.millis using double arithmetic
-
lessThanOrEqualTo
public boolean lessThanOrEqualTo(Duration other)
Возвращает значение true, если указанная продолжительность меньше или равна (<=) этому экземпляру. INDEFINITE рассматривается как положительная бесконечность.- Parameters:
-
other- cannot be null - Returns:
- true if millis <= other.millis using double arithmetic
-
greaterThan
public boolean greaterThan(Duration other)
Возвращает значение true, если указанная продолжительность больше (>) этого экземпляра. INDEFINITE рассматривается как положительная бесконечность.- Parameters:
-
other- cannot be null - Returns:
- true if millis > other.millis using double arithmetic
-
-
greaterThanOrEqualTo
public boolean greaterThanOrEqualTo(Duration other)
Возвращает true, если заданная продолжительность больше или равна (>=) этому экземпляру. INDEFINITE обрабатывается как если бы это была положительная бесконечность.- Параметры:
-
other- не может быть null - Возвращает:
- true, если millis >= other.millis с использованием двойной арифметики
-
toString
public String toString()
Возвращает строковое представление этогоDurationобъекта.
-
compareTo
public int compareTo(Duration d)
Сравнивает продолжительности, представленные этим объектом и указанным объектом. Возвращает отрицательное целое число, ноль или положительное целое число, если эта продолжительность меньше, равна или больше указанной продолжительности.- Определено в:
-
compareToв интерфейсеComparable<Duration> - Параметры:
-
d- продолжительность для сравнения. - Возвращает:
- отрицательное целое число, ноль или положительное целое число, если эта продолжительность меньше, равна или больше указанной продолжительности.
-
equals
public boolean equals(Object obj)
Указывает, является ли какой-либо другой объект "равным" этому.
-
© 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.