Module  java.base

Class FileTime

    • 方法详细信息

      • 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.MINInstant.MAX如果迟于Instant.MAX

        结果
        表示与 FileTime对象在时间线上相同点的瞬间
        从以下版本开始:
        1.8
      • equals

        public boolean equals​(Object obj)
        测试此FileTime与给定对象的相等性。

        当且仅当该参数不是null且为代表同一时间的FileTime ,结果为true 该方法满足Object.equals方法的一般合同。

        重写:
        equalsObject
        参数
        obj - 要比较的对象
        结果
        true如果,只有当给定的对象是代表同一时间的 FileTime
        另请参见:
        Object.hashCode()HashMap
      • compareTo

        public int compareTo​(FileTime other)
        比较两个 FileTime对象的值进行排序。
        Specified by:
        compareTo在接口 Comparable<FileTime>
        参数
        other - 另外 FileTime要进行比较
        结果
        0如果这个 FileTime等于 other ,如果这个 FileTime表示 other之前的时间,则该值小于0,如果此 FileTime表示 other之后的 other
      • toString

        public String toString​()
        返回此FileTime的字符串表示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"

        A FileTime主要用于表示文件时间戳的值。 如果用于表示极值 ,如果该年度小于“ 0001 ”或大于“ 9999 ”,则该方法与XML Schema language相同,偏离ISO 8601。 也就是说,年份可能会扩大到四位以上,可能是负号。 如果超过四位数,则前导零不存在。 前一年“ 0001 ”为“ -0001 ”。

        重写:
        toString在类 Object
        结果
        the string representation of this file time