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

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/file/attribute/FileTime.html