模块 java.base
包 java.nio.file.attribute

类 FileTime

java.lang.Object
java.nio.file.attribute.FileTime
所有已实现的接口：
Comparable<FileTime>
public final class FileTime extends Object implements Comparable <FileTime >
表示文件时间戳属性的值。例如，它可能表示文件最后一个时间 modified 、 accessed 或 created 。

此类的实例是不可变的。

自从：
1.7
参见：

  • 方法总结

    修饰符和类型
    方法
    描述
    int
    compareTo(FileTime other)
    比较两个 FileTime 对象的值以获得顺序。
    boolean
    equals(Object obj)
    测试此 FileTime 是否与给定对象相等。
    static FileTime
    from(long value, TimeUnit unit)
    返回一个 FileTime 表示给定粒度单位的值。
    static FileTime
    from(Instant instant)
    返回一个 FileTime 表示时间线上与提供的 Instant 对象相同的时间点值。
    static FileTime
    fromMillis(long value)
    返回一个 FileTime 表示以毫秒为单位的给定值。
    int
    hashCode()
    计算此文件时间的哈希码。
    long
    to(TimeUnit unit)
    返回给定粒度单位的值。
    Instant
    toInstant()
    将此 FileTime 对象转换为 Instant 。
    long
    toMillis()
    以毫秒为单位返回值。
    String
    toString()
    返回此 FileTime 的字符串表示形式。

    在类 java.lang.Object 中声明的方法

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • 方法详情

    • from

      public static FileTime  from(long value, TimeUnit  unit)
      返回一个 FileTime 表示给定粒度单位的值。
      参数：
      value - 自纪元 (1970-01-01T00:00:00Z) 以来的值；可以是负的
      unit - 解释值的粒度单位
      返回：
      一个 FileTime 表示给定值

    • fromMillis

      public static FileTime  fromMillis(long value)
      返回一个 FileTime 表示以毫秒为单位的给定值。
      参数：
      value - 自纪元 (1970-01-01T00:00:00Z) 以来的值，以毫秒为单位；可以是负的
      返回：
      一个 FileTime 表示给定值

    • from

      public static FileTime  from(Instant  instant)
      返回一个 FileTime 表示时间线上与提供的 Instant 对象相同的时间点值。
      参数：
      instant - 转换的瞬间
      返回：
      FileTime 表示时间线上与提供的时刻相同的点
      自从：
      1.8

    • to

      public long to(TimeUnit  unit)
      返回给定粒度单位的值。

      如果是负数，则从数值溢出饱和到 Long.MIN_VALUE 或正数到 Long.MAX_VALUE 的较粗粒度转换。

      参数：
      unit - 返回值的粒度单位
      返回：
      给定粒度单位的值，自纪元以来的纪元 (1970-01-01T00:00:00Z)；可以是负的

    • toMillis

      public long toMillis()
      以毫秒为单位返回值。

      如果是负数，则从数值溢出饱和到 Long.MIN_VALUE 或正数到 Long.MAX_VALUE 的较粗粒度转换。

      返回：
      自纪元 (1970-01-01T00:00:00Z) 以来的毫秒值

    • toInstant

      public Instant  toInstant()
      将此 FileTime 对象转换为 Instant 。

      转换创建一个 Instant 代表时间线上与此 FileTime 相同的点。

      FileTime 可以在时间线上存储比 Instant 更远的未来和更远的时间点。如果早于 Instant.MIN 或 Instant.MAX （如果晚于 Instant.MAX），则从此类进一步时间点的转换饱和到 Instant.MIN 。

      返回：
      代表时间线上与此 FileTime 对象相同的点的瞬间
      自从：
      1.8

    • equals

      public boolean equals(Object  obj)
      测试此 FileTime 是否与给定对象相等。

      当且仅当参数不是 null 并且是表示相同时间的 FileTime 时，结果为 true。此方法满足Object.equals 方法的一般契约。

      重写：
      equals 在类 Object 中
      参数：
      obj - 要与之比较的对象
      返回：
      true 当且仅当给定对象是代表同一时间的 FileTime
      参见：

    • hashCode

      public int hashCode()
      计算此文件时间的哈希码。

      哈希码基于表示的值，并满足 Object.hashCode() 方法的一般约定。

      重写：
      hashCode 在类 Object 中
      返回：
      哈希码值
      参见：

    • compareTo

      public int compareTo(FileTime  other)
      比较两个 FileTime 对象的值以获得顺序。
      指定者：
      compareTo 在接口 Comparable<FileTime> 中
      参数：
      other - 要比较的另一个 FileTime
      返回：
      0 如果此 FileTime 等于 other ，如果此 FileTime 表示时间早于 other，则值小于 0，如果此 FileTime 表示时间在 other 之后，则值大于 0

    • toString

      public String  toString()
      返回此 FileTime 的字符串表示形式。该字符串以 ISO 8601 格式返回： 
         YYYY-MM-DDThh:mm:ss[.s+]Z
      其中“[.s+] ”表示一个点，后跟一个多位数字中的一个表示秒的小数部分。它仅在秒的小数部分不为零时出现。例如， FileTime.fromMillis(1234567890000L).toString() 产生 "2009-02-13T23:31:30Z"，FileTime.fromMillis(1234567890123L).toString() 产生 "2009-02-13T23:31:30.123Z"。

      FileTime 主要用于表示文件时间戳的值。用于表示的地方极端值，如果年份小于“0001”或大于“9999”，则此方法以与 XML模式语言 相同的方式偏离 ISO 8601。也就是说，年份可能会扩展到四位以上，并且可能是负号的。如果多于四位数字，则不存在前导零。 “0001”之前的年份是“-0001”。

      重写：
      toString 在类 Object 中
      返回：
      此文件时间的字符串表示