- java.lang.Object
-
- java.nio.file.attribute.FileTime
-
- All Implemented Interfaces:
-
Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
-
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 intcompareTo(FileTime other)比较两个FileTime对象的价值。booleanequals(Object obj)测试此FileTime与给定对象的相等性。static FileTimefrom(long value, TimeUnit unit)返回一个FileTime表示给定的粒度单位的值。static FileTimefrom(Instant instant)返回一个FileTime表示与所提供的Instant对象相同的时间点值。static FileTimefromMillis(long value)返回一个FileTime,以毫秒为单位表示给定值。inthashCode()计算此文件时间的哈希码。longto(TimeUnit unit)返回给定的粒度单位的值。InstanttoInstant()将此FileTime对象转换为Instant。longtoMillis()返回以毫秒为单位的值。StringtoString()返回此FileTime的字符串表示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.MIN或Instant.MAX如果迟于Instant.MAX。- 结果
-
表示与
FileTime对象在时间线上相同点的瞬间 - 从以下版本开始:
- 1.8
-
equals
public boolean equals(Object obj)
测试此FileTime与给定对象的相等性。当且仅当该参数不是
null且为代表同一时间的FileTime,结果为true。 该方法满足Object.equals方法的一般合同。- 重写:
-
equals在Object - 参数
-
obj- 要比较的对象 - 结果
-
true如果,只有当给定的对象是代表同一时间的FileTime - 另请参见:
-
Object.hashCode(),HashMap
-
hashCode
public int hashCode()
计算此文件时间的哈希码。哈希码基于所表示的值,并满足
Object.hashCode()方法的一般合同。- 重写:
-
hashCode在Object - 结果
- 散列码值
- 另请参见:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
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”。
-
-