- java.lang.Object
-
- java.nio.file.attribute.FileTime
-
- 实现的所有接口
-
Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 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
与给定对象的相等性。结果是
true
当且仅当参数不是null
并且是FileTime
,表示同一时间。 该方法满足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
,一个小于0的值,如果这FileTime
表示时间即前other
,和大于0的值,如果这个FileTime
表示时间,该时间之后other
-
toString
public String toString()
返回此FileTime
的字符串表示FileTime
。 该字符串以ISO 8601格式返回:YYYY-MM-DDThh:mm:ss[.s+]Z
其中“[.s+]
”表示一个点,后跟一个或多个小数位数的[.s+]
。 仅当秒的小数部分不为零时才存在。 例如,FileTime.fromMillis(1234567890000L).toString()
得到"2009-02-13T23:31:30Z"
,和FileTime.fromMillis(1234567890123L).toString()
得到"2009-02-13T23:31:30.123Z"
。FileTime
主要用于表示文件时间戳的值。 如果用于表示极值 ,其中年份小于“0001
”或大于“9999
”,则此方法与9999
方式不同,与ISO 8601 不同 。 也就是说,年份可能会扩展到超过四位数,并且可能是负面签名的。 如果超过四位数,则不存在前导零。 “0001
”前一年是“-0001
”。
-
-