Класс 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

См. также:

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

Модификатор и тип	Метод	Описание
`int`	`compareTo(FileTime other)`	Сравнивает значения двух объектов `FileTime` для определения порядка.
`boolean`	`equals(Object obj)`	Проверяет это `FileTime` на равенство с заданным объектом.
`static FileTime`	`from(long value, TimeUnit unit)`	Возвращает `FileTime`, представляющий значение в заданном единице измерения.
`static FileTime`	`from(Instant instant)`	Возвращает `FileTime`, представляющий ту же временную точку на временной шкале, что и предоставленный объект `Instant`.
`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

, представляющим то же время

См. также:

hashCode

public int hashCode()

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

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

Переопределяет:

hashCode в классе 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, 2025, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/nio/file/attribute/FileTime.html