gtime

Documentation

Overview

时间管理

Index

• Constants
• func Date() string
• func Datetime() string
• func Microsecond() int64
• func Millisecond() int64
• func Nanosecond() int64
• func Second() int64
• func SetInterval(t time.Duration, callback func() bool)
• func SetTimeZone(zone string) error
• func SetTimeout(t time.Duration, callback func())
• func StrToTime(str string) (time.Time, error)
• func StrToTimeFormat(str string, format string) (time.Time, error)
• func StrToTimeLayout(str string, layout string) (time.Time, error)
• type Time
  • func New(t ...time.Time) *Time
  • func NewFromStr(str string) *Time
  • func NewFromStrFormat(str string, format string) *Time
  • func NewFromStrLayout(str string, layout string) *Time
  • func NewFromTime(t time.Time) *Time
  • func NewFromTimeStamp(timestamp int64) *Time
  • func Now() *Time
  • func (t *Time) Add(d time.Duration) *Time
  • func (t *Time) AddDate(years int, months int, days int) *Time
  • func (t *Time) Clone() *Time
  • func (t *Time) Format(format string) string
  • func (t *Time) Layout(layout string) string
  • func (t *Time) Local() *Time
  • func (t *Time) Microsecond() int64
  • func (t *Time) Millisecond() int64
  • func (t *Time) Nanosecond() int64
  • func (t *Time) Round(d time.Duration) *Time
  • func (t *Time) Second() int64
  • func (t *Time) String() string
  • func (t *Time) ToLocation(location *time.Location) *Time
  • func (t *Time) ToTime() time.Time
  • func (t *Time) Truncate(d time.Duration) *Time
  • func (t *Time) UTC() *Time

Constants

const (
	TIME_REAGEX_PATTERN = `(\d{4}[-/]\d{2}[-/]\d{2})[\sT]{0,1}(\d{2}:\d{2}:\d{2}){0,1}\.{0,1}(\d{0,9})([\sZ]{0,1})([\+-]{0,1})([:\d]*)`
)

Functions

func Date

func Date() string

获得当前的日期(例如：2006-01-02)

func Datetime

func Datetime() string

获得当前的时间(例如：2006-01-02 15:04:05)

func Microsecond

func Microsecond() int64

获取当前的微秒数

func Millisecond

func Millisecond() int64

获取当前的毫秒数

func Nanosecond

func Nanosecond() int64

获取当前的纳秒数

func Second

func Second() int64

获取当前的秒数(时间戳)

func SetInterval

func SetInterval(t time.Duration, callback func() bool)

类似与js中的SetInterval，每隔一段时间后执行回调函数，当回调函数返回true，那么继续执行，否则终止执行，该方法是异步的 注意：由于采用的是循环而不是递归操作，因此间隔时间将会以上一次回调函数执行完成的时间来计算

func SetTimeZone

func SetTimeZone(zone string) error

设置当前进程全局的默认时区

func SetTimeout

func SetTimeout(t time.Duration, callback func())

类似与js中的SetTimeout，一段时间后执行回调函数

func StrToTime

func StrToTime(str string) (time.Time, error)

字符串转换为时间对象，支持的标准时间格式： "2017-12-14 04:51:34 +0805 LMT", "2006-01-02T15:04:05Z07:00", "2014-01-17T01:19:15+08:00", "2018-02-09T20:46:17.897Z", "2018-02-09 20:46:17.897", "2018-02-09T20:46:17Z", "2018-02-09 20:46:17", "2018-02-09",

func StrToTimeFormat

func StrToTimeFormat(str string, format string) (time.Time, error)

字符串转换为时间对象，指定字符串时间格式，format格式形如：Y-m-d H:i:s

func StrToTimeLayout

func StrToTimeLayout(str string, layout string) (time.Time, error)

字符串转换为时间对象，通过标准库layout格式进行解析，layout格式形如：2006-01-02 15:04:05

Types

type Time

type Time struct {
	time.Time
}

func New

func New(t ...time.Time) *Time

创建一个空的时间对象，参数可以是标准库时间对象，可选

func NewFromStr

func NewFromStr(str string) *Time

从字符串转换为时间对象，复杂的时间字符串需要给定格式

func NewFromStrFormat

func NewFromStrFormat(str string, format string) *Time

从字符串转换为时间对象，指定字符串时间格式，format格式形如：Y-m-d H:i:s

func NewFromStrLayout

func NewFromStrLayout(str string, layout string) *Time

从字符串转换为时间对象，通过标准库layout格式进行解析，layout格式形如：2006-01-02 15:04:05

func NewFromTime

func NewFromTime(t time.Time) *Time

标准时间对象转换为自定义的时间对象

func NewFromTimeStamp

func NewFromTimeStamp(timestamp int64) *Time

时间戳转换为时间对象

func Now

func Now() *Time

当前时间对象

func (*Time) Add

func (t *Time) Add(d time.Duration) *Time

当前时间加上指定时间段

func (*Time) AddDate

func (t *Time) AddDate(years int, months int, days int) *Time

时间日期计算

func (*Time) Clone

func (t *Time) Clone() *Time

复制当前时间对象

func (*Time) Format

func (t *Time) Format(format string) string

格式化，使用自定义日期格式

func (*Time) Layout

func (t *Time) Layout(layout string) string

格式化，使用标准库格式

func (*Time) Local

func (t *Time) Local() *Time

时区转换为当前设定的Local时区

func (*Time) Microsecond

func (t *Time) Microsecond() int64

微秒数

func (*Time) Millisecond

func (t *Time) Millisecond() int64

毫秒数

func (*Time) Nanosecond

func (t *Time) Nanosecond() int64

纳秒数

func (*Time) Round

func (t *Time) Round(d time.Duration) *Time

Round将舍入t的结果返回到d的最接近的倍数(从零时间开始)。 中间值的舍入行为是向上舍入。 如果d <= 0，Round返回t剥离任何单调时钟读数但不改变。 Round作为零时间以来的绝对持续时间运行; 它不适用于当时的演示形式。 因此，Round(Hour)可能会返回非零分钟的时间，具体取决于时间的位置。

func (*Time) Second

func (t *Time) Second() int64

秒数(时间戳)

func (*Time) String

func (t *Time) String() string

转换为字符串

func (*Time) ToLocation

func (t *Time) ToLocation(location *time.Location) *Time

时区转换为指定的时区

func (*Time) ToTime

func (t *Time) ToTime() time.Time

转换为标准库日期对象

func (*Time) Truncate

func (t *Time) Truncate(d time.Duration) *Time

Truncate将舍入t的结果返回到d的倍数(从零时间开始)。 如果d <= 0，则Truncate返回t剥离任何单调时钟读数但不改变。 截断时间作为零时间以来的绝对持续时间运行; 它不适用于当时的演示形式。 因此，截断（小时）可能会返回非零分钟的时间，具体取决于时间的位置。

func (*Time) UTC

func (t *Time) UTC() *Time

时区转换为UTC时区