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>
```
一个 TimeUnit代表时间在给定单位的粒度，提供实用的方法来转换过的单位，并进行定时和延时操作这些单位。一个 TimeUnit不保持的时间信息，但只有帮助组织和使用时间表示可单独保存在各种环境中。纳秒级定义为一千分之一微秒，微秒的一千分之一毫秒，毫秒为一千分之一秒，一分钟六十秒，一小时是六十分钟，和二零四小时的一天。
一个TimeUnit主要用来通知时间的方法如何给定时参数的解释应。例如，下面的代码将超时在50毫秒内如果lock不可用：
```
 Lock lock = ...;
 if (lock.tryLock(50L, TimeUnit.MILLISECONDS)) ...
```
，此代码将超时50秒
```
 Lock lock = ...;
 if (lock.tryLock(50L, TimeUnit.SECONDS)) ...
```
注但没有保证某一特定超时的实现可以在粒度为给 TimeUnit同样注意到时间的流逝。
从以下版本开始：

一点五

Enum Constant Summary

Enum Constants
Enum Constant and Description
`DAYS` 代表二零四小时的时间单位
`HOURS` 代表六十分钟的时间单位
`MICROSECONDS` 代表毫秒的一千分之一的时间单位
`MILLISECONDS` 代表第二个的一千分之一的时间单位
`MINUTES` 代表六十秒的时间单位
`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
```
    代表六十秒的时间单位
  - HOURS
```
public static final TimeUnit HOURS
```
    代表六十分钟的时间单位
  - DAYS
```
public static final TimeUnit DAYS
```
    代表二零四小时的时间单位
- 方法详细信息
  - values
```
public static TimeUnit[] values()
```
    返回一个数组包含该枚举类型的常量，它们的顺序声明。这种方法可以用来遍历常数如下：
```
对于（timeunit C：timeunit。values()） 系统，println（C）；
```
    结果
    
    这个数组包含枚举类型的常量，它们的顺序声明
  - valueOf
```
public static TimeUnit valueOf(String name)
```
    返回此类型具有指定名称的枚举常量。字符串必须匹配确切地用来声明一个枚举本型常数标识符。（多余空格的字符是不允许的。）
    
    参数
    
    name -定要返回的枚举的名称。
    
    结果
    
    具有指定名称的枚举常量
    
    异常
    
    IllegalArgumentException -如果这个枚举类型，也没有固定的具有指定名称
    
    NullPointerException -如果参数为空
  - 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是否正溢出。
    
    从以下版本开始：
    
    一点六
  - toHours
```
public long toHours(long duration)
```
    相当于 HOURS.convert(duration, this)。
    
    参数
    
    duration -时间
    
    结果
    
    转换的时间，或 Long.MIN_VALUE如果转换负溢出，或 Long.MAX_VALUE是否正溢出。
    
    从以下版本开始：
    
    一点六
  - toDays
```
public long toDays(long duration)
```
    相当于 DAYS.convert(duration, this)。
    
    参数
    
    duration -时间
    
    结果
    
    转换时间
    
    从以下版本开始：
    
    一点六
  - timedWait
```
public void timedWait(Object obj,
                      long timeout)
               throws InterruptedException
```
    执行定时 Object.wait利用这个时间单位。这是一个方便的方法，将超时参数的 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利用这个时间单位。这是一个方便的方法，将时间参数的 Thread.join方法所要求的形式。
    
    参数
    
    thread -线程等待
    
    timeout -最大等待时间。如果小于或等于零，就不要再等了。
    
    异常
    
    InterruptedException如果中断等待
  - sleep
```
public void sleep(long timeout)
           throws InterruptedException
```
    执行 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