Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
modified
, accessed
, or created
. Instances of this class are immutable.
Modifier and Type | Method | Description |
---|---|---|
int |
compareTo |
Compares the value of two FileTime objects for order. |
boolean |
equals |
Tests this FileTime for equality with the given object. |
static FileTime |
from |
Returns a FileTime representing a value at the given unit of granularity. |
static FileTime |
from |
Returns a FileTime representing the same point of time value on the time-line as the provided Instant object. |
static FileTime |
fromMillis |
Returns a FileTime representing the given value in milliseconds. |
int |
hashCode() |
Computes a hash code for this file time. |
long |
to |
Returns the value at the given unit of granularity. |
Instant |
toInstant() |
Converts this FileTime object to an Instant . |
long |
toMillis() |
Returns the value in milliseconds. |
String |
toString() |
Returns the string representation of this FileTime . |
public static FileTime from(long value, TimeUnit unit)
FileTime
representing a value at the given unit of granularity.value
- the value since the epoch (1970-01-01T00:00:00Z); can be negativeunit
- the unit of granularity to interpret the valueFileTime
representing the given valuepublic static FileTime fromMillis(long value)
FileTime
representing the given value in milliseconds.value
- the value, in milliseconds, since the epoch (1970-01-01T00:00:00Z); can be negativeFileTime
representing the given valuepublic static FileTime from(Instant instant)
FileTime
representing the same point of time value on the time-line as the provided Instant
object.instant
- the instant to convertFileTime
representing the same point on the time-line as the provided instantpublic long to(TimeUnit unit)
Conversion from a coarser granularity that would numerically overflow saturate to Long.MIN_VALUE
if negative or Long.MAX_VALUE
if positive.
unit
- the unit of granularity for the return valuepublic long toMillis()
Conversion from a coarser granularity that would numerically overflow saturate to Long.MIN_VALUE
if negative or Long.MAX_VALUE
if positive.
public Instant toInstant()
FileTime
object to an Instant
. The conversion creates an Instant
that represents the same point on the time-line as this FileTime
.
FileTime
can store points on the time-line further in the future and further in the past than Instant
. Conversion from such further time points saturates to Instant.MIN
if earlier than Instant.MIN
or Instant.MAX
if later than Instant.MAX
.
FileTime
objectpublic boolean equals(Object obj)
FileTime
for equality with the given object. The result is true
if and only if the argument is not
null
and is a FileTime
that represents the same time. This method satisfies the general contract of the Object.equals
method.
public int hashCode()
The hash code is based upon the value represented, and satisfies the general contract of the Object.hashCode()
method.
public int compareTo(FileTime other)
FileTime
objects for order.compareTo
in interface Comparable<FileTime>
other
- the other FileTime
to be compared0
if this FileTime
is equal to other
, a value less than 0 if this FileTime
represents a time that is before other
, and a value greater than 0 if this FileTime
represents a time that is after other
public String toString()
FileTime
. The string is returned in the ISO 8601 format: YYYY-MM-DDThh:mm:ss[.s+]Zwhere "
[.s+]
" represents a dot followed by one of more digits for the decimal fraction of a second. It is only present when the decimal fraction of a second is not zero. For example,
FileTime.fromMillis(1234567890000L).toString()
yields
"2009-02-13T23:31:30Z"
, and FileTime.fromMillis(1234567890123L).toString()
yields "2009-02-13T23:31:30.123Z"
. A FileTime
is primarily intended to represent the value of a file's time stamp. Where used to represent extreme values, where the year is less than "0001
" or greater than "9999
" then this method deviates from ISO 8601 in the same manner as the XML Schema language. That is, the year may be expanded to more than four digits and may be negative-signed. If more than four digits then leading zeros are not present. The year before "0001
" is "-0001
".
© 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