FileTime
public
final
class
FileTime
extends Object
implements
Comparable<FileTime>
java.lang.Object  
↳  java.nio.file.attribute.FileTime 
Represents the value of a file's time stamp attribute. For example, it may
represent the time that the file was last
modified
,
accessed
,
or created
.
Instances of this class are immutable.
Summary
Public methods  

int

compareTo(FileTime other)
Compares the value of two 
boolean

equals(Object obj)
Tests this 
static
FileTime

from(Instant instant)
Returns a 
static
FileTime

from(long value, TimeUnit unit)
Returns a 
static
FileTime

fromMillis(long value)
Returns a 
int

hashCode()
Computes a hash code for this file time. 
long

to(TimeUnit unit)
Returns the value at the given unit of granularity. 
Instant

toInstant()
Converts this 
long

toMillis()
Returns the value in milliseconds. 
String

toString()
Returns the string representation of this 
Inherited methods  

Public methods
compareTo
int compareTo (FileTime other)
Compares the value of two FileTime
objects for order.
Parameters  

other 
FileTime : the other FileTime to be compared 
Returns  

int 
0 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

equals
boolean equals (Object obj)
Tests this 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.
Parameters  

obj 
Object : the object to compare with 
Returns  

boolean 
true if, and only if, the given object is a FileTime that represents the same time

from
FileTime from (Instant instant)
Returns a FileTime
representing the same point of time value
on the timeline as the provided Instant
object.
Parameters  

instant 
Instant : the instant to convert 
Returns  

FileTime 
a FileTime representing the same point on the timeline
as the provided instant 
from
FileTime from (long value, TimeUnit unit)
Returns a FileTime
representing a value at the given unit of
granularity.
Parameters  

value 
long : the value since the epoch (19700101T00:00:00Z); can be
negative 
unit 
TimeUnit : the unit of granularity to interpret the value 
Returns  

FileTime 
a FileTime representing the given value

fromMillis
FileTime fromMillis (long value)
Returns a FileTime
representing the given value in milliseconds.
Parameters  

value 
long : the value, in milliseconds, since the epoch
(19700101T00:00:00Z); can be negative 
Returns  

FileTime 
a FileTime representing the given value

hashCode
int hashCode ()
Computes a hash code for this file time.
The hash code is based upon the value represented, and satisfies the
general contract of the hashCode()
method.
Returns  

int 
the hashcode value 
to
long to (TimeUnit unit)
Returns the value at the given unit of granularity.
Conversion from a coarser granularity that would numerically overflow
saturate to Long.MIN_VALUE
if negative or Long.MAX_VALUE
if positive.
Parameters  

unit 
TimeUnit : the unit of granularity for the return value 
Returns  

long 
value in the given unit of granularity, since the epoch since the epoch (19700101T00:00:00Z); can be negative 
toInstant
Instant toInstant ()
Converts this FileTime
object to an Instant
.
The conversion creates an Instant
that represents the
same point on the timeline as this FileTime
.
FileTime
can store points on the timeline further in the
future and further in the past than Instant
. Conversion
from such further time points saturates to MIN
if
earlier than Instant.MIN
or MAX
if later
than Instant.MAX
.
Returns  

Instant 
an instant representing the same point on the timeline as
this FileTime object 
toMillis
long toMillis ()
Returns the value in milliseconds.
Conversion from a coarser granularity that would numerically overflow
saturate to Long.MIN_VALUE
if negative or Long.MAX_VALUE
if positive.
Returns  

long 
the value in milliseconds, since the epoch (19700101T00:00:00Z) 
toString
String toString ()
Returns the string representation of this FileTime
. The string
is returned in the ISO 8601 format:
YYYYMMDDThh: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 "20090213T23:31:30Z"
, and FileTime.fromMillis(1234567890123L).toString()
yields "20090213T23: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 negativesigned. If more than four digits then leading zeros
are not present. The year before "0001
" is "0001
".
Returns  

String 
the string representation of this file time 