モジュール java.base
パッケージ java.time.temporal

列挙型ChronoUnit

java.lang.Object
java.lang.Enum<ChronoUnit>
java.time.temporal.ChronoUnit
すべての実装されたインタフェース:
Serializable, Comparable<ChronoUnit>, Constable, TemporalUnit
public enum ChronoUnit
extends Enum<ChronoUnit>
implements TemporalUnit
日付期間の単位の標準セット。

この単位セットは、日付、時間、または日付/時間を操作するための単位ベースのアクセスを提供します。 標準の単位セットは、TemporalUnitを実装することによって拡張できます。

これらの単位は、複数の暦体系に適用できると想定されています。 たとえば、ISO以外の暦体系の多くは、ルールは多少異なっても、年、月、および日の単位を定義しています。 各単位のドキュメントには、その単位の動作が説明されています。

実装要件:
これは不変でスレッドセーフな最終の列挙型です。
導入されたバージョン:
1.8

  • ネストされたクラスのサマリー

    クラスjava.lang.Enumで宣言されたネストされたクラス/インタフェース

    Enum.EnumDesc<E extends Enum<E>>

  • 列挙型定数のサマリー

    列挙型定数 
    列挙型定数 説明
    CENTURIES
    1世紀の概念を表す単位。
    DAYS
    1日の概念を表す単位。
    DECADES
    1デケイドの概念を表す単位。
    ERAS
    1紀元の概念を表す単位。
    FOREVER
    永遠の概念を表す人為的単位。
    HALF_DAYS
    午前/午後で使用される半日の概念を表す単位。
    HOURS
    1時間の概念を表す単位。
    MICROS
    1マイクロ秒の概念を表す単位。
    MILLENNIA
    1ミレニアムの概念を表す単位。
    MILLIS
    1ミリ秒の概念を表す単位。
    MINUTES
    1分の概念を表す単位。
    MONTHS
    1か月の概念を表す単位。
    NANOS
    1ナノ秒の概念を表す単位。サポートされている最小の時間単位。
    SECONDS
    1秒の概念を表す単位。
    WEEKS
    1週の概念を表す単位。
    YEARS
    1年の概念を表す単位。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    Duration getDuration()
    ISO暦体系におけるこの単位の推定デュレーションを取得します。
    boolean isDateBased()
    この単位が日付の単位かどうかをチェックします。
    boolean isDurationEstimated()
    単位のデュレーションが推定値かどうかをチェックします。
    boolean isTimeBased()
    この単位が時間の単位かどうかをチェックします。
    static ChronoUnit valueOf​(String name)
    指定された名前を持つ、この型の列挙型定数を返します。
    static ChronoUnit[] values()
    この列挙型の定数を含む配列を、宣言されている順序で返します。

    クラス java.lang.Enumで宣言されたメソッド

    clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

    クラス java.lang.Objectで宣言されたメソッド

    getClass、notify、notifyAll、wait、wait、wait

    インタフェース java.time.temporal.TemporalUnitで宣言されたメソッド

    addTo, between, isSupportedBy, toString

  • 列挙型定数の詳細

    • NANOS

      public static final ChronoUnit NANOS
      1ナノ秒の概念を表す単位。サポートされている最小の時間単位。 ISO暦体系の場合、これは秒の単位の1,000,000,000分の1と等しくなります。

    • MICROS

      public static final ChronoUnit MICROS
      1マイクロ秒の概念を表す単位。 ISO暦体系の場合、これは秒の単位の1,000,000分の1と等しくなります。

    • MILLIS

      public static final ChronoUnit MILLIS
      1ミリ秒の概念を表す単位。 ISO暦体系の場合、これは秒の単位の1000分の1と等しくなります。

    • SECONDS

      public static final ChronoUnit SECONDS
      1秒の概念を表す単位。 ISO暦体系の場合、うるう秒を除いて、これはSI単位系の秒と等しくなります。

    • MINUTES

      public static final ChronoUnit MINUTES
      1分の概念を表す単位。 ISO暦体系の場合、これは60秒と等しくなります。

    • HOURS

      public static final ChronoUnit HOURS
      1時間の概念を表す単位。 ISO暦体系の場合、これは60分と等しくなります。

    • HALF_DAYS

      public static final ChronoUnit HALF_DAYS
      午前/午後で使用される半日の概念を表す単位。 ISO暦体系の場合、これは12時間と等しくなります。

    • DAYS

      public static final ChronoUnit DAYS
      1日の概念を表す単位。 ISO暦体系の場合、これは深夜零時から深夜零時までの標準的な1日です。 1日の推定デュレーションは24時間です。

      他の暦体系で使用される場合、これは地球上の日の出と日の入りによって定義される日に対応する必要があります。 日が深夜零時に始まる必要はありません。暦体系の間の変換では、日付は正午において等価になるべきです。

    • WEEKS

      public static final ChronoUnit WEEKS
      1週の概念を表す単位。 ISO暦体系の場合、これは7日と等しくなります。

      他の暦体系で使用される場合、これは整数の日数に対応する必要があります。

    • MONTHS

      public static final ChronoUnit MONTHS
      1か月の概念を表す単位。 ISO暦体系の場合、1か月の長さは月によって異なります。 1か月の推定デュレーションは365.2425日の12分の1です。

      他の暦体系で使用される場合、これは整数の日数に対応する必要があります。

    • YEARS

      public static final ChronoUnit YEARS
      1年の概念を表す単位。 ISO暦体系の場合、これは12か月と等しくなります。 1年の推定デュレーションは365.2425日です。

      他の暦体系で使用される場合、これは太陽を中心とした地球の周回によって定義される1年にほぼ等しい、整数の日数または月数に対応する必要があります。

    • DECADES

      public static final ChronoUnit DECADES
      1デケイドの概念を表す単位。 ISO暦体系の場合、これは10年と等しくなります。

      他の暦体系で使用される場合、これは整数の日数に対応する必要があり、通常は整数の年数です。

    • CENTURIES

      public static final ChronoUnit CENTURIES
      1世紀の概念を表す単位。 ISO暦体系の場合、これは100年と等しくなります。

      他の暦体系で使用される場合、これは整数の日数に対応する必要があり、通常は整数の年数です。

    • MILLENNIA

      public static final ChronoUnit MILLENNIA
      1ミレニアムの概念を表す単位。 ISO暦体系の場合、これは1000年と等しくなります。

      他の暦体系で使用される場合、これは整数の日数に対応する必要があり、通常は整数の年数です。

    • ERAS

      public static final ChronoUnit ERAS
      1紀元の概念を表す単位。 ISO暦体系には紀元がないため、日付または日付/時間に紀元を加算することはできません。 紀元の推定デュレーションは1,000,000,000年として人為的に定義されています。

      他の暦体系で使用される場合、この単位に制約はありません。

    • FOREVER

      public static final ChronoUnit FOREVER
      永遠の概念を表す人為的単位。 これは主にTemporalFieldとともに使用され、年や紀元のような無制限のフィールドを表します。 このユニットの推定期間は、Durationによってサポートされる最大の期間として人為的に定義されます。

  • メソッドの詳細

    • values

      public static ChronoUnit[] values()
      この列挙型の定数を含む配列を、宣言されている順序で返します。
      戻り値:
      この列挙型の定数を含む配列(宣言されている順序)

    • valueOf

      public static ChronoUnit valueOf​(String name)
      指定された名前を持つ、この型の列挙型定数を返します。 文字列は、この型の列挙型定数を宣言するのに使用した識別子と厳密に一致している必要があります。 (不適切な空白文字は許可されません。)
      パラメータ:
      name - 返される列挙型定数の名前。
      戻り値:
      指定された名前を持つ列挙型定数
      例外:
      IllegalArgumentException - 指定された名前を持つ定数をこの列挙型が持っていない場合
      NullPointerException - 引数がnullの場合

    • getDuration

      public Duration getDuration()
      ISO暦体系におけるこの単位の推定デュレーションを取得します。

      このクラスの単位すべてに推定デュレーションがあります。 日の長さはサマー・タイムのために変化し、月の長さは様々です。

      定義:
      インタフェースTemporalUnitのgetDuration
      戻り値:
      この単位の推定デュレーション。null以外

    • isDurationEstimated

      public boolean isDurationEstimated()
      単位のデュレーションが推定値かどうかをチェックします。

      このクラスの時間の単位はすべて正確と見なされ、このクラスの日付の単位はすべて推定と見なされます。

      この定義では、うるう秒は無視されますが、日の長さはサマー・タイムのために変化し、月の長さは様々であることが考慮されます。

      定義:
      インタフェースTemporalUnitのisDurationEstimated
      戻り値:
      デュレーションが推定の場合はtrue、正確な場合はfalse

    • isDateBased

      public boolean isDateBased()
      この単位が日付の単位かどうかをチェックします。

      日から紀元まで(これらを含む)の単位は、すべて日付ベースです。 時間ベースの単位とFOREVERからはfalseが返されます。

      定義:
      インタフェースTemporalUnitのisDateBased
      戻り値:
      日付の単位の場合はtrue、時間の単位の場合はfalse

    • isTimeBased

      public boolean isTimeBased()
      この単位が時間の単位かどうかをチェックします。

      ナノ秒から半日まで(これらを含む)の単位は、すべて時間ベースです。 日付ベースの単位とFOREVERからはfalseが返されます。

      定義:
      インタフェースTemporalUnitのisTimeBased
      戻り値:
      時間の単位の場合はtrue、日付の単位の場合はfalse