Go-time

函数/方法

签名

功能说明

示例

time.Now()

func Now() Time

获取当前本地时间

t := time.Now()

time.Date()

func Date(year int, month Month, day, hour, min, sec, nsec int, loc *Location) Time

手动创建指定时间

t := time.Date(2024, time.March, 15, 10, 30, 0, 0, time.Local)

time.Parse()

func Parse(layout, value string) (Time, error)

按指定格式解析字符串为 Time

t, _ := time.Parse("2006-01-02 15:04:05", "2024-03-15 10:30:00")

time.ParseInLocation()

func ParseInLocation(layout, value string, loc *Location) (Time, error)

带时区解析字符串

loc, _ := time.LoadLocation("Asia/Shanghai")<br>t, _ := time.ParseInLocation("2006-01-02", "2024-03-15", loc)

time.Unix()

func Unix(sec int64, nsec int64) Time

从时间戳（秒+纳秒）创建 Time

t := time.Unix(1710570600, 0) // 对应2024-03-15 10:30:00

time.UnixMilli()

func UnixMilli(msec int64) Time

从毫秒时间戳创建 Time

t := time.UnixMilli(1710570600000)

time.UnixMicro()

func UnixMicro(usec int64) Time

从微秒时间戳创建 Time

t := time.UnixMicro(1710570600000000)

方法

签名

功能说明

示例

Year()

func (t Time) Year() int

获取年

year := t.Year()

Month()

func (t Time) Month() Month

获取月（返回 Month 类型，可转 int）

month := t.Month() // 或 int(t.Month())

Day()

func (t Time) Day() int

获取日

day := t.Day()

Hour()

func (t Time) Hour() int

获取小时

hour := t.Hour()

Minute()

func (t Time) Minute() int

获取分钟

min := t.Minute()

Second()

func (t Time) Second() int

获取秒

sec := t.Second()

Nanosecond()

func (t Time) Nanosecond() int

获取纳秒

nsec := t.Nanosecond()

Weekday()

func (t Time) Weekday() Weekday

获取星期（返回 Weekday 类型）

weekday := t.Weekday() // 如 time.Monday

YearDay()

func (t Time) YearDay() int

获取一年中的第几天

yday := t.YearDay()

Location()

func (t Time) Location() *Location

获取时区

loc := t.Location()

方法

签名

功能说明

示例

Format()

func (t Time) Format(layout string) string

格式化时间为字符串

str := t.Format("2006-01-02 15:04:05")

Unix()

func (t Time) Unix() int64

转换为秒级时间戳

ts := t.Unix()

UnixMilli()

func (t Time) UnixMilli() int64

转换为毫秒时间戳

ts := t.UnixMilli()

UnixMicro()

func (t Time) UnixMicro() int64

转换为微秒时间戳

ts := t.UnixMicro()

UnixNano()

func (t Time) UnixNano() int64

转换为纳秒时间戳

ts := t.UnixNano()

In()

func (t Time) In(loc *Location) Time

转换为指定时区的时间

loc, _ := time.LoadLocation("UTC")<br>tUTC := t.In(loc)

Local()

func (t Time) Local() Time

转换为本地时区

tLocal := t.Local()

UTC()

func (t Time) UTC() Time

转换为 UTC 时区

tUTC := t.UTC()

String()

func (t Time) String() string

默认字符串格式

fmt.Println(t) // 等价于 t.String()

Go
package main

import (
"fmt"
"time"
)

func main() {
t := time.Now()
// 格式化输出
fmt.Println(t.Format("2006-01-02")) // 仅日期
fmt.Println(t.Format("15:04:05")) // 仅时间
fmt.Println(t.Format("2006-01-02 15:04:05")) // 日期+时间
// 转换时区
loc, _ := time.LoadLocation("America/New_York")
fmt.Println(t.In(loc).Format("2006-01-02 15:04:05")) // 纽约时间
}

函数/方法

签名

功能说明

示例

time.Duration()

func Duration(d int64) Duration

手动创建 Duration

d := time.Duration(5) * time.Second

time.ParseDuration()

func ParseDuration(s string) (Duration, error)

解析字符串为 Duration

d, _ := time.ParseDuration("2h30m10s")

t.Add()

func (t Time) Add(d Duration) Time

时间加间隔

t2 := t.Add(1 * time.Hour) // 加1小时

