Класс FileTime

java.lang.Object
- java.nio.file.attribute.FileTime

Все реализованные интерфейсы:: Comparable<FileTime>

public final class FileTime
extends Object
implements Comparable<FileTime>

Представляет значение атрибута отметки времени файла. Например, он может представлять время последнего modified, accessed или created файла.

Экземпляры этого класса неизменяемы.

С момента:: 1.7
См. также:: Files.setLastModifiedTime(java.nio.file.Path, java.nio.file.attribute.FileTime), Files.getLastModifiedTime(java.nio.file.Path, java.nio.file.LinkOption...)

Методы

Модификатор и тип	Метод и описание
`int`	`compareTo(FileTime other)` Сравнивает значения двух объектов `FileTime` для определения порядка.
`boolean`	`equals(Object obj)` Проверяет этот объект `FileTime` на равенство с заданным объектом.
`static FileTime`	`from(Instant instant)` Возвращает `FileTime` , представляющий ту же точку во времени на временной шкале, что и предоставленный объект `Instant`.
`static FileTime`	`from(long value, TimeUnit unit)` Возвращает `FileTime` , представляющий значение с заданной точностью.
`static FileTime`	`fromMillis(long value)` Возвращает `FileTime` , представляющий заданное значение в миллисекундах.
`int`	`hashCode()` Вычисляет код хеширования для этого объекта времени файла.
`long`	`to(TimeUnit unit)` Возвращает значение с заданной точностью.
`Instant`	`toInstant()` Преобразует этот объект `FileTime` в объект `Instant`.
`long`	`toMillis()` Возвращает значение в миллисекундах.
`String`	`toString()` Возвращает строковое представление этого объекта `FileTime`.

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

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

Методы

from

public static FileTime from(long value,
                            TimeUnit unit)

Возвращает FileTime , представляющий значение с заданной точностью.

Параметры:: value - значение со времени эпохи (1970-01-01T00:00:00Z); может быть отрицательным; unit - единица измерения точности для интерпретации значения
Возвращает:: объект FileTime , представляющий данное значение

fromMillis

public static FileTime fromMillis(long value)

Возвращает FileTime , представляющий заданное значение в миллисекундах.

Параметры:: value - значение в миллисекундах со времени эпохи (1970-01-01T00:00:00Z); может быть отрицательным
Возвращает:: объект FileTime , представляющий данное значение

from

public static FileTime from(Instant instant)

Возвращает FileTime , представляющий ту же точку во времени на временной шкале, что и предоставленный объект Instant.

Параметры:: instant - мгновение времени для преобразования
Возвращает:: объект FileTime , представляющий ту же точку на временной шкале, что и предоставленное мгновение
С момента:: 1.8

to

public long to(TimeUnit unit)

Возвращает значение с заданной точностью.

Преобразование с более грубой точностью, которая привела бы к переполнению, насыщается до Long.MIN_VALUE если отрицательное или Long.MAX_VALUE если положительное.

Параметры:: unit - единица измерения точности для возвращаемого значения
Возвращает:: значение в заданной единице измерения точности, со времени эпохи (1970-01-01T00:00:00Z); может быть отрицательным

toMillis

public long toMillis()

Возвращает значение в миллисекундах.

Возвращает:: значение в миллисекундах, со времени эпохи (1970-01-01T00:00:00Z)

toInstant

public Instant toInstant()

Преобразует этот объект FileTime в объект Instant.

Преобразование создает объект Instant , который представляет ту же точку на временной шкале, что и этот объект FileTime.

Объект FileTime может хранить точки на временной шкале дальше в будущем и дальше в прошлом, чем Instant. Преобразование из таких более удаленных точек времени насыщается до Instant.MIN если раньше Instant.MIN или Instant.MAX если позже Instant.MAX.

Возвращает:: объект мгновения времени, представляющий ту же точку на временной шкале, что и этот объект FileTime
С момента:: 1.8

equals

public boolean equals(Object obj)

Проверяет этот объект FileTime на равенство с заданным объектом.

Результат true тогда и только тогда, когда аргумент не null и является объектом FileTime, представляющим то же время. Этот метод удовлетворяет общему контракту метода Object.equals.

Переопределяет:: equals в классе Object
Параметры:: obj - объект для сравнения
Возвращает:: true если, и только если, заданный объект является объектом FileTime, представляющим то же время
См. также:: Object.hashCode(), HashMap

hashCode

public int hashCode()

Вычисляет код хеширования для этого объекта времени файла.

Код хеширования основан на представленном значении и удовлетворяет общему контракту метода Object.hashCode().

Переопределяет:: hashCode в классе Object
Возвращает:: значение кода хеширования
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

compareTo

public int compareTo(FileTime other)

Сравнивает значения двух объектов FileTime для определения порядка.

Определено в:: compareTo в интерфейсе Comparable<FileTime>
Параметры:: other - другой объект FileTime для сравнения
Возвращает:: 0 если этот объект FileTime равен other, значение меньше 0, если этот объект FileTime представляет время, которое предшествует other, и значение больше 0, если этот объект FileTime представляет время, которое следует за other

toString

public String toString()

Возвращает строковое представление этого объекта FileTime в формате ISO 8601:

YYYY-MM-DDThh:mm:ss[.s+]Z

, где "[.s+]" представляет собой точку, за которой следуют одна или несколько цифр для десятичной дроби секунды. Он присутствует только тогда, когда десятичная дробь секунды не равна нулю. Например, FileTime.fromMillis(1234567890000L).toString() возвращает "2009-02-13T23:31:30Z", а FileTime.fromMillis(1234567890123L).toString() возвращает "2009-02-13T23:31:30.123Z".

Объект FileTime предназначен в первую очередь для представления значения отметки времени файла. В случае представления экстремальных значений, где год меньше "0001" или больше "9999", этот метод отличается от формата ISO 8601 аналогично языку XML Schema . То есть, год может быть расширен до более чем четырех цифр и может быть со знаком минус. Если больше четырех цифр, то ведущие нули не присутствуют. Год до "0001" равен "-0001".

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.