TimeUnit (Java Platform SE 8)

java.lang.Object
- java.lang.Enum<TimeUnit>
- - java.util.concurrent.TimeUnit

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

Serializable, Comparable<TimeUnit>
```
public enum TimeUnit
extends Enum<TimeUnit>
```
TimeUnitは、指定された粒度単位でデュレーションを表し、単位を変換したり、それらの単位でタイミングおよび遅延操作を実行したりするユーティリティ・メソッドを提供します。TimeUnitは、時間情報を保持せず、さまざまなコンテキスト間で独立して保持される時間表現の整理および使用だけを行うことができます。ナノ秒はマイクロ秒の1000分の1、マイクロ秒はミリ秒の1000分の1、ミリ秒は秒の1000分の1、分は60秒、時は60分、日は24時間としてそれぞれ定義されます。
TimeUnitは、主に時間ベースのメソッドに対して、指定されたタイミング・パラメータの解釈方法を指示するために使用します。たとえば、lockが使用できない場合、次のコードは50ミリ秒でタイム・アウトします。
```
 
 Lock lock = ...;
 if (lock.tryLock(50L, TimeUnit.MILLISECONDS)) ...
```
一方、次のコードは、50秒でタイム・アウトします。
```
 
 Lock lock = ...;
 if (lock.tryLock(50L, TimeUnit.SECONDS)) ...
```
ただし、特定のタイム・アウト実装で、指定されたTimeUnitと同じ粒度で時間経過を通知できる保証はないことに注意してください。
導入されたバージョン:

1.5

列挙型定数のサマリー

列挙型定数
列挙型定数と説明
`DAYS` 24時間を表す時間単位
`HOURS` 60分を表す時間単位
`MICROSECONDS` ミリ秒の1000分の1を表す時間単位
`MILLISECONDS` 秒の1000分の1を表す時間単位
`MINUTES` 60秒を表す時間単位
`NANOSECONDS` マイクロ秒の1000分の1を表す時間単位
`SECONDS` 1秒を表す時間単位

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`long`	`convert(long sourceDuration, TimeUnit sourceUnit)` 指定された単位による指定されたデュレーションを、この単位に変換します。
`void`	`sleep(long timeout)` この時間単位を使用して、`Thread.sleep`を実行します。
`void`	`timedJoin(Thread thread, long timeout)` この時間単位を使用して、時間指定された`Thread.join`を実行します。
`void`	`timedWait(Object obj, long timeout)` この時間単位を使用して、時間指定された`Object.wait`を実行します。
`long`	`toDays(long duration)` `DAYS.convert(duration, this)`と同等です。
`long`	`toHours(long duration)` `HOURS.convert(duration, this)`と同等です。
`long`	`toMicros(long duration)` `MICROSECONDS.convert(duration, this)`と同等です。
`long`	`toMillis(long duration)` `MILLISECONDS.convert(duration, this)`と同等です。
`long`	`toMinutes(long duration)` `MINUTES.convert(duration, this)`と同等です。
`long`	`toNanos(long duration)` `NANOSECONDS.convert(duration, this)`と同等です。
`long`	`toSeconds(long duration)` `SECONDS.convert(duration, this)`と同等です。
`static TimeUnit`	`valueOf(String name)` 指定された名前を持つ、この型の列挙型定数を返します。
`static TimeUnit[]`	`values()` この列挙型の定数を含む配列を、宣言されている順序で返します。

クラス java.lang.Enumから継承されたメソッド
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

クラス java.lang.Objectから継承されたメソッド
getClass, notify, notifyAll, wait, wait, wait

- 列挙型定数の詳細
  - NANOSECONDS
```
public static final TimeUnit NANOSECONDS
```
    マイクロ秒の1000分の1を表す時間単位
  - MICROSECONDS
```
public static final TimeUnit MICROSECONDS
```
    ミリ秒の1000分の1を表す時間単位
  - MILLISECONDS
```
public static final TimeUnit MILLISECONDS
```
    秒の1000分の1を表す時間単位
  - SECONDS
```
public static final TimeUnit SECONDS
```
    1秒を表す時間単位
  - MINUTES
```
public static final TimeUnit MINUTES
```
    60秒を表す時間単位
  - HOURS
```
public static final TimeUnit HOURS
```
    60分を表す時間単位
  - DAYS
```
public static final TimeUnit DAYS
```
    24時間を表す時間単位
- メソッドの詳細
  - values
```
public static TimeUnit[] values()
```
    この列挙型の定数を含む配列を、宣言されている順序で返します。このメソッドは、次のようにして定数を反復するために使用できます。
```
for (TimeUnit c : TimeUnit.values())
    System.out.println(c);
```
    戻り値:
    
    この列挙型の定数を含む配列(宣言されている順序)
  - valueOf
```
public static TimeUnit valueOf(String name)
```
    指定された名前を持つ、この型の列挙型定数を返します。文字列は、この型の列挙型定数を宣言するのに使用した識別子と厳密に一致している必要があります。不適切な空白文字は許可されません。
    
    パラメータ:
    
    name - 返される列挙型定数の名前。
    
    戻り値:
    
    指定された名前を持つ列挙型定数
    
    例外:
    
    IllegalArgumentException - 指定された名前を持つ定数をこの列挙型が持っていない場合
    
    NullPointerException - 引数がnullの場合
  - convert
