Spec-Zone.ru › OpenJDK 21

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

Возвращает:
мгновение, представляющее ту же точку на временной шкале, что и этот 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
Возвращает:
строковое представление времени файла
Внешние спецификации
  • Форматы дат и времени
  • XML Schema Part 2: Datatypes Second Edition

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

Spec-Zone.ru

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