Added in API level 26

Summary: Methods | Inherited Methods

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.

See also:

• Files.setLastModifiedTime(Path, FileTime)
• Files.getLastModifiedTime(Path, LinkOption)

Summary

Public methods
int	compareTo(FileTime other) Compares the value of two FileTime objects for order.
boolean	equals(Object obj) Tests this FileTime for equality with the given object.
static FileTime	from(Instant instant) Returns a FileTime representing the same point of time value on the time-line as the provided Instant object.
static FileTime	from(long value, TimeUnit unit) Returns a FileTime representing a value at the given unit of granularity.
static FileTime	fromMillis(long value) Returns a FileTime representing the given value in milliseconds.
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 FileTime object to an Instant.
long	toMillis() Returns the value in milliseconds.
String	toString() Returns the string representation of this FileTime.

Inherited methods
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
From interface java.lang.Comparable abstract int compareTo(FileTime o) Compares this object with the specified object for order.

Public methods

compareTo

Added in API level 26

public 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

Added in API level 26

public 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

Added in API level 26

public static FileTime from (Instant instant)

Returns a FileTime representing the same point of time value on the time-line as the provided Instant object.

Parameters
instant	Instant: the instant to convert

Returns
FileTime	a FileTime representing the same point on the time-line as the provided instant

from

Added in API level 26

public static 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 (1970-01-01T00:00:00Z); can be negative
unit	TimeUnit: the unit of granularity to interpret the value

Returns
FileTime	a FileTime representing the given value

fromMillis

Added in API level 26

public static FileTime fromMillis (long value)

Returns a FileTime representing the given value in milliseconds.

Parameters
value	long: the value, in milliseconds, since the epoch (1970-01-01T00:00:00Z); can be negative

Returns
FileTime	a FileTime representing the given value

hashCode

Added in API level 26

public 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 Object.hashCode method.

Returns
int	the hash-code value

to

Added in API level 26

public 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 (1970-01-01T00:00:00Z); can be negative

toInstant

Added in API level 26

public Instant toInstant ()

Converts this 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.

Returns
Instant	an instant representing the same point on the time-line as this FileTime object

toMillis

Added in API level 26

public 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 (1970-01-01T00:00:00Z)

toString

Added in API level 26

public String toString ()

Returns the string representation of this FileTime. The string is returned in the ISO 8601 format:

     YYYY-MM-DDThh:mm:ss[.s+]Z
 

where "[.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".

Returns
String	the string representation of this file time