public final class FileTime extends Object implements Comparable<FileTime>
| Modifier and Type | Method and Description | 
|---|---|
| int | compareTo(FileTime other)Compares the value of two  FileTimeobjects for order. | 
| boolean | equals(Object obj)Tests this  FileTimefor equality with the given object. | 
| static FileTime | from(Instant instant)Returns a  FileTimerepresenting the same point of time value
 on the time-line as the providedInstantobject. | 
| static FileTime | from(long value,
    TimeUnit unit)Returns a  FileTimerepresenting a value at the given unit of
 granularity. | 
| static FileTime | fromMillis(long value)Returns a  FileTimerepresenting 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  FileTimeobject to anInstant. | 
| 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.
equals in class Objectobj - the object to compare withtrue if, and only if, the given object is a FileTime that represents the same timeObject.hashCode(), 
HashMappublic int hashCode()
 The hash code is based upon the value represented, and satisfies the
 general contract of the Object.hashCode() method.
hashCode in class ObjectObject.equals(java.lang.Object), 
System.identityHashCode(java.lang.Object)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 otherpublic String toString()
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".
 Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2025, Oracle and/or its affiliates.  All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.