Kair - Golang日期时间处理库

Kair是一个轻量级的Golang日期时间处理库，提供了简洁易用的API来处理日期时间的格式化、解析、计算等操作。下面我将详细介绍Kair的主要功能和使用方法。

安装

go get github.com/GuilhermeCaruso/kair

基本用法

1. 日期时间格式化

Kair使用类似于PHP date函数的格式化字符串：

package main

import (
	"fmt"
	"github.com/GuilhermeCaruso/kair"
	"time"
)

func main() {
	now := time.Now()
	
	// 使用Kair格式化
	fmt.Println(kair.Format("Y-m-d H:i:s", now)) // 输出: 2023-03-15 14:30:45
	fmt.Println(kair.Format("d/m/Y", now))       // 输出: 15/03/2023
	fmt.Println(kair.Format("H:i A", now))       // 输出: 14:30 PM
}

2. 日期时间解析

package main

import (
	"fmt"
	"github.com/GuilhermeCaruso/kair"
)

func main() {
	// 解析日期字符串
	t, err := kair.Parse("Y-m-d H:i:s", "2023-03-15 14:30:45")
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	fmt.Println(t) // 输出解析后的time.Time对象
}

3. 日期时间计算

package main

import (
	"fmt"
	"github.com/GuilhermeCaruso/kair"
	"time"
)

func main() {
	now := time.Now()
	
	// 增加时间
	future := kair.Add(now, kair.DateInterval{Days: 5, Hours: 2})
	fmt.Println("5天2小时后:", future)
	
	// 减少时间
	past := kair.Sub(now, kair.DateInterval{Months: 1, Minutes: 30})
	fmt.Println("1个月30分钟前:", past)
}

格式化符号参考

高级用法

1. 自定义本地化

package main

import (
	"fmt"
	"github.com/GuilhermeCaruso/kair"
	"time"
)

func main() {
	// 设置自定义月份和星期名称
	kair.SetLocale(kair.Locale{
		MonthNames: []string{
			"一月", "二月", "三月", "四月", "五月", "六月",
			"七月", "八月", "九月", "十月", "十一月", "十二月",
		},
		WeekdayNames: []string{
			"周日", "周一", "周二", "周三", "周四", "周五", "周六",
		},
	})
	
	now := time.Now()
	fmt.Println(kair.Format("Y年m月d日 D", now)) // 输出: 2023年03月15日 周三
}

2. 相对时间显示

package main

import (
	"fmt"
	"github.com/GuilhermeCaruso/kair"
	"time"
)

func main() {
	now := time.Now()
	
	// 5分钟前
	past := now.Add(-5 * time.Minute)
	fmt.Println(kair.RelativeTime(past, now)) // 输出: 5分钟前
	
	// 2小时后
	future := now.Add(2 * time.Hour)
	fmt.Println(kair.RelativeTime(future, now)) // 输出: 2小时后
}

性能考虑

Kair在设计时考虑了性能因素，但对于高频调用的场景，建议：

1. 复用time.Time对象
2. 对于固定格式，预编译格式字符串
3. 在高并发场景下考虑使用sync.Pool

总结

Kair提供了简单直观的API来处理Golang中的日期时间操作，特别适合需要复杂格式化或从其他语言(如PHP)迁移的项目。它的主要优势包括：

1. 易记的格式化符号
2. 完整的日期时间计算功能
3. 本地化支持
4. 相对时间显示

对于更复杂的需求，可以结合标准库的time包一起使用。