Spec-Zone.ru › OpenJDK 17

Класс 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 , представляющий ту же точку на временной шкале, что и предоставленный объект Instant
С:
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.

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

hashCode

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

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

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

compareTo

public int compareTo(FileTime other)
Сравнивает значения двух объектов FileTime для определения порядка.
Specified by:
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".

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

© 1993, 2021, 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/17/docs/api/java.base/java/nio/file/attribute/FileTime.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API