java.util.concurrent
열거형 TimeUnit

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

모든 구현된 인터페이스:

Serializable, Comparable <TimeUnit >

public enum TimeUnit
extends Enum <TimeUnit >

TimeUnit는 기간이 지정된 입도 단위로 나타냅니다. 이것은 단위간의 변환을 실시해, 이러한 단위로 타이밍 및 지연 조작을 실행하는 유틸리티 메서드를 제공합니다. TimeUnit는 시간 정보를 관리합니다만, 다양한 컨텍스트 간에 별개에 관리되는 시간표현을 정리 및 사용하는데 도움이 됩니다.

TimeUnit는 주로 시간 베이스의 메서드에 지정된 타이밍 파라미터를 해석하는 방법을 지시하는 경우에 사용합니다. 예를 들어 다음의 코드는 락을 사용할 수 없는 경우, 50 밀리 세컨드 후에 타임 아웃 합니다.

  Lock lock = ...;
  if ( lock.tryLock(50L, TimeUnit.MILLISECONDS) ) ...
 

이 코드가 50 초 후에 타임 아웃 하는 경우:

  Lock lock = ...;
  if ( lock.tryLock(50L, TimeUnit.SECONDS) ) ...
 

다만, 특정의 타임 아웃 구현이, 지정된 TimeUnit와 같은 입도로 시간 경과를 통지할 수 있다고 하는 보증은 없습니다.

도입된 버전 :

1.5

열거형 정수의 개요

MICROSECONDS

MILLISECONDS

NANOSECONDS

SECONDS

메서드 개요

long	convert (long duration, TimeUnit unit) 지정된 단위로 나타내지는 지정된 기간을 이 단위로 변환합니다.
void	sleep (long timeout) 이 단위를 사용해, Thread.sleep를 실행합니다.
void	timedJoin (Thread thread, long timeout) 이 시간 단위를 사용해, 시간 지정된 Thread.join를 실행합니다.
void	timedWait (Object obj, long timeout) 이 시간 단위를 사용해, 시간 지정된 Object.wait을 실행합니다.
long	toMicros (long duration) MICROSECONDS.convert(duration, this)와 같습니다.
long	toMillis (long duration) MILLISECONDS.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, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

클래스 java.lang. Object 로부터 상속된 메서드

finalize, getClass, notify, notifyAll, wait, wait, wait

열거형 정수의 상세

NANOSECONDS

public static final TimeUnit  NANOSECONDS

MICROSECONDS

public static final TimeUnit  MICROSECONDS

MILLISECONDS

public static final TimeUnit  MILLISECONDS

SECONDS

public static final TimeUnit  SECONDS

메서드의 상세

values

public static final TimeUnit [] values()

이 열거형의 정수를 포함한 배열이 선언되고 있는 순서로 리턴합니다.이 메서드는 다음과 같이의해 정수를 반복하기 위해서 사용할 수 있습니다:

for(TimeUnit c : TimeUnit.values())
        System.out.println(c);

반환값:

이 열거형의 정수가 선언되고 있는 순서로 포함한 배열

valueOf

public static TimeUnit  valueOf(String  name)

지정한 이름을 가지는 이 형태의 열거형 정수를 리턴합니다. 캐릭터 라인은 이 형태의 열거형 정수를 선언하는데 사용한 식별자와 엄밀하게 일치하고 있을 필요가 있습니다 (여분의 공백 문자를 포함할 수 없습니다).

파라미터:

name - 리턴된 열거형 정수의 이름

반환값:

지정된 이름을 가지는 열거형 정수

예외:

IllegalArgumentException - 지정된 이름을 가지는 정수를이 열거형이 가지고 있지 않은 경우

convert

public long convert(long duration,
                    TimeUnit  unit)

지정된 단위로 나타내지는 지정된 기간을 이 단위로 변환합니다. 밀로부터 결점의 입도로 변환하면, 잘라서 버림을의해 정밀도가 없어집니다. 예를 들어, 999 밀리 세컨드를 초로 변환하면, 0 이 됩니다. 수값이 오버플로우 하는 인수를 사용해 결점으로부터 밀의 입도로 변환하면, 포화해 부의 경우는 Long.MIN_VALUE, 정의 경우는 Long.MAX_VALUE가 됩니다.

파라미터:

duration - 지정된 unit 기간

unit - duration 인수의 단위

반환값:

이 단위로 변환된 기간. 변환이 부로 오버플로우 하는 경우는 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 - 기간

반환값:

변환된 기간

관련 항목:

convert(long, java.util.concurrent.TimeUnit)

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 - 대기중에 인터럽트가 발생했을 경우

관련 항목:

Object.wait(long, int)

timedJoin

public void timedJoin(Thread  thread,
                      long timeout)
               throws InterruptedException 

이 시간 단위를 사용해, 시간 지정된 Thread.join를 실행합니다. 이것은 time 인수를 Thread.join 메서드의 요구 형식으로 변환하는 편리한 메서드입니다.

파라미터:

thread - 대기하는 thread

timeout - 대기하는 최장 시간

예외:

InterruptedException - 대기중에 인터럽트가 발생했을 경우

관련 항목:

Thread.join(long, int)

sleep

public void sleep(long timeout)
           throws InterruptedException 

이 단위를 사용해, Thread.sleep를 실행합니다. 이것은 time 인수를 Thread.sleep 메서드의 요구 형식으로 변환하는 편리한 메서드입니다.

파라미터:

timeout - sleeve 하는 최단 시간

예외:

InterruptedException - sleeve중에 인터럽트가 발생했을 경우

관련 항목:

Thread.sleep(long)