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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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.