Класс FileTime
- Все реализованные интерфейсы:
Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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, представляющий ту же точку на временной шкале, что и предоставленный объект 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, представляющим то же время - См. также:
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, 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