```
public long convert(long sourceDuration,
                    TimeUnit sourceUnit)
```
    指定された単位による指定されたデュレーションを、この単位に変換します。粒度の細かいほうから粗いほうへの変換では切詰めが発生するため、精度が失われます。たとえば、999ミリ秒を秒に変換すると0になります。粒度の粗いほうから細かいほうへの変換で、数値的にオーバーフローが発生する引数を指定すると、負の場合はLong.MIN_VALUE、正の場合はLong.MAX_VALUEになります。
    たとえば、10分をミリ秒に変換するには、TimeUnit.MILLISECONDS.convert(10L, TimeUnit.MINUTES)を使用します。
    
    パラメータ:
    
    sourceDuration - 指定されたsourceUnitでのデュレーション
    
    sourceUnit - sourceDuration引数の単位
    
    戻り値:
    
    この単位での変換されたデュレーション。変換が負にオーバーフローする場合はLong.MIN_VALUE、正にオーバーフローする場合はLong.MAX_VALUE。
  - toNanos
```
public long toNanos(long duration)
```
    NANOSECONDS.convert(duration, this)と同等です。
    
    パラメータ:
    
    duration - デュレーション
    
    戻り値:
    
    変換されたデュレーション。変換が負にオーバーフローする場合はLong.MIN_VALUE、正にオーバーフローする場合はLong.MAX_VALUE。
  - toMicros
```
public long toMicros(long duration)
```
    MICROSECONDS.convert(duration, this)と同等です。
    
    パラメータ:
    
    duration - デュレーション
    
    戻り値:
    
    変換されたデュレーション。変換が負にオーバーフローする場合はLong.MIN_VALUE、正にオーバーフローする場合はLong.MAX_VALUE。
  - toMillis
```
public long toMillis(long duration)
```
    MILLISECONDS.convert(duration, this)と同等です。
    
    パラメータ:
    
    duration - デュレーション
    
    戻り値:
    
    変換されたデュレーション。変換が負にオーバーフローする場合はLong.MIN_VALUE、正にオーバーフローする場合はLong.MAX_VALUE。
  - toSeconds
```
public long toSeconds(long duration)
```
    SECONDS.convert(duration, this)と同等です。
    
    パラメータ:
    
    duration - デュレーション
    
    戻り値:
    
    変換されたデュレーション。変換が負にオーバーフローする場合はLong.MIN_VALUE、正にオーバーフローする場合はLong.MAX_VALUE。
  - toMinutes
```
public long toMinutes(long duration)
```
    MINUTES.convert(duration, this)と同等です。
    
    パラメータ:
    
    duration - デュレーション
    
    戻り値:
    
    変換されたデュレーション。変換が負にオーバーフローする場合はLong.MIN_VALUE、正にオーバーフローする場合はLong.MAX_VALUE。
    
    導入されたバージョン:
    
    1.6
  - toHours
```
public long toHours(long duration)
```
    HOURS.convert(duration, this)と同等です。
    
    パラメータ:
    
    duration - デュレーション
    
    戻り値:
    
    変換されたデュレーション。変換が負にオーバーフローする場合はLong.MIN_VALUE、正にオーバーフローする場合はLong.MAX_VALUE。
    
    導入されたバージョン:
    
    1.6
  - toDays
```
public long toDays(long duration)
```
    DAYS.convert(duration, this)と同等です。
    
    パラメータ:
    
    duration - デュレーション
    
    戻り値:
    
    変換されたデュレーション
    
    導入されたバージョン:
    
    1.6
  - timedWait
```
public void timedWait(Object obj,
                      long timeout)
               throws InterruptedException
```
    この時間単位を使用して、時間指定されたObject.waitを実行します。このメソッドは、timeout引数をObject.waitメソッドで要求される形式に変換する簡易メソッドです。
    たとえば、次を使用して、ブロックするpollメソッドを実装できます(BlockingQueue.pollを参照)。
```
 
 public synchronized Object poll(long timeout, TimeUnit unit)
     throws InterruptedException {
   while (empty) {
     unit.timedWait(this, timeout);
     ...
   }
 }
```
    パラメータ:
    
    obj - 待機するオブジェクト
    
    timeout - 待機する最長時間。ゼロまたはそれより小さい場合は待機しない。
    
    例外:
    
    InterruptedException - 待機中に割込みが発生した場合
  - timedJoin
```
public void timedJoin(Thread thread,
                      long timeout)
               throws InterruptedException
```
    この時間単位を使用して、時間指定されたThread.joinを実行します。このメソッドは、time引数をThread.joinメソッドで要求される形式に変換する簡易メソッドです。
    
    パラメータ:
    
    thread - 待機するスレッド
    
    timeout - 待機する最長時間。ゼロまたはそれより小さい場合は待機しない。
    
    例外:
    
    InterruptedException - 待機中に割込みが発生した場合
  - sleep
```
public void sleep(long timeout)
           throws InterruptedException
```
    この時間単位を使用して、Thread.sleepを実行します。これは、time引数をThread.sleepメソッドで要求される形式に変換する簡易メソッドです。
    
    パラメータ:
    
    timeout - スリープする最小時間。ゼロまたはそれより小さい場合はスリープしない。
    
    例外:
    
    InterruptedException - スリープ中に割込みが発生した場合

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

列挙TimeUnit

列挙型定数のサマリー

メソッドのサマリー

クラス java.lang.Enumから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

列挙型定数の詳細

NANOSECONDS

MICROSECONDS

MILLISECONDS

SECONDS

MINUTES

HOURS

DAYS

メソッドの詳細

values

valueOf

convert

toNanos

toMicros

toMillis

toSeconds

toMinutes

toHours

toDays

timedWait

timedJoin

sleep