时间相关问题通常来自混淆了三种概念:绝对时刻、墙上时间和用于测量时长的单调时钟。它们都可以表现为数字,但用途并不相同。
1. 什么是 UTC 时间
UTC(协调世界时)是全球统一的时间基准,不属于某个国家或地区,也不随夏令时变化。2026-10-08T08:00:00Z 中的 Z 表示 UTC。
Unix 时间戳表示从 1970-01-01T00:00:00Z 起经过的秒数或毫秒数。同一个时间戳在全球代表同一个瞬间,本身不包含时区:
- 秒级时间戳常用于服务端协议,例如
1791446400。 - 毫秒级时间戳常用于 Java、JavaScript 和 Android,例如
1791446400000。 - 转换为北京时间、纽约时间等日历表示时,才会应用时区。
当前值通常可以通过 10 位或 13 位初步判断单位,但历史数据和远期数据不能只依赖位数。字段名或接口契约应明确写出 epochSeconds、epochMillis 等单位。
2. 什么是墙上时间
墙上时间是用户在时钟或日历上看到的年月日和时分秒,例如“2026 年 10 月 8 日 16:00”。它依赖时区、夏令时和设备系统时间设置。
墙上时间可能因为用户手动改时间、网络校时或夏令时切换而向前或向后跳变。因此:
- 记录日志、生成服务端时间字段或展示日期时,使用墙上时间或 Unix 时间戳。
- 测量请求耗时、动画间隔、超时时间时,使用单调时钟。
- 不要用两个墙上时间简单相减来测量对时间跳变敏感的短时任务。
3. Java 中怎样获取时间戳
Java 获取 Unix 时间戳可以使用 System.currentTimeMillis() 或 java.time.Instant:
long epochMillis = System.currentTimeMillis();
Instant now = Instant.now();
long epochSeconds = now.getEpochSecond();
long epochMillisFromInstant = now.toEpochMilli();
System.currentTimeMillis() 和 Instant.now() 都属于墙上时间,可能受到系统校时影响。需要测试可控的业务代码时,优先注入 Clock:
Instant now = Instant.now(clock);
测量一段代码实际运行了多久,应使用单调递增的 System.nanoTime():
long started = System.nanoTime();
runTask();
long elapsedNanos = System.nanoTime() - started;
nanoTime() 的值没有 Unix 纪元含义,不能格式化为日期,也不能发送给其他设备比较。
4. Android 常用时间戳和相关时间
Android 同时提供墙上时间和从开机开始累计的单调时间:
| API | 时间性质 | 常见用途 |
|---|---|---|
System.currentTimeMillis() |
Unix 毫秒,墙上时间 | 日志、接口字段、持久化日期 |
Instant.now().toEpochMilli() |
Unix 毫秒,墙上时间 | 使用 java.time 处理绝对时刻 |
SystemClock.elapsedRealtime() |
开机后毫秒,包含深度睡眠 | 超时、倒计时、跨休眠时长 |
SystemClock.elapsedRealtimeNanos() |
开机后纳秒,包含深度睡眠 | 高精度耗时和传感器时间对齐 |
SystemClock.uptimeMillis() |
开机后毫秒,不包含深度睡眠 | Handler、UI 调度、运行态计时 |
Instant 原生支持从 Android API 26 开始;较低版本可在项目启用 core library desugaring 后使用。
AlarmManager 的 RTC 类型基于墙上时间,ELAPSED_REALTIME 类型基于开机单调时间。位置数据也同时提供两类时间:Location.getTime() 是 Unix 毫秒,Location.getElapsedRealtimeNanos() 适合判断定位结果的新旧。
选择原则很简单:需要与服务器或日历对应时使用 Unix 时间戳;只关心“过了多久”时使用 elapsedRealtime 或 nanoTime。