Golang 时间处理扩展库 timeutil 使用指南

timeutil 是一个常用的 Golang 时间处理扩展库，提供了许多标准库 time 包没有的实用功能。下面我将介绍其主要功能和使用方法。

安装

go get github.com/ikeikeikeike/go-timeutil

主要功能及示例

1. 时间解析增强

import (
	"fmt"
	"github.com/ikeikeikeike/go-timeutil"
)

func main() {
	// 自动解析多种时间格式
	t, _ := timeutil.Parse("2023-01-15")
	fmt.Println(t) // 2023-01-15 00:00:00 +0000 UTC
	
	t, _ = timeutil.Parse("15/01/2023")
	fmt.Println(t) // 2023-01-15 00:00:00 +0000 UTC
}

2. 时间区间计算

// 计算两个时间之间的天数
days := timeutil.BetweenDays(time.Now(), time.Now().Add(24*time.Hour))
fmt.Println(days) // 1

// 检查时间是否在区间内
isBetween := timeutil.Between(
	time.Now(),
	time.Now().Add(-1*time.Hour),
	time.Now().Add(1*time.Hour),
)
fmt.Println(isBetween) // true

3. 时间操作增强

// 获取当天的开始和结束时间
start, end := timeutil.Today()
fmt.Println(start) // 当天00:00:00
fmt.Println(end)   // 当天23:59:59.999999999

// 获取本周的开始和结束时间
weekStart, weekEnd := timeutil.ThisWeek()
fmt.Println(weekStart) // 本周第一天00:00:00
fmt.Println(weekEnd)   // 本周最后一天23:59:59.999999999

// 获取本月的开始和结束时间
monthStart, monthEnd := timeutil.ThisMonth()
fmt.Println(monthStart) // 本月第一天00:00:00
fmt.Println(monthEnd)   // 本月最后一天23:59:59.999999999

4. 时间格式化增强

// 人性化时间显示
fmt.Println(timeutil.Humanize(time.Now().Add(-5*time.Minute))) // 5 minutes ago
fmt.Println(timeutil.Humanize(time.Now().Add(-2*time.Hour)))   // 2 hours ago
fmt.Println(timeutil.Humanize(time.Now().Add(-3*24*time.Hour))) // 3 days ago

// 自定义格式化
fmt.Println(timeutil.Format(time.Now(), "YYYY-MM-DD")) // 2023-01-15
fmt.Println(timeutil.Format(time.Now(), "HH:mm:ss"))   // 14:30:45

5. 时区处理

// 转换时区
loc, _ := time.LoadLocation("Asia/Shanghai")
shanghaiTime := timeutil.In(time.Now(), loc)
fmt.Println(shanghaiTime)

// 获取所有可用时区
zones := timeutil.Zones()
for _, zone := range zones {
	fmt.Println(zone)
}

6. 定时任务辅助

// 等待到下一个整点
timeutil.WaitNextHour()

// 等待到下一个指定分钟
timeutil.WaitNextMinute(30) // 等待到下一个30分

实际应用示例

计算工作日

func countWorkdays(start, end time.Time) int {
	count := 0
	for d := start; d.Before(end); d = d.AddDate(0, 0, 1) {
		if d.Weekday() != time.Saturday && d.Weekday() != time.Sunday {
			count++
		}
	}
	return count
}

func main() {
	start, _ := time.Parse("2006-01-02", "2023-01-01")
	end, _ := time.Parse("2006-01-02", "2023-01-31")
	fmt.Println(countWorkdays(start, end)) // 22 (假设没有节假日)
}

生成时间序列

func generateTimeSeries(start time.Time, interval time.Duration, count int) []time.Time {
	var series []time.Time
	for i := 0; i < count; i++ {
		series = append(series, start.Add(time.Duration(i)*interval))
	}
	return series
}

func main() {
	series := generateTimeSeries(time.Now(), time.Hour, 24)
	for _, t := range series {
		fmt.Println(t)
	}
}

总结

timeutil 库为 Golang 的时间处理提供了许多便利功能，包括：

1. 更灵活的时间解析
2. 时间区间计算
3. 常用时间范围获取
4. 人性化时间显示
5. 时区处理辅助
6. 定时任务支持

虽然标准库的 time 包功能已经很强大了，但在实际开发中，timeutil 这样的扩展库可以显著减少样板代码，提高开发效率。