t.AddDate()

func (t Time) AddDate(years, months, days int) Time

按年月日加间隔

t2 := t.AddDate(1, 2, 3) // 加1年2月3天

t.Sub()

func (t Time) Sub(u Time) Duration

计算两个时间的间隔

d := t.Sub(t2) // t - t2

t.Before()

func (t Time) Before(u Time) bool

判断 t 是否在 u 之前

if t.Before(t2) { ... }

t.After()

func (t Time) After(u Time) bool

判断 t 是否在 u 之后

if t.After(t2) { ... }

t.Equal()

func (t Time) Equal(u Time) bool

判断两个时间是否相等（比 == 更安全，处理时区）

if t.Equal(t2) { ... }

d.Hours()

func (d Duration) Hours() float64

转换为小时（浮点）

h := d.Hours()

d.Minutes()

func (d Duration) Minutes() float64

转换为分钟（浮点）

m := d.Minutes()

d.Seconds()

func (d Duration) Seconds() float64

转换为秒（浮点）

s := d.Seconds()

d.Milliseconds()

func (d Duration) Milliseconds() int64

转换为毫秒（整数）

ms := d.Milliseconds()

d.Microseconds()

func (d Duration) Microseconds() int64

转换为微秒（整数）

us := d.Microseconds()

d.Nanoseconds()

func (d Duration) Nanoseconds() int64

转换为纳秒（整数）

ns := d.Nanoseconds()

函数/方法

签名

功能说明

示例

time.NewTimer()

func NewTimer(d Duration) *Timer

创建一次性定时器

timer := time.NewTimer(2 * time.Second)<br><-timer.C // 等待2秒

timer.Stop()

func (t *Timer) Stop() bool

停止定时器

timer.Stop()

timer.Reset()

func (t *Timer) Reset(d Duration) bool

重置定时器

timer.Reset(1 * time.Second)

time.After()

func After(d Duration) <-chan Time

简化版 Timer（返回通道）

<-time.After(2 * time.Second) // 等待2秒

time.NewTicker()

func NewTicker(d Duration) *Ticker

创建周期性定时器

ticker := time.NewTicker(1 * time.Second)<br>go func() {<br> for range ticker.C {<br> fmt.Println("tick")<br> }<br>}()<br>time.Sleep(5 * time.Second)<br>ticker.Stop()

ticker.Stop()

func (t *Ticker) Stop()

停止周期性定时器

ticker.Stop()

time.Sleep()

func Sleep(d Duration)

让当前 goroutine 休眠

time.Sleep(2 * time.Second)

函数

签名

功能说明

示例

time.Since()

func Since(t Time) Duration

计算从 t 到现在的间隔（等价于 Now().Sub(t)）

d := time.Since(t)

time.Until()

func Until(t Time) Duration

计算从现在到 t 的间隔（等价于 t.Sub(Now())）

d := time.Until(t)

time.LoadLocation()

func LoadLocation(name string) (*Location, error)

加载指定时区

loc, err := time.LoadLocation("Asia/Shanghai")

time.FixedZone()

func FixedZone(name string, offset int) *Location

创建固定偏移的时区

loc := time.FixedZone("CST", 8*3600) // 东八区

Go
package main

import (
"fmt"
"time"
)

func main() {
start := time.Now()
// 模拟耗时操作
time.Sleep(100 * time.Millisecond)
// 计算耗时
elapsed := time.Since(start)
fmt.Printf("程序执行耗时：%v\n", elapsed) // 输出：程序执行耗时：100.xxxms
}

Go
package main

import (
"fmt"
"time"
)

func main() {
ticker := time.NewTicker(1 * time.Second)
defer ticker.Stop()

count := 0
for range ticker.C {
count++
fmt.Printf("执行第 %d 次任务\n", count)
if count >= 5 {
break
}
}
fmt.Println("定时任务结束")
}

Go
package main

import (
"fmt"
"time"
)

func main() {
// 格式1：带时区
str1 := "2024-03-15T10:30:00+08:00"
t1, _ := time.Parse(time.RFC3339, str1)
fmt.Println(t1.Format("2006-01-02 15:04:05"))

// 格式2：自定义格式
str2 := "2024/03/15 10:30"
t2, _ := time.Parse("2006/01/02 15:04", str2)
fmt.Println(t2.Format("2006-01-02 15:04:05"))
}