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

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

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

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

toInstant

public Instant toInstant()

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

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

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

Возвращает:: объект instant, представляющий ту же временную метку, что и этот объект 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
Возвращает:: строковое представление этой временной метки файла