Go 获取当前时间戳

所谓的时间戳(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 位毫秒数直接传进去就会按秒来推算。这样算出来的年份会变成公元五万八千多年以后,大家平时写代码时记得先看清时间戳的位数。

上一篇:

下一篇:

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号