Golang中time包
轉載自ofollow,noindex">https://studygolang.com/articles/4331
time包中包括兩類時間：時間點（某一時刻）和時常（某一段時間）
１時間常量（時間格式化）
const ( ANSIC= "Mon Jan _2 15:04:05 2006" UnixDate= "Mon Jan _2 15:04:05 MST 2006" RubyDate= "Mon Jan 02 15:04:05 -0700 2006" RFC822= "02 Jan 06 15:04 MST" RFC822Z= "02 Jan 06 15:04 -0700" // RFC822 with numeric zone RFC850= "Monday, 02-Jan-06 15:04:05 MST" RFC1123= "Mon, 02 Jan 2006 15:04:05 MST" RFC1123Z= "Mon, 02 Jan 2006 15:04:05 -0700" // RFC1123 with numeric zone RFC3339= "2006-01-02×××5:04:05Z07:00" RFC3339Nano = "2006-01-02×××5:04:05.999999999Z07:00" Kitchen= "3:04PM"// Handy time stamps. Stamp= "Jan _2 15:04:05" StampMilli = "Jan _2 15:04:05.000" StampMicro = "Jan _2 15:04:05.000000" StampNano= "Jan _2 15:04:05.000000000" )
這些常量是在time包中進行time 格式化 和time解析而預定義的一些常量，其實他們使用的都是一個特定的時間：
Mon Jan 2 15:04:05 MST 2006
這個時間是Unix time 1136239445，因為MST是GMT-0700，所以這個指定的時間也可以看做
01/02 03:04:05PM '06 -0700
可見程式猿也有調皮的一面．
因此我們只需要利用上面這些時間變可以隨意的指定自己的時間格式，例如：
layout := "01__02-2006 3.04.05 PM"
fmt.Println(time.Now().Format(layout))
便會輸出類似的時間：11__26-2014 8.40.00 PM
２函式
time 組成：
time.Duration（時間長度，消耗時間）
time.Time（時間點）
time.C（放時間的channel通道）（注：Time.C:=make(chan time.Time)）
After函式：
１）func After(d Duration) <-chan Time
表示多少時間之後，但是在取出channel內容之前不阻塞，後續程式可以繼續執行
２）func Sleep(d Duration) 表示休眠多少時間，休眠時處於阻塞狀態，後續程式無法執行．
舉例說明二者區別：
fmt.Println("hello")
chan := time.After(time.Secone*1)
fmt.Println("World")
則程式在執行完輸出hello後，接著便輸出world，不用等待１s，但是１s後，chan中有資料，此時chan阻塞
mt.Println("hello")
chan := time.Sleep(time.Secone*1)
fmt.Println("World")
則表示在輸出hello後，程式變休眠1s中，然後才輸出World．由此可見阻塞和非阻塞便是這兩個函式的本質區別．
鑑於After特性，其通常用來處理程式超時問題，如下所示：
select {
case m := <-c:
handle(m)
case <-time.After(5 * time.Minute):
fmt.Println("timed out")
}
３）func Tick(d Duration) <-chan Time
time.Tick(time.Duration)用法和time.After差不多， 但是它是表示每隔多少時間之後，是一個重複的過程 ，其他與After一致
4)type Duration int64 //時間長度，其對應的時間單位有Nanosecond，Microsecond,Millisecond,Second,Minute,Hour
(1)func ParseDuration(s string) (Duration, error)//傳入字串，返回響應的時間，其中傳入的字串中的有效時間單位如下：h,m,s,ms,us,ns，其他單位均無效，如果傳入無效時間單位，則會返回０
(2)func Since(t Time) Duration //表示自從t時刻以後過了多長時間，是一個時間段，相當於time.Now().Sub(t)
(3)func (d Duration) Hours() float64 //將制定時間段換算為float64型別的Hour為單位進行輸出
(4)func (d Duration) Minutes() float64 //將制定時間段換算為float64型別的Minutes為單位進行輸出
(5)func (d Duration) Nanoseconds() int64 //將制定時間段換算為int64型別的Nanoseconds為單位進行輸出
(6)func (d Duration) Seconds() float64 //將制定時間段換算為float64型別的Seconds為單位進行輸出
(7)func(d Duration) String() string //與ParseDuration函式相反，該函式是將時間段轉化為字串輸出
5) type Location
func FixedZone(name string, offset int) *Location
func LoadLocation(name string) (*Location, error)
func (l *Location) String() string
６）type Month //定義了１年的１２個月
func (m Month) String() string //將時間月份以字串形式打印出來．如fmt.Println(time.June.String())則打印出June
７）type ParseError
func (e *ParseError) Error() string
８）type Ticker //主要用來按照指定的時間週期來呼叫函式或者計算表示式，通常的使用方式是利用go新開一個協程使用，它是一個斷續器
func NewTicker(d Duration) *Ticker //新生成一個ticker,此Ticker包含一個channel，此channel以給定的duration傳送時間。duration d必須大於0
func (t *Ticker) Stop() //用於關閉相應的Ticker，但並不關閉channel
例子如下：
使用時間控制停止ticker
ticker := time.NewTicker(time.Millisecond * 500)
go func() {
for t := range ticker.C {
fmt.Println("Tick at", t)
}
}()
time.Sleep(time.Millisecond * 1500)//阻塞，則執行次數為sleep的休眠時間/ticker的時間
ticker.Stop()
fmt.Println("Ticker stopped")
使用channel控制停止ticker
ticker := time.NewTicker(time.Millisecond * 500)
c := make(chan int，num) //num為指定的執行次數
go func() {
for t := range ticker.C {
c<-1
fmt.Println("Tick at", t)
}
}()
ticker.Stop()這種情況下，在執行num次以Ticker時間為單位的函式之後，c channel中已滿，以後便不會再執行對應的函式．
９）type Time//包括日期和時間
func Date(year int, month Month, day, hour, min, sec, nsec int, loc *Location) Time//按照指定格式輸入資料後，便會按照如下格式輸出對應的時間，輸出格式為
yyyy-mm-dd hh:mm:ss + nsec nanoseconds， 其中loc必須指定，否則便會panic，
例子如下：
t := time.Date(2009, time.November, 10, 23, 0, 0, 0, time.UTC)
fmt.Printf("Go launched at %s\n", t.Local())
輸出為：
func Now() Time //返回當前時間，包括日期，時間和時區
func Parse(layout, value string) (Time, error)//輸入格式化layout和時間字串，輸出時間
func ParseInLocation(layout, value string, loc *Location) (Time, error)
func Unix(sec int64, nsec int64) Time//返回本地時間
func (t Time) Add(d Duration) Time//增加時間
func (t Time) AddDate(years int, months int, days int) Time//增加日期
func (t Time) After(u Time) bool//判斷時間t是否在時間ｕ的後面
func (t Time) Before(u Time) bool//判斷時間t是否在時間ｕ的前面
func (t Time) Clock() (hour, min, sec int)//獲取時間ｔ的hour,min和second
func (t Time) Date() (year int, month Month, day int)//獲取時間ｔ的year,month和day
func (t Time) Day() int //獲取時間ｔ的day
func (t Time) Equal(u Time) bool //判斷時間t和時間u是否相同
func (t Time) Format(layout string) string //時間字串格式化
func (t *Time) GobDecode(data []byte) error //編碼為god
func (t Time) GobEncode() ([]byte, error)//解碼god
func (t Time) Hour() int//獲取時間ｔ的小時
func (t Time) ISOWeek() (year, week int)//獲取時間ｔ的年份和星期
func (t Time) In(loc *Location) Time//獲取loc時區的時間ｔ的對應時間
func (t Time) IsZero() bool//判斷是否為０時間例項January 1, year 1, 00:00:00 UTC
func (t Time) Local() Time//獲取當地時間
func (t Time) Location() *Location //獲取當地時區
func (t Time) MarshalBinary() ([]byte, error)//marshal binary序列化，將時間t序列化後存入[]byte陣列中
func (t Time) MarshalJSON() ([]byte, error) //marshal json序列化，將時間t序列化後存入[]byte陣列中
func (t Time) MarshalText() ([]byte, error) //marshal text序列化，將時間t序列化後存入[]byte陣列中
舉例說明： a := time.Now() fmt.Println(a) 輸出：2014-11-27 14:58:31.583853811 +0800 CST b, _ := a.MarshalText() fmt.Println(b) 輸出：[50 48 49 52 45 49 49 45 50 55 84 49 52 58 53 56 58 51 49 46 53 56 51 56 53 51 56 49 49 43 48 56 58 48 48] var c = new(time.Time) fmt.Println(c) 輸出：0001-01-01 00:00:00 +0000 UTC c.UnmarshalText(b) fmt.Println(c) 輸出：2014-11-27 14:58:31.583853811 +0800 CST 可見Marshal類的函式只是提供一個將時間t序列化為[]byte陣列的功能，利用UnMarshal類的函式可以獲取到原來的時間t
func (t Time) Minute() int//獲取時間ｔ的分鐘
func (t Time) Month() Month//獲取時間ｔ的月份
func (t Time) Nanosecond() int//獲取時間ｔ的納秒
func (t Time) Round(d Duration) Time//將時間ｔ以d Duration為單位進行四捨五入求近似值．
示例如下：
程式碼：
t := time.Date(0, 0, 0, 12, 15, 30, 918273645, time.UTC)
round := []time.Duration{
time.Nanosecond,
time.Microsecond,
time.Millisecond,
time.Second,
2 * time.Second,
time.Minute,
10 * time.Minute,
time.Hour,
}
for _, d := range round {
fmt.Printf("t.Round(%6s) = %s\n", d, t.Round(d).Format("15:04:05.999999999"))
}
輸出：
t.Round(1ns) = 12:15:30.918273645 t.Round(1µs) = 12:15:30.918274 t.Round(1ms) = 12:15:30.918 t.Round(1s) = 12:15:31 t.Round(2s) = 12:15:30 t.Round(1m0s) = 12:16:00 t.Round( 10m0s) = 12:20:00 t.Round(1h0m0s) = 12:00:00
func (t Time) Second() int//獲取時間ｔ的秒
func (t Time) String() string//獲取時間ｔ的字串表示
func (t Time) Sub(u Time) Duration//與Add相反，Sub表示從時間ｔ中減去時間ｕ
func (t Time) Truncate(d Duration) Time//去尾法求近似值
示例程式碼如下：
程式碼：
t, _ := time.Parse("2006 Jan 02 15:04:05", "2012 Dec 07 12:15:30.918273645")
trunc := []time.Duration{
time.Nanosecond,
time.Microsecond,
time.Millisecond,
time.Second,
2 * time.Second,
time.Minute,
10 * time.Minute,
time.Hour,
}
for _, d := range trunc {
fmt.Printf("t.Truncate(%6s) = %s\n", d, t.Truncate(d).Format("15:04:05.999999999"))
}
輸出：
t.Truncate(1ns) = 12:15:30.918273645 t.Truncate(1µs) = 12:15:30.918273 t.Truncate(1ms) = 12:15:30.918 t.Truncate(1s) = 12:15:30 t.Truncate(2s) = 12:15:30 t.Truncate(1m0s) = 12:15:00 t.Truncate( 10m0s) = 12:10:00 t.Truncate(1h0m0s) = 12:00:00
func (t Time) UTC() Time//將本地時間變換為UTC時區的時間並返回
func (t Time) Unix() int64//返回Unix時間，該時間是從January 1, 1970 UTC這個時間開始算起的．
func (t Time) UnixNano() int64//以納秒為單位返回Unix時間
func (t *Time) UnmarshalBinary(data []byte) error//將data資料反序列化到時間ｔ中
func (t *Time) UnmarshalJSON(data []byte) (err error)//將data資料反序列化到時間ｔ中
func (t *Time) UnmarshalText(data []byte) (err error)//將data資料反序列化到時間ｔ中
func (t Time) Weekday() Weekday//獲取時間ｔ的Weekday
func (t Time) Year() int//獲取時間ｔ的Year
func (t Time) YearDay() int //獲取時間ｔ的YearDay，即１年中的第幾天
func (t Time) Zone() (name string, offset int)
１０）type Timer//用於在指定的Duration型別時間後呼叫函式或計算表示式，它是一個計時器
func AfterFunc(d Duration, f func()) *Timer//和After差不多，意思是多少時間之後執行函式f
func NewTimer(d Duration) *Timer//使用NewTimer(),可以返回的Timer型別在計時器到期之前,取消該計時器
func (t *Timer) Reset(d Duration) bool//重新設定timer t的Duration d.
func (t *Timer) Stop() bool//阻止timer事件發生，當該函式執行後，timer計時器停止，相應的事件不再執行
１１）type Weekday
func (d Weekday) String() string//獲取一週的字串