javafx.util

Класс Duration

java.lang.Object

javafx.util.Duration

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

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

Класс, определяющий продолжительность времени. Экземпляры Duration неизменяемы и, следовательно, заменяются, а не изменяются, аналогично BigDecimal. Duration можно создать, используя конструктор или один из статических методов создания, таких как 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)` Устарело. Этот метод дает неожиданные результаты, так как не учитывает единицы измерения. Используйте `divide(double)` вместо этого.
`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)` Устарело. Этот метод дает неожиданные результаты, так как не учитывает единицы измерения. Используйте `multiply(double)` вместо этого.
`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 неопределён, если он равен 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 с использованием арифметики с плавающей точкой
- 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.

Класс Duration

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

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

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

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

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

ZERO

ONE

INDEFINITE

UNKNOWN

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

Duration

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

valueOf

millis

seconds

minutes

hours

toMillis

toSeconds

toMinutes

toHours

add

subtract

multiply

multiply

divide

divide

negate

isIndefinite

isUnknown

lessThan

lessThanOrEqualTo

greaterThan

greaterThanOrEqualTo

toString

compareTo

equals

hashCode