java.nio.file.attribute

クラス FileTime

java.lang.Object

java.nio.file.attribute.FileTime

すべての実装されたインタフェース:

Comparable<FileTime>

public final class FileTime
extends Object
implements Comparable<FileTime>

ファイルのタイムスタンプ属性の値を表します。たとえば、ファイルが最後に変更、アクセス、または作成された時間を表すことがあります。

このクラスのインスタンスは不変です。

導入されたバージョン:

1.7

関連項目:

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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
int	compareTo(FileTime other) 2 つの FileTime オブジェクトの値の順番を比較します。
boolean	equals(Object obj) この FileTime が指定されたオブジェクトと等しいかどうかを判定します。
static FileTime	from(long value, TimeUnit unit) 指定された粒度単位で値を表す FileTime を返します。
static FileTime	fromMillis(long value) 指定された値をミリ秒単位で表す FileTime を返します。
int	hashCode() このファイル時間のハッシュコードを計算します。
long	to(TimeUnit unit) 指定された粒度単位で値を返します。
long	toMillis() 値をミリ秒単位で返します。
String	toString() この FileTime の文字列表現を返します。

クラス 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

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) からのミリ秒単位の値

equals

public boolean equals(Object obj)

この FileTime が指定されたオブジェクトと等しいかどうかを判定します。

結果が true になるのは、引数が null ではなく、同じ時間を表す FileTime である場合だけです。このメソッドは Object.equals の汎用規約を満たします。

オーバーライド:

equals、クラス: Object

パラメータ:

obj - 比較対象のオブジェクト

戻り値:

指定されたオブジェクトが、同じ時間を表す FileTime である場合にかぎり true

関連項目:

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)

2 つの FileTime オブジェクトの値の順番を比較します。

定義:

compareTo、インタフェース: Comparable<FileTime>

パラメータ:

other - 比較対象の他方の FileTime

戻り値:

この FileTime が other に等しい場合は 0。この FileTime が other よりも前の時間を表す場合は 0 より小さい値。この FileTime が other よりもあとの時間を表す場合は 0 よりも大きい値

toString

public String toString()

この FileTime の文字列表現を返します。その文字列は、次の ISO 8601 形式で返されます。

     YYYY-MM-DDThh:mm:ss[.s+]Z
 

ここでの「[.s+]」は、ドットと、それに続く秒の小数部を表す 1 つまたは複数の数字を示しています。それは、秒の小数部がゼロでない場合にのみ表示されます。たとえば、FileTime.fromMillis(1234567890000L).toString() は "2009-02-13T23:31:30Z" となり、FileTime.fromMillis(1234567890123L).toString() は "2009-02-13T23:31:30.123Z" となります。

FileTime は主に、ファイルのタイムスタンプの値を表すためのものです。極値を表すために使用される場合、年が「0001」よりも小さいか、「9999」よりも大きい場合、このメソッドは XML スキーマ言語と同じ方法で ISO 8601 から逸脱します。つまり、年が 5 桁以上に拡張されることがあったり、マイナスの符号付きになったりすることがあります。5 桁以上の場合、先頭の 0 は表示されません。「0001」の前の年は「-0001」です。

オーバーライド:

toString、クラス: Object

戻り値:

このファイル時間の文字列表現