Класс FileTime
- Все реализованные интерфейсы:
Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
modified, accessed или created. Экземпляры этого класса неизменяемы.
- С:
- 1.7
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
int |
compareTo |
Сравнивает значения двух FileTime объектов по порядку. |
boolean |
equals |
Проверяет это FileTime на равенство с заданным объектом. |
static FileTime |
from |
Возвращает FileTime , представляющий значение с заданной точностью. |
static FileTime |
from |
Возвращает FileTime , представляющий ту же точку времени на временной шкале, что и предоставленный Instant объект. |
static FileTime |
fromMillis |
Возвращает FileTime , представляющий данное значение в миллисекундах. |
int |
hashCode() |
Вычисляет хэш-код для этого времени файла. |
long |
to |
Возвращает значение с заданной точностью. |
Instant |
toInstant() |
Преобразует этот FileTime объект в Instant. |
long |
toMillis() |
Возвращает значение в миллисекундах. |
String |
toString() |
Возвращает строковое представление этого FileTime. |
Подробное описание методов
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, представляющим то же время - См. также:
hashCode
public int hashCode()
Хэш-код основан на представляемом значении и удовлетворяет общему контракту метода Object.hashCode().
- Overrides:
-
hashCodeв классе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, 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