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

列挙型ChronoUnit

  • すべての実装されたインタフェース:
    Serializable, Comparable<ChronoUnit>, TemporalUnit

    public enum ChronoUnit
    extends Enum<ChronoUnit>
    implements TemporalUnit
    日付期間の単位の標準セット。

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

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

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

      • 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()
        この列挙型の定数を含む配列を、宣言されている順序で返します。 このメソッドは、次のようにして定数を反復するために使用できます。
        for (ChronoUnit c : ChronoUnit.values())
            System.out.println(c);
        
        戻り値:
        この列挙型の定数を含む配列(宣言されている順序)
      • valueOf

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

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

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

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

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

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

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

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

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

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

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

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

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

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