go package學習——time

package time提供測量和顯示時間的能力。

Index

• Constants
• func After(d Duration) <-chan Time
• func Sleep(d Duration)
• func Tick(d Duration) <-chan Time
• type Duration
  • func ParseDuration(s string) (Duration, error)
  • func Since(t Time) Duration
  • func (d Duration) Hours() float64
  • func (d Duration) Minutes() float64
  • func (d Duration) Nanoseconds() int64
  • func (d Duration) Seconds() float64
  • func (d Duration) String() string
• 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
• type ParseError
  • func (e *ParseError) Error() string
• type Ticker
  • func NewTicker(d Duration) *Ticker
  • func (t *Ticker) Stop()
• type Time
  • func Date(year int, month Month, day, hour, min, sec, nsec int, loc *Location) Time
  • func Now() Time
  • func Parse(layout, value string) (Time, error)
  • 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
  • func (t Time) Before(u Time) bool
  • func (t Time) Clock() (hour, min, sec int)
  • func (t Time) Date() (year int, month Month, day int)
  • func (t Time) Day() int
  • func (t Time) Equal(u Time) bool
  • func (t Time) Format(layout string) string
  • func (t *Time) GobDecode(buf []byte) error
  • func (t Time) GobEncode() ([]byte, error)
  • func (t Time) Hour() int
  • func (t Time) ISOWeek() (year, week int)
  • func (t Time) In(loc *Location) Time
  • func (t Time) IsZero() bool
  • func (t Time) Local() Time
  • func (t Time) Location() *Location
  • func (t Time) MarshalJSON() ([]byte, error)
  • func (t Time) Minute() int
  • func (t Time) Month() Month
  • func (t Time) Nanosecond() int
  • func (t Time) Round(d Duration) Time
  • func (t Time) Second() int
  • func (t Time) String() string
  • func (t Time) Sub(u Time) Duration
  • func (t Time) Truncate(d Duration) Time
  • func (t Time) UTC() Time
  • func (t Time) Unix() int64
  • func (t Time) UnixNano() int64
  • func (t *Time) UnmarshalJSON(data []byte) (err error)
  • func (t Time) Weekday() Weekday
  • func (t Time) Year() int
  • func (t Time) YearDay() int
  • func (t Time) Zone() (name string, offset int)
• type Timer
  • func AfterFunc(d Duration, f func()) *Timer
  • func NewTimer(d Duration) *Timer
  • func (t *Timer) Reset(d Duration) bool
  • func (t *Timer) Stop() bool
• type Weekday
  • func (d Weekday) String() string

Examples

• After
• Date
• Duration
• Month
• Parse
• ParseInLocation
• Sleep
• Tick
• Time.Format
• Time.Round
• Time.Truncate

Package Files

format.go sleep.go sys_unix.go tick.go time.go zoneinfo.go zoneinfo_read.go zoneinfo_unix.go

1. 基本函數

func After

func After(d Duration) <-chan Time

在等待了d時間間隔後，向返回channel發送當前時間。與NewTimer(d).C等效。事例以下：

select {
case m := <-c:
    handle(m)
case <-time.After(5 * time.Minute):
    fmt.Println("timed out")
}

主要用於超時處理，以防死鎖。

func Sleep

func Sleep(d Duration)

掛起當前goroutine，d時間間隔。

time.Sleep(100 * time.Millisecond)

func Tick

func Tick(d Duration) <-chan Time

Tick是NewTicker的一個封裝，只用於訪問ticking channel；用戶不須要關閉ticker。示例：

c := time.Tick(1 * time.Minute)
for now := range c {
    fmt.Printf("%v %s\n", now, statusUpdate())
}

2. type Duration

type Duration

type Duration int64

Duration是兩個納秒時間標記之間的間隔，其表示的最大間隔是290年。

const (
    Nanosecond  Duration = 1
    Microsecond          = 1000 * Nanosecond
    Millisecond          = 1000 * Microsecond
    Second               = 1000 * Millisecond
    Minute               = 60 * Second
    Hour                 = 60 * Minute
)

上面的常量都是經常使用的duration，須要記住。

若是將一個整數轉化成一個duration的話，須要這麼作：

seconds := 10
fmt.Print(time.Duration(seconds)*time.Second) // prints 10s

計算通過的時間間隔的示例以下，此示例很通用：

t0 := time.Now()
expensiveCall()
t1 := time.Now()
fmt.Printf("The call took %v to run.\n", t1.Sub(t0))

func Since

func Since(t Time) Duration

Since返回從時間t開始的已流逝時間，它是time.Now().Sub(t)的濃縮版。

3. type Month

type Month

type Month int

const (
    January Month = 1 + iota
    February
    March
    April
    May
    June
    July
    August
    September
    October
    November
    December
)

注意其寫法。

4. type Ticker

type Ticker

type Ticker struct {
    C <-chan Time // The channel on which the ticks are delivered.
    // contains filtered or unexported fields
}

Ticker包含一個channel，此channel以固定間隔發送ticks。

func NewTicker

func NewTicker(d Duration) *Ticker

返回一個Ticker，此Ticker包含一個channel，此channel以給定的duration發送時間。duration d必須大於0.

func (*Ticker) Stop

func (t *Ticker) Stop()

用於關閉相應的Ticker，但並不關閉channel。

5. type Time

type Time

type Time struct {      // contains filtered or unexported fields }

Time以納秒來表示一個時刻。程序應該存儲或傳遞Time值，而不是指針，即time.Time，而非*time.Time。

6. type Timer

type Timer

type Timer struct {
    C <-chan Time
    // contains filtered or unexported fields
}

Timer type表明了一個事件，若是不是被AfterFunc建立的Timer，當Timer過時，當前時間將發送到C。

func AfterFunc

func AfterFunc(d Duration, f func()) *Timer

AfterFunc等待duration耗盡後，在當前的goroutine中調用f函數。它返回一個Timer，利用此Timer的Stop方法，能夠取消調用f函數。