time

Documentation

Index

• Constants
• func GetCurrentDayOfMonth(t time.Time) (day int)
• func GetCurrentDayOfYear(t time.Time) (day int, err error)
• func GetTimeStamp(length int) string
• func OnTimer(kind, duration int, callback func() error) chan error
• type Ztime
  • func (this *Ztime) AddHour(n int) *Ztime
  • func (this *Ztime) AddMinute(n int) *Ztime
  • func (this *Ztime) Format(format string) (string, error)
  • func (this *Ztime) Now() *Ztime
  • func (this *Ztime) SetLocation(timezone string) *Ztime
  • func (this *Ztime) String() (string, error)
  • func (this *Ztime) UTC() *Ztime
  • func (this *Ztime) UnixNano(length int) string

Constants

const (
	OnDay = iota
	OnHour
	OnMin
	OnSecond
)

Functions

func GetCurrentDayOfMonth

func GetCurrentDayOfMonth(t time.Time) (day int)

GetCurrentDayOfMonth 获取给定的时间是当月的第几天

func GetCurrentDayOfYear

func GetCurrentDayOfYear(t time.Time) (day int, err error)

func GetTimeStamp

func GetTimeStamp(length int) string

GetTimeStamp 获取当前时间戳 length 10:获取秒 13:获取毫秒

func OnTimer

func OnTimer(kind, duration int, callback func() error) chan error

OnTimer 定时发生器 OnDay 每天零时执行callback OnHour 每个小时执行callback OnMin 每分钟执行callback OnSecond 每秒钟执行callback 如果执行过程出现error, 则通过chan error获取具体错误原因

##### Example

```go //定时每天执行callback函数 package main

import (

"github.com/andy-zhangtao/gogather/zlog"
"github.com/sirupsen/logrus"
"github.com/andy-zhangtao/gogather/time"

)

var z *zlog.Zlog

func callback() error {
	logrus.WithFields(z.Fields(logrus.Fields{"from": "callback"})).Info("callback")
	return nil
}

func main() {
	z = zlog.GetZlog()

	time.OnTimer(time.OnDay, 1, callback)
}

```

Types

type Ztime

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

func (*Ztime) AddHour

func (this *Ztime) AddHour(n int) *Ztime

AddHour 以小时为单位调整时间

##### Example

```go

new(Ztime).Now().SetLocation("Asia/Shanghai").AddHour(-1).Format("2006-01-02T15:04")

```

func (*Ztime) AddMinute

func (this *Ztime) AddMinute(n int) *Ztime

AddMinute 以分钟为单位调整时间

##### Example

```go

new(Ztime).Now().SetLocation("Asia/Shanghai").AddMinute(-1).Format("2006-01-02T15:04")

```

func (*Ztime) Format

func (this *Ztime) Format(format string) (string, error)

Format 设定时间格式 兼容官方Format格式. 同时支持YYYY-MM-DD hh:mm:ss格式

##### Example

```go

new(Ztime).Now().UTC().AddHour(7).Format("YYYY-MM-DDThh:mm")

```

func (*Ztime) Now

func (this *Ztime) Now() *Ztime

func (*Ztime) SetLocation

func (this *Ztime) SetLocation(timezone string) *Ztime

func (*Ztime) String

func (this *Ztime) String() (string, error)

func (*Ztime) UTC

func (this *Ztime) UTC() *Ztime

UTC 返回UTC时间 在当前没有时区文件的场景中可以通过UTC+AddHour计算指定时区的时间

##### Example

```go

new(Ztime).Now().UTC()

```

func (*Ztime) UnixNano

func (this *Ztime) UnixNano(length int) string

UnixNano 获取Unix纳秒级的时间戳 lenth返回时间戳长度 length<=13

#### Example

```

t := time.Ztime{}
fmt.Println(t.Now().UnixNano(13))

```