TimeUnit 的源码解析和API介绍

七个枚举

• NANOSECONDS 纳秒
• MICROSECONDS 微妙
• MILLISECONDS 毫秒
• SECONDS 秒
• MINUTES 分
• HOURS 小时
• DAYS 天

1秒=1,000毫秒=1,000,000微妙=1,000,000,000纳秒

枚举内部API

传入的参数long d 的单位是单前枚举，比如NANOSECONDS，那么d的单位就是纳秒

• toNanos 纳秒转纳秒，直接返回。
• toMicros 纳秒转毫秒，除以1000。直到toDays，都是同样的道理。
• convert 返回的结果的单位就是当前枚举，long d 的单位就是u的枚举类型
• excessNanos 特殊，后面会讲

枚举API

如图，这些方法只能内部去自己实现，不然就抛出异常。不过也调用不了。无需在意。

三个通用的方法（因为7个枚举类都通用）

• void timedWait(Object obj, long timeout) 底层是调用obj.wait方法，单位为单前枚举类型
• void timedJoin(Thread thread, long timeout) 底层是调用thread.join方法，单位为单前枚举类型
• void sleep(long timeout) 底层是调用Thread.sleep方法 ，单位为单前枚举类型

public void timedWait(Object obj, long timeout)  
        throws InterruptedException {  
    if (timeout > 0) {  
	    //转化为毫秒
        long ms = toMillis(timeout);  
        //计算纳秒 
        int ns = excessNanos(timeout, ms);  
        obj.wait(ms, ns);  
    }  
}


public void timedJoin(Thread thread, long timeout)  
        throws InterruptedException {  
    if (timeout > 0) {  
	    //转化为毫秒
        long ms = toMillis(timeout); 
        //计算纳秒 
        int ns = excessNanos(timeout, ms);  
        thread.join(ms, ns);  
    }  
}


//睡眠指定时间
public void sleep(long timeout) throws InterruptedException {  
    if (timeout > 0) {  
	    //转化为毫秒
        long ms = toMillis(timeout);  
        //计算纳秒，当睡眠的精度低于毫秒，就要计算这个纳秒。
        int ns = excessNanos(timeout, ms);  
        //睡眠多少毫秒。
        Thread.sleep(ms, ns);  
    }  
}

excessNanos 方法

excessNanos方法官方API注释翻译：
计算wait、sleep、join的超纳秒参数的工具。
还是很懵，先看看Thread.sleep方法。

Thread.sleep(long millis, int nanos)方法

//方法使当前执行的线程睡眠指定的毫秒数加纳秒指定数量，受制于精度和系统计时器和调度程序精度。
public static void sleep(long millis, int nanos)  
throws InterruptedException {  
    if (millis < 0) {  
        throw new IllegalArgumentException("timeout value is negative");  
    }  
  
    if (nanos < 0 || nanos > 999999) {  
        throw new IllegalArgumentException(  
                            "nanosecond timeout value out of range");  
    }  
	//也就是当nanos大于等于500微秒时，millis就加１．当nanos小于500微秒时，不改变millis的值．
	//当millis的值为0时，只要nanos不为0，就将millis设置为１．
    if (nanos >= 500000 || (nanos != 0 && millis == 0)) {  
        millis++;  
    }  
	//可以看出，睡眠的最小单位为millis 
    sleep(millis);  
}

所以，当睡眠的时间单位小于毫秒级别（微秒，纳秒），那么就要计算它的纳秒数，是为了使sleep方法更精确。Thread.join(ms, ns) 和 Object.wait(ms, ns)同理。

excessNanos的意义

NANOSECONDS {  
    //....忽略其他API

	//c2是1,000,000
	//参数的单位：d是纳秒，m是毫秒
    int excessNanos(long d, long m) { return (int)(d - (m*C2)); }  
},


MICROSECONDS {  
	//....忽略其他API

	//c1 是1000 c2是1,000,000
	//参数的单位：d是微秒，m是毫秒  
    int excessNanos(long d, long m) { return (int)((d*C1) - (m*C2)); }  
},


//其他枚举该方法都是直接return 0。
//因为当单位大于等于毫秒，就可以忽略掉这点时间，因为单位大于等于毫秒，那点纳秒精确度可以忽略不计。

所以，这就是excessNanos方法的意义。

• 其中，为什么大于毫秒的单位，excessNanos方法都是返回0呢？
  • 因为当单位大于等于毫秒，就可以忽略掉这点时间，因为单位大于等于毫秒，那点纳秒精确度可以忽略不计。