- java.lang.Object
-
- java.nio.file.attribute.FileTime
-
- すべての実装されたインタフェース:
Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
-
-
メソッドのサマリー
すべてのメソッド 静的メソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 int
compareTo(FileTime other)
2つのFileTime
オブジェクトの値の順番を比較します。boolean
equals(Object obj)
このFileTime
が指定されたオブジェクトと等しいかどうかを判定します。static FileTime
from(long value, TimeUnit unit)
指定された粒度単位で値を表すFileTime
を返します。static FileTime
from(Instant instant)
時系列上で、指定されたInstant
オブジェクトと同じ時点の値を表すFileTime
を返します。static FileTime
fromMillis(long value)
指定された値をミリ秒単位で表すFileTime
を返します。int
hashCode()
このファイル時間のハッシュ・コードを計算します。long
to(TimeUnit unit)
指定された粒度単位で値を返します。Instant
toInstant()
このFileTime
オブジェクトをInstant
に変換します。long
toMillis()
値をミリ秒単位で返します。String
toString()
この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)
時系列上で、指定されたInstant
オブジェクトと同じ時点の値を表すFileTime
を返します。- パラメータ:
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
に変換します。変換によって、この
FileTime
と同じ時系列上の時点を表すInstant
が作成されます。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
- 比較対象のオブジェクト- 戻り値:
- 指定されたオブジェクトが、同じ時間を表す
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
」です。
-
-