go-datebin - 简单高效的Go日期时间处理库

go-datebin 是一个轻量级、高性能的 Go 日期时间处理库，提供了简单易用的 API 来处理日期时间的解析、格式化、计算等操作。

安装

go get github.com/golang-module/go-datebin

核心功能

1. 日期时间解析

package main

import (
	"fmt"
	"github.com/golang-module/go-datebin"
)

func main() {
	// 解析字符串为时间
	t, err := datebin.Parse("2023-05-15 14:30:45")
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	fmt.Println("解析结果:", t) // 2023-05-15 14:30:45 +0000 UTC
	
	// 支持多种格式自动识别
	t2, _ := datebin.Parse("2023/05/15")
	fmt.Println(t2) // 2023-05-15 00:00:00 +0000 UTC
	
	// 指定格式解析
	t3, _ := datebin.ParseWithFormat("15-May-2023", "02-Jan-2006")
	fmt.Println(t3) // 2023-05-15 00:00:00 +0000 UTC
}

2. 日期时间格式化

func formatExample() {
	now := datebin.Now()
	
	// 默认格式
	fmt.Println(now.String()) // 2023-05-15 14:30:45
	
	// 自定义格式
	fmt.Println(now.Format("2006年01月02日 15:04:05")) // 2023年05月15日 14:30:45
	
	// 常用快捷格式
	fmt.Println(now.ToDateString())     // 2023-05-15
	fmt.Println(now.ToTimeString())     // 14:30:45
	fmt.Println(now.ToDateTimeString()) // 2023-05-15 14:30:45
}

3. 日期时间计算

func calculateExample() {
	now := datebin.Now()
	
	// 加减时间
	fmt.Println("明天:", now.AddDay(1))
	fmt.Println("上周:", now.SubWeek(1))
	
	// 开始和结束时间
	fmt.Println("今天开始:", now.StartOfDay())
	fmt.Println("本月结束:", now.EndOfMonth())
	
	// 时间差计算
	t1, _ := datebin.Parse("2023-05-15")
	t2, _ := datebin.Parse("2023-06-20")
	fmt.Println("相差天数:", t1.DiffInDays(t2)) // 36
}

4. 日期时间比较

func compareExample() {
	t1, _ := datebin.Parse("2023-05-15")
	t2, _ := datebin.Parse("2023-06-20")
	
	fmt.Println("t1 是否在 t2 之前:", t1.Before(t2)) // true
	fmt.Println("t1 是否在 t2 之后:", t1.After(t2))  // false
	fmt.Println("t1 是否等于 t2:", t1.Equal(t2))    // false
	
	// 判断是否在范围内
	t3 := datebin.Now()
	start, _ := datebin.Parse("2023-01-01")
	end, _ := datebin.Parse("2023-12-31")
	fmt.Println("t3 是否在2023年内:", t3.Between(start, end)) // true
}

5. 时区处理

func timezoneExample() {
	// 设置默认时区
	datebin.SetTimezone("Asia/Shanghai")
	
	// 获取当前时间(带时区)
	now := datebin.Now()
	fmt.Println("上海时间:", now)
	
	// 转换时区
	nyTime := now.SetTimezone("America/New_York")
	fmt.Println("纽约时间:", nyTime)
	
	// 获取时区信息
	fmt.Println("时区:", now.Timezone())       // Asia/Shanghai
	fmt.Println("时区偏移:", now.Offset()/3600) // 8 (小时)
}

性能优势

go-datebin 相比标准库 time 包和其他日期时间库有以下优势：

1. 更简洁的 API 设计
2. 内置常用日期时间操作
3. 更好的时区支持
4. 更高的解析性能
5. 更丰富的格式化选项

实际应用示例

package main

import (
	"fmt"
	"github.com/golang-module/go-datebin"
)

func main() {
	// 用户注册时间处理示例
	userRegTime := "2023-03-10T15:30:00Z"
	
	// 解析注册时间
	regTime, err := datebin.Parse(userRegTime)
	if err != nil {
		fmt.Println("解析注册时间失败:", err)
		return
	}
	
	// 计算使用天数
	daysUsed := regTime.DiffInDays(datebin.Now())
	
	// 判断是否新用户(7天内)
	isNewUser := daysUsed <= 7
	
	// 计算会员到期时间(注册后30天)
	memberExpire := regTime.AddDay(30)
	
	// 输出结果
	fmt.Printf("用户已使用 %d 天\n", daysUsed)
	fmt.Printf("是否新用户: %t\n", isNewUser)
	fmt.Printf("会员到期时间: %s\n", memberExpire.Format("2006年01月02日"))
	
	// 判断会员是否即将到期(7天内)
	if memberExpire.DiffInDays(datebin.Now()) <= 7 && !memberExpire.Before(datebin.Now()) {
		fmt.Println("温馨提示: 您的会员即将到期")
	}
}

go-datebin 是一个非常适合日常开发的日期时间处理库，它简化了 Go 中日期时间处理的复杂性，同时保持了高性能和灵活性。无论是简单的日期格式化还是复杂的时间计算，go-datebin 都能提供简单高效的解决方案。