Module java.base
Package java.nio.file.attribute

Class FileTime

java.lang.Object
java.nio.file.attribute.FileTime
所有已实现的接口:
Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
表示文件时间戳属性的值。例如，它可以表示文件上次修改、访问或创建的时间。

此类的实例是不可变的。

自:
1.7
参见:

  • Method Details

    • 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)
      返回表示与提供的Instant对象在时间线上相同时间点的FileTime。
      参数:
      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。

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

      FileTime可以存储比Instant更远的未来和过去的时间点。从这些更远的时间点转换会饱和为Instant.MIN（如果早于Instant.MIN）或Instant.MAX（如果晚于Instant.MAX）。

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

    • equals

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

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

      覆盖:
      equals 在类 Object中
      参数:
      obj - 要比较的对象
      返回:
      如果给定对象是代表相同时间的FileTime，则返回true
      参见:

    • hashCode

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

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

      覆盖:
      hashCode 在类 Object中
      返回:
      哈希码值
      参见:

    • compareTo

      public int compareTo(FileTime other)
      比较两个FileTime对象的值以确定顺序。
      指定者:
      compareTo 在接口 Comparable<FileTime>中
      参数:
      other - 要比较的另一个FileTime
      返回:
      如果此FileTime等于other，则返回0；如果此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"，则此方法与ISO 8601的偏差与XML Schema语言相同。也就是说，年份可能扩展为超过四位数，可能为负数。如果超过四位数，则不会出现前导零。"0001"之前的年份为"-0001"。

      覆盖:
      toString 在类 Object中
      返回:
      此文件时间的字符串表示形式
      外部规范