TimeUnit (Платформа Java SE 7)

java.lang. Объект
- java.lang. Перечисление <TimeUnit>
- - java.util.concurrent. TimeUnit

Все Реализованные Интерфейсы:

Сериализуемый, Сопоставимый <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.
С тех пор:

1.5

Перечислимая Постоянная Сводка

Перечислимые Константы
Перечислимая Константа и Описание
`ДНИ`
`ЧАСЫ`
`МИКРОСЕКУНДЫ`
`МИЛЛИСЕКУНДЫ`
`МИНУТЫ`
`НАНОСЕКУНДЫ`
`СЕКУНДЫ`

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`long`	`convert(long sourceDuration, TimeUnit sourceUnit)` Преобразуйте данную продолжительность времени в данном модуле к этому модулю.
`void`	`sleep(long timeout)` Выполняет a `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 унаследованный от класса. Перечисление
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Методы java.lang унаследованный от класса. Объект
getClass, notify, notifyAll, wait, wait, wait

- Перечислимая Постоянная Деталь
  - НАНОСЕКУНДЫ
```
public static final TimeUnit NANOSECONDS
```
  - МИКРОСЕКУНДЫ
```
public static final TimeUnit MICROSECONDS
```
  - МИЛЛИСЕКУНДЫ
```
public static final TimeUnit MILLISECONDS
```
  - СЕКУНДЫ
```
public static final TimeUnit SECONDS
```
  - МИНУТЫ
```
public static final TimeUnit MINUTES
```
  - ЧАСЫ
```
public static final TimeUnit HOURS
```
  - ДНИ
```
public static final TimeUnit DAYS
```
- Деталь метода
  - значения
```
public static TimeUnit[] values()
```
    Возвращает массив, содержащий константы этого перечислимого типа, в порядке, которым они объявляются. Этот метод может использоваться, чтобы выполнить итерации по константам следующим образом:
```
for (TimeUnit c : TimeUnit.values())
 System.out.println(c);
```
    Возвраты:
    массив, содержащий константы этого перечислимого типа, в порядке, они объявляются
  - valueOf
```
public static TimeUnit valueOf(String name)
```
    Возвращает перечислимую константу этого типа с указанным именем. Строка должна соответствовать точно идентификатор, используемый, чтобы объявить перечислимую константу в этом типе. (Посторонние пробельные символы не разрешаются.)
    
    Параметры:
    name - имя перечислимой константы, которая будет возвращена.
    
    Возвраты:
    перечислимая константа с указанным именем
    
    Броски:
    
    IllegalArgumentException - если у этого перечислимого типа нет никакой константы с указанным именем
    
    NullPointerException - если параметром является нуль
  - преобразовать
```
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, если это положительно переполнилось бы.
    См. Также:
    convert(long, java.util.concurrent.TimeUnit)
  - toMicros
```
public long toMicros(long duration)
```
    Эквивалентный MICROSECONDS.convert(duration, this).
    
    Параметры:
    duration - продолжительность
    
    Возвраты:
    преобразованная продолжительность, или Long.MIN_VALUE, если бы преобразование негативно переполнилось бы, или Long.MAX_VALUE, если это положительно переполнилось бы.
    См. Также:
    convert(long, java.util.concurrent.TimeUnit)
  - toMillis
```
public long toMillis(long duration)
```
    Эквивалентный MILLISECONDS.convert(duration, this).
    
    Параметры:
    duration - продолжительность
    
    Возвраты:
    преобразованная продолжительность, или Long.MIN_VALUE, если бы преобразование негативно переполнилось бы, или Long.MAX_VALUE, если это положительно переполнилось бы.
    См. Также:
    convert(long, java.util.concurrent.TimeUnit)
  - toSeconds
```
public long toSeconds(long duration)
```
    Эквивалентный SECONDS.convert(duration, this).
    
    Параметры:
    duration - продолжительность
    
    Возвраты:
    преобразованная продолжительность, или Long.MIN_VALUE, если бы преобразование негативно переполнилось бы, или Long.MAX_VALUE, если это положительно переполнилось бы.
    См. Также:
    convert(long, java.util.concurrent.TimeUnit)
  - toMinutes
```
public long toMinutes(long duration)
```
    Эквивалентный MINUTES.convert(duration, this).
    
    Параметры:
    duration - продолжительность
    
    Возвраты:
    преобразованная продолжительность, или Long.MIN_VALUE, если бы преобразование негативно переполнилось бы, или Long.MAX_VALUE, если это положительно переполнилось бы.
    С тех пор:
    
    1.6
    
    См. Также:
    convert(long, java.util.concurrent.TimeUnit)
  - toHours
```
public long toHours(long duration)
```
    Эквивалентный HOURS.convert(duration, this).
    
    Параметры:
    duration - продолжительность
    
    Возвраты:
    преобразованная продолжительность, или Long.MIN_VALUE, если бы преобразование негативно переполнилось бы, или Long.MAX_VALUE, если это положительно переполнилось бы.
    С тех пор:
    
    1.6
    
    См. Также:
    convert(long, java.util.concurrent.TimeUnit)
  - toDays
```
public long toDays(long duration)
```
    Эквивалентный DAYS.convert(duration, this).
    
    Параметры:
    duration - продолжительность
    
    Возвраты:
    преобразованная продолжительность
    С тех пор:
    
    1.6
    
    См. Также:
    convert(long, java.util.concurrent.TimeUnit)
  - 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 - если прервано, ожидая
  - сон
```
public void sleep(long timeout)
           throws InterruptedException
```
    Выполняет a Thread.sleep использование этой единицы измерения времени. Это - метод удобства, который преобразовывает параметры времени в форму, требуемую методом Thread.sleep.
    
    Параметры:
    timeout - минимальное время, чтобы спать. Если меньше чем или равный нулю, не спите вообще.
    
    Броски:
    
    InterruptedException - если прервано, спя

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Перечислимый TimeUnit

Перечислимая Постоянная Сводка

Сводка метода

Методы java.lang унаследованный от класса. Перечисление

Методы java.lang унаследованный от класса. Объект

Перечислимая Постоянная Деталь

НАНОСЕКУНДЫ

МИКРОСЕКУНДЫ

МИЛЛИСЕКУНДЫ

СЕКУНДЫ

МИНУТЫ

ЧАСЫ

ДНИ

Деталь метода

значения

valueOf

преобразовать

toNanos

toMicros

toMillis

toSeconds

toMinutes

toHours

toDays

timedWait

timedJoin

сон