import "time"
1. 时间处理类型
Go 中时间处理依赖的数据类型: time.Time,time.Month,time.Weekday,time.Duration,time.Location。
1.1 time.Time 时间点
time.Time 代表一个纳秒精度的时间点.
/usr/local/go/src/time/time.go 定义如下:
type Time struct {
sec int64 // 从1年1月1日 00:00:00 UTC 至今过去的秒数
nsec int32 // 最近一秒到下一秒过去的纳秒数
loc *Location // 时区
}
时间变量标识一个具体的时间点，演示如下：
var t time.Time // 定义 time.Time 类型变量
t = time.Now() // 获取当前时间
fmt.Printf("时间: %v,时区: %v,时间类型: %T\n",t,t.Location(),t)
// 时间: 2017-02-22 09:06:05.816187261 +0800 CST,时区: Local,时间类型: time.Time
// time.UTC() time 返回UTC 时区的时间
fmt.Printf("时间: %v,t.UTC(),t.UTC().Location(),t)
// 时间: 2017-02-22 01:07:15.179280004 +0000 UTC,时区: UTC,时间类型: time.Time
代码中应使用time.Time 类型值来保存和传递时间，而不能用指针。表示时间的变量和字段，应为time.Time类型，而不是*time.Time类型。
每一个时间点都具有时区信息，当计算时间的表示格式时，如Format、Hour和Year等方法，都会考虑该信息。Local、UTC和In方法返回一个指定时区（但指向同一时间点）的Time。修改时区信息只是会改变其表示，不会修改被表示的时间点。
1.2 time.Month 月份
time.Month 代表一年中的某个月
/usr/local/go/src/time/time.go 定义如下:
type Month int
和月份相关的常量如下:
const (
January Month = 1 + iota
February
March
April
May
June
July
August
September
October
November
December
)
1.3 time.Weekday 星期
time.Weekday 代表一周的周几。
/usr/local/go/src/time/time.go 定义如下:
type Weekday int
和星期相关的常量:
const (
Sunday Weekday = iota
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
)
1.4 time.Duration 时间段
time.Duration 类型代表两个时间点之间经过的纳秒数，可表示的最长时间段约为290年。
/usr/local/go/src/time/time.go 定义如下:
type Duration int64
涉及常量如下:
const (
Nanosecond Duration = 1
Microsecond = 1000 * Nanosecond
Millisecond = 1000 * Microsecond
Second = 1000 * Millisecond
Minute = 60 * Second
Hour = 60 * Minute
)
1.5 time.Location 时区
Location代表一个地点，以及该地点所在的时区信息。北京时间可以使用 Asia/Shanghai
/usr/local/go/src/time/zoneinfo.go 中定义:
type Location struct {
name string
zone []zone
tx []zoneTrans
cacheStart int64
cacheEnd int64
cacheZone *zone
}
预定义时区变量:
var UTC *Location = &utcLoc
var Local *Location = &localLoc
2. time.Time 方法
介绍 time.Time 接受者的方法：获取时间点，获取时间相关信息，时间比较，计算和序列化操作。
示例代码文件: $GOPATH/src/github.com/ironxu/go_note/library/time/time.go
2.1 获取一个时间的方法
func Now() Time {}// 当前本地时间func Unix(sec int64,nsec int64) Time {}// 根据时间戳返回本地时间func Date(year int,month Month,day,hour,min,sec,nsec int,loc *Location) Time {}// 返回指定时间
// 当前本地时间
t = time.Now()
fmt.Println("'time.Now': ",t)
// 根据时间戳返回本地时间
t_by_unix := time.Unix(1487780010,0)
fmt.Println("'time.Unix': ",t_by_unix)
// 返回指定时间
t_by_date := time.Date(2017,time.Month(2),23,1,30,0,l)
fmt.Println("'time.Date': ",t_by_date)
2.2 时间显示
func (t Time) UTC() Time {}// 获取指定时间在UTC 时区的时间表示func (t Time) Local() Time {}// 以本地时区表示func (t Time) In(loc *Location) Time {}// 时间在指定时区的表示func (t Time) Format(layout string) string {}// 按指定格式显示时间
// 获取指定时间在UTC 时区的时间表示
t_by_utc := t.UTC()
fmt.Println("'t.UTC': ",t_by_utc)
// 获取本地时间表示
t_by_local := t.Local()
fmt.Println("'t.Local': ",t_by_local)
// 时间在指定时区的表示
t_in := t.In(time.UTC)
fmt.Println("'t.In': ",t_in)
// Format
fmt.Println("t.Format",t.Format(time.RFC3339))
2.3 获取日期信息
func (t Time) Date() (year int,day int) {}// 返回时间的日期信息func (t Time) Year() int {}// 返回年func (t Time) Month() Month {}// 月func (t Time) Day() int {}// 日func (t Time) Weekday() Weekday {}// 星期func (t Time) ISOWeek() (year,week int) {}// 返回年，星期范围编号func (t Time) Clock() (hour,sec int) {}// 返回时间的时分秒func (t Time) Hour() int {}// 返回小时func (t Time) Minute() int {}// 分钟func (t Time) Second() int {}// 秒func (t Time) Nanosecond() int {}// 纳秒func (t Time) YearDay() int {}// 一年中对应的天func (t Time) Location() *Location {}// 时间的时区func (t Time) Zone() (name string,offset int) {}// 时间所在时区的规范名和想对UTC 时间偏移量func (t Time) Unix() int64 {}// 时间转为时间戳func (t Time) UnixNano() int64 {}// 时间转为时间戳（纳秒）
// 返回时间的日期信息
year,month,day := t.Date()
fmt.Println("'t.Date': ",year,day)
// 星期
week := t.Weekday()
fmt.Println("'t.Weekday': ",week)
// 返回年，星期范围编号
year,week_int := t.ISOWeek()
fmt.Println("'t.ISOWeek': ",week_int)
// 返回时间的时分秒
hour,sec := t.Clock()
fmt.Println("'t.Clock': ",sec)
2.4 时间比较与计算
func (t Time) IsZero() bool {}// 是否是零时时间func (t Time) After(u Time) bool {}// 时间在u 之前func (t Time) Before(u Time) bool {}// 时间在u 之后func (t Time) Equal(u Time) bool {}// 时间与u 相同func (t Time) Add(d Duration) Time {}// 返回t +d 的时间点func (t Time) Sub(u Time) Duration {}// 返回 t-ufunc (t Time) AddDate(years int,months int,days int) Time {}返回增加了给出的年份、月份和天数的时间点Time
// 返回增加了给出的年份、月份和天数的时间点Time
t_new := t.AddDate(0,1)
fmt.Println("'t.AddDate': ",t_new)
// 时间在u 之前
is_after := t.After(t_new)
fmt.Println("'t.After': ",is_after)
2.6 时间序列化
func (t Time) MarshalBinary() ([]byte,error) {}// 时间序列化func (t Time) UnmarshalBinary(data []byte) error {}// 反序列化func (t Time) MarshalJSON() ([]byte,error) {}// 时间序列化func (t Time) MarshalText() ([]byte,error) {}// 时间序列化func (t Time) GobEncode() ([]byte,error) {}// 时间序列化func (t Time) GobDecode() ([]byte,error) {}// 时间序列化
// 时间序列化
t_byte,err := t.MarshalJSON()
fmt.Println("'t.MarshalJSON': ",t_byte,err)
// 时间数据反序列化
var t_un time.Time
err = t_un.UnmarshalJSON(t_byte)
fmt.Println("'t_un.UnmarshalJSON': ",t_un,err)
3. time.Duration 方法
介绍 time.Duration 时间段接受者的方法：输出和改变时间段单位。
func (d Duration) String() string// 格式化输出 Durationfunc (d Duration) Nanoseconds() int64// 将时间段表示为纳秒func (d Duration) Seconds() float64// 将时间段表示为秒func (d Duration) Minutes() float64// 将时间段表示为分钟func (d Duration) Hours() float64// 将时间段表示为小时
// time.Duration 时间段
fmt.Println("time.Duration 时间段")
d = time.Duration(10000000000000)
fmt.Printf("'String: %v','Nanoseconds: %v','Seconds: %v','Minutes: %v','Hours: %v'\n",d.String(),d.Nanoseconds(),d.Seconds(),d.Minutes(),d.Hours())
// 'String: 2h46m40s','Nanoseconds: 10000000000000','Seconds: 10000','Minutes: 166.66666666666666','Hours: 2.7777777777777777'
4. time.Location 方法
time.Location 时区的导出函数
func (l *Location) String() string// 输出时区名func FixedZone(name string,offset int) *Location// FixedZone 使用给定的地点名name和时间偏移量offset（单位秒）创建并返回一个Locationfunc LoadLocation(name string) (*Location,error)// LoadLocation 使用给定的名字创建Location
var local *time.Location
local,ok := time.LoadLocation("Asia/Shanghai")
fmt.Printf("%v,%T,%v\n",local,ok)
5. 其他方法
func Sleep(d Duration)// Sleep阻塞当前go程至少d代表的时间段。d<=0时，Sleep会立刻返回
d_second := time.Second
time.Sleep(d_second)
参考资料
可以关注我的微博了解更多信息: @刚刚小码农
