# Print output for @column tags ?>
Developers

- Design
- Develop
- Distribute

Developer Console

## Most visited

## Recently visited

## Results for

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 timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void` | `wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void` | `wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
From interface `java.lang.Comparable`
`abstract int` | `compareTo(FileTime o)` Compares this object with the specified object for order.

## Public methods

### compareTo

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

Full name *
Email address *
Company / developer name
One of your Play Store app URLs *
Which best describes your business:*
Apps
Games
Apps & Games
*
*