java.nio.file.attribute

Class FileTime

    • Method Detail

      • from

        public static FileTime from(long value,
                    TimeUnit unit)
        Returns a FileTime representing a value at the given unit of granularity.
        Parameters:
        value - the value since the epoch (1970-01-01T00:00:00Z); can be negative
        unit - the unit of granularity to interpret the value
        Returns:
        a FileTime representing the given value
      • fromMillis

        public static FileTime fromMillis(long value)
        Returns a FileTime representing the given value in milliseconds.
        Parameters:
        value - the value, in milliseconds, since the epoch (1970-01-01T00:00:00Z); can be negative
        Returns:
        a FileTime representing the given 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 - the unit of granularity for the return value
        Returns:
        value in the given unit of granularity, since the epoch since the epoch (1970-01-01T00:00:00Z); can be negative
      • 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:
        the value in milliseconds, since the epoch (1970-01-01T00:00:00Z)
      • 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.

        Overrides:
        equals in class Object
        Parameters:
        obj - the object to compare with
        Returns:
        true if, and only if, the given object is a FileTime that represents the same time
        See Also:
        Object.hashCode(), HashMap
      • compareTo

        public int compareTo(FileTime other)
        Compares the value of two FileTime objects for order.
        Specified by:
        compareTo in interface Comparable<FileTime>
        Parameters:
        other - the other FileTime to be compared
        Returns:
        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
      • 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".

        Overrides:
        toString in class Object
        Returns:
        the string representation of this file time

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/nio/file/attribute/filetime.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut