compact1, compact2, compact3

java.nio.file.attribute

Class FileTime

java.lang.Object

java.nio.file.attribute.FileTime

All Implemented Interfaces:

Comparable FileTime > <

public final class FileTime
extends Object
implements Comparable<FileTime>

表示一个文件的时间戳属性的值。例如，它可能代表了文件的最后 modified， accessed时间，或 created。

这个类的实例是不可变的。

从以下版本开始：

一点七

另请参见：

Files.setLastModifiedTime(java.nio.file.Path, java.nio.file.attribute.FileTime)， Files.getLastModifiedTime(java.nio.file.Path, java.nio.file.LinkOption...)

方法摘要

Modifier and Type	Method and Description
int	compareTo(FileTime other) 比较两 FileTime对象的秩序价值。
boolean	equals(Object obj) 这 FileTime试验与给定对象的平等。
static FileTime	from(Instant instant) 返回一个 FileTime代表同一时间点的价值在时间线提供的 Instant对象。
static FileTime	from(long value, TimeUnit unit) 返回一个 FileTime代表一个值在给定的粒度单位。
static FileTime	fromMillis(long value) 返回一个 FileTime表示给定值以毫秒为单位。
int	hashCode() 计算此文件时间的哈希代码。
long	to(TimeUnit unit) 返回给定粒度单位的值。
Instant	toInstant() 将这一 Instant FileTime对象。
long	toMillis() 以毫秒为单位返回值。
String	toString() 这 FileTime返回的字符串表示形式。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

方法详细信息

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代表时间轴上的同一点作为提供即时

从以下版本开始：

一点八

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()

将这一 Instant FileTime对象。

转换创建一个Instant代表时间轴上的同一点为这FileTime。

FileTime可以存储点的时间线进一步在未来比过去的Instant。从进一步的时间点转换饱和Instant.MIN如果早于或晚于Instant.MAX Instant.MIN Instant.MAX如果。

结果

瞬间表现对时间线的同一点为这 FileTime对象

从以下版本开始：

一点八

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返回的字符串表示形式。字符串在 ISO 8601格式返回：

yyyy mm ddthh：MM：SS [的] 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 language，今年可能会扩大到超过四位数，可能负符号。如果超过四个数字，则前导零是不存在的。在“0001”是“-0001年”。

产量。

重写：

toString 方法重写，继承类 Object

结果

此文件时间的字符串表示形式