TimeUnit (Java Platform SE 8 )

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

All Implemented Interfaces:

Serializable ， Comparable < TimeUnit >
```
public enum TimeUnit
extends Enum<TimeUnit>
```
A TimeUnit表示给定的粒度单位的持续时间，并且提供了跨单元转换的实用方法，并且在这些单元中执行定时和延迟操作。 A TimeUnit不保留时间信息，但只能帮助组织和使用可能在不同上下文中单独维护的时间表示。一纳秒定义为千分之一秒，微秒为千分之一毫秒，毫秒为千分之一秒，一分钟为六十秒，一小时为六十分钟，一天为二十四小时。
A TimeUnit主要用于通知基于时间的方法如何解释给定的时序参数。例如，下面的代码将在50毫秒超时如果lock不可用：
```
   Lock lock = ...; if (lock.tryLock(50L, TimeUnit.MILLISECONDS)) ... 
```
而此代码将在50秒内超时：
```
   Lock lock = ...; if (lock.tryLock(50L, TimeUnit.SECONDS)) ... 
```
然而，请注意，不能保证特定的超时执行将能够以与给定的TimeUnit相同的粒度注意到时间的TimeUnit 。
从以下版本开始：

1.5

Enum Constant Summary

Enum Constants
Enum Constant and Description
`DAYS` 时间单位代表二十四小时
`HOURS` 时间单位代表六十分钟
`MICROSECONDS` 时间单位代表千分之一毫秒
`MILLISECONDS` 时间单位为千分之一秒
`MINUTES` 时间单位代表60秒
`NANOSECONDS` 时间单位代表千分之一千分之一
`SECONDS` 时间单位代表一秒

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`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()` 按照它们声明的顺序返回一个包含此枚举类型常量的数组。

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - NANOSECONDS
```
public static final TimeUnit NANOSECONDS
```
    时间单位代表千分之一千分之一
  - MICROSECONDS
```
public static final TimeUnit MICROSECONDS
```
    时间单位代表千分之一毫秒
  - MILLISECONDS
```
public static final TimeUnit MILLISECONDS
```
    时间单位为千分之一秒
  - SECONDS
```
public static final TimeUnit SECONDS
```
    时间单位代表一秒
  - MINUTES
```
public static final TimeUnit MINUTES
```
    时间单位代表60秒
  - HOURS
```
public static final TimeUnit HOURS
```
    时间单位代表六十分钟
  - DAYS
```
public static final TimeUnit DAYS
```
    时间单位代表二十四小时
- 方法详细信息
  - values
```
public static TimeUnit[] values()
```
    按照它们声明的顺序返回一个包含此枚举类型常量的数组。该方法可用于遍历常量如下：
```
  for (TimeUnit c : TimeUnit.values())
    System.out.println(c); 
```
    结果
    
    一个包含这个枚举类型的常量的数组，按照它们被声明的顺序
  - valueOf
```
public static TimeUnit valueOf(String name)
```
    以指定的名称返回此类型的枚举常量。字符串必须完全匹配用于声明此类型的枚举常量的标识符。（不允许使用外来空白字符。）
    
    参数
    
    name - 要返回的枚举常量的名称。
    
    结果
    
    具有指定名称的枚举常数
    
    异常
    
    IllegalArgumentException - 如果此枚举类型没有指定名称的常量
    
    NullPointerException - 如果参数为空
  - convert
```
public long convert(long sourceDuration,
                    TimeUnit sourceUnit)
```
    将给定单位的给定持续时间转换为本机。从更精细到更粗糙的粒度的转换截断，因此失去精度。例如，将999 999转换为秒会导致0 。从更粗糙到更细粒度的转换，数值溢出饱和的Long.MIN_VALUE如果为负， Long.MAX_VALUE否则为Long.MIN_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 。这是一个方便的方法，将超时参数转换为Object.wait方法所需的Object.wait 。
    例如，您可以使用poll方法实现阻止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 。这是一种方便的方法，将时间参数转换为Thread.join方法所需的Thread.join 。
    
    参数
    
    thread - 等待的线程
    
    timeout - 等待的最长时间。如果小于或等于零，不要等待。
    
    异常
    
    InterruptedException - 如果在等待时中断
  - sleep
```
public void sleep(long timeout)
           throws InterruptedException
```
    使用此时间单位执行Thread.sleep 。这是一种方便的方法，将时间参数转换为Thread.sleep方法所需的Thread.sleep 。
    
    参数
    
    timeout - 睡眠时间最短如果小于或等于零，不要睡觉。
    
    异常
    
    InterruptedException - 睡觉时中断

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Enum TimeUnit

Enum Constant Summary

方法摘要

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

NANOSECONDS

MICROSECONDS

MILLISECONDS

SECONDS

MINUTES

HOURS

DAYS

方法详细信息

values

valueOf

convert

toNanos

toMicros

toMillis

toSeconds

toMinutes

toHours

toDays

timedWait

timedJoin

sleep