- 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 方法 描述 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
的字符串表示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
”。
-
-