クラスFileTime

java.lang.Object
java.nio.file.attribute.FileTime
すべての実装されたインタフェース:
Comparable<FileTime>
public final class FileTime extends Object implements Comparable<FileTime>
ファイルのタイ スタンプ属性の値を表します。 たとえば、ファイルが最後に変更、アクセス、または作成された時間を表すことがあります。

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

導入されたバージョン:
1.7
関連 目:

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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の文字列表現を返します。

    クラス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)
      時系列上で、指定された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
      関連 目:

    • hashCode

      public int hashCode()
      このファイル時間のハッシュ・コードを計算します。

      ハッシュ・コードは、表現された値に基づいており、Object.hashCode()メソッドの汎用規約を満たします。

      オーバーライド:
      hashCode、クラス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
      戻り値:
      このファイル時間の文字列表現
      外部仕様