所谓的时间戳(Timestamp),指的是从世界标准时间 1970 年 1 月 1 日 00:00:00 UTC 到某一时刻所经过的总秒数或总毫秒数。不管处于全球哪一个时区,同一时刻对应的时间戳都是完全相同的纯数字,因此在数据库存储和接口传输中用得非常多。
在 Go 语言中,我们可以先调用 time.Now() 获取当前时间,再调用 Unix()、UnixMilli() 或 UnixNano() 方法来获取对应精度的时间戳。
获取不同精度的时间戳
为什么获取时间戳的方法名字里都带有 Unix 呢?这是为了纪念 1970 年诞生的 Unix 操作系统,计算机界约定俗成将 1970 年 1 月 1 日 00:00:00 UTC 定为计算机时间的起点。
在 Go 语言中,拿到 time.Time 时间对象后,我们可以按需调用以下 4 个方法来获取不同精度的时间戳。
语法:
t.Unix()
t.UnixMilli()
t.UnixMicro()
t.UnixNano()说明:
这 4 个方法的返回值类型均为 int64 整数,各自对应的精度如下:
- t.Unix():返回从 1970 年 1 月 1 日零点(UTC)到时间
t经过的秒数,当前通常为 10 位数字。 - t.UnixMilli():返回经过的毫秒数,当前通常为 13 位数字,与前端 JavaScript 中的
Date.now()一致。 - t.UnixMicro():返回经过的微秒数,当前通常为 16 位数字。
- t.UnixNano():返回经过的纳秒数,当前通常为 19 位数字,常用于高精度计时。
提示: 小伙伴们平时可以根据数字位数快速区分常用时间戳:10 位数字通常是 “秒级”,13 位数字通常是 “毫秒级”。因为 1 秒等于 1000 毫秒,毫秒级时间戳刚好比秒级多出末尾 3 位数字。
示例 1:获取当前时间戳
package main
import (
"fmt"
"time"
)
func main() {
now := time.Now()
fmt.Println(now.Unix()) // 秒级时间戳(10 位)
fmt.Println(now.UnixMilli()) // 毫秒级时间戳(13 位)
fmt.Println(now.UnixNano()) // 纳秒级时间戳(19 位)
}运行结果如下。
1780535104
1780535104128
1780535104128456789分析:
在这个例子中,我们先调用 time.Now() 获取当前时刻 now,再分别调用 Unix()、UnixMilli() 和 UnixNano() 打印出秒级、毫秒级和纳秒级时间戳。平时写项目时,最常用的是 10 位秒级时间戳和 13 位毫秒级时间戳。
需要注意的是,时间戳的数值与 time.Time 所处的时区无关。你可以这样来理解:北京的晚上 8 点和伦敦的中午 12 点,其实是地球上的同一个瞬间。两地同时去看距离 1970 年元旦零点走过的总秒数,算出来的数字当然完全一样。
哪怕我们在代码里把 now 切换成 now.UTC() 零时区时间,调用 Unix() 得到的秒数也分毫不差。
将时间戳还原为 time.Time
从数据库或前端接口拿到 int64 类型的时间戳后,我们经常需要查看它对应的具体年月日和时分秒。这时可以使用 time.Unix() 或 time.UnixMilli() 函数,将其还原为 time.Time 对象。
语法:
time.Unix(sec, nsec)
time.UnixMilli(msec)
time.UnixMicro(usec)说明:
这 3 个函数接收的参数均为 int64 整数,调用后都会返回一个本地时区 time.Local 下的 time.Time 对象:
- time.Unix(sec, nsec):支持同时传入秒数
sec和纳秒偏移nsec。平时还原 10 位整秒时间戳时,我们将第 2 个参数固定传 0 即可,即time.Unix(sec, 0)。如果要还原 19 位纳秒级时间戳,则写成time.Unix(0, nsec)。 - time.UnixMilli(msec):专门用于还原 13 位毫秒级时间戳,我们直接传入毫秒数
msec即可。 - time.UnixMicro(usec):专门用于还原 16 位微秒级时间戳,我们直接传入微秒数
usec即可。
示例 2:秒级时间戳转 time.Time
package main
import (
"fmt"
"time"
)
func main() {
var ts int64 = 1786147200 // 10 位秒级时间戳
t := time.Unix(ts, 0)
fmt.Println(t)
fmt.Printf("%d年%d月%d日\n", t.Year(), int(t.Month()), t.Day())
}运行结果如下。
2026-08-08 08:00:00 +0800 CST
2026年8月8日分析:
time.Unix(ts, 0) 表示将秒级时间戳 1786147200 还原为本地时区的 time.Time 对象,在国内东八区环境下对应北京时间 2026 年 8 月 8 日上午 8 点整。
还原得到 t 之后,我们既可以调用 t.Year()、t.Month()、t.Day() 提取年月日,也可以直接调用 Format() 输出字符串。例如直接写成 time.Unix(ts, 0).Format(time.DateTime),一行就能完成还原与格式化。
如果后端接口收到的是前端传来的 13 位毫秒级时间戳,我们可以直接调用 time.UnixMilli() 来还原,请看下面例子。
示例 3:毫秒级时间戳转 time.Time
package main
import (
"fmt"
"time"
)
func main() {
var milliTs int64 = 1786147200500 // 13 位毫秒级时间戳
t := time.UnixMilli(milliTs)
fmt.Println(t)
}运行结果如下。
2026-08-08 08:00:00.5 +0800 CST分析:
毫秒级时间戳 milliTs 末尾的 500 代表 500 毫秒,也就是 0.5 秒。我们直接调用 time.UnixMilli(milliTs),就能将其还原为带有小数秒 08:00:00.5 的时间对象。
在还原 13 位毫秒级时间戳时,小伙伴们千万不要把它误传给 time.Unix()。下面这种写法就是错误的。
var milliTs int64 = 1786147200500
t := time.Unix(milliTs, 0)因为 time.Unix() 的第 1 个参数接收的是 “秒数”,把 13 位毫秒数直接传进去就会按秒来推算。这样算出来的年份会变成公元五万八千多年以后,大家平时写代码时记得先看清时间戳的位数。
