gf: github.com/johng-cn/gf/g/os/gtime Index | Files

package gtime

import "github.com/johng-cn/gf/g/os/gtime"

Package gtime provides functionality for measuring and displaying time.

时间管理.

Index

Package Files

gtime.go gtime_format.go gtime_time.go

Constants

const (
    D   = 24 * time.Hour
    H   = time.Hour
    M   = time.Minute
    S   = time.Second
    MS  = time.Millisecond
    US  = time.Microsecond
    NS  = time.Nanosecond

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

    TIME_REAGEX_PATTERN2 = "" /* 136 byte string literal not displayed */
)

func Date Uses

func Date() string

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

func Datetime Uses

func Datetime() string

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

func FuncCost Uses

func FuncCost(f func()) int64

计算函数f执行的时间,单位纳秒

func Microsecond Uses

func Microsecond() int64

获取当前的微秒数

func Millisecond Uses

func Millisecond() int64

获取当前的毫秒数

func Nanosecond Uses

func Nanosecond() int64

获取当前的纳秒数

func Second Uses

func Second() int64

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

func SetTimeZone Uses

func SetTimeZone(zone string) error

设置当前进程全局的默认时区,如: Asia/Shanghai

type Time Uses

type Time struct {
    time.Time
}

func ConvertZone Uses

func ConvertZone(strTime string, toZone string, fromZone ...string) (*Time, error)

时区转换

func New Uses

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

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

func NewFromStr Uses

func NewFromStr(str string) *Time

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

func NewFromStrFormat Uses

func NewFromStrFormat(str string, format string) *Time

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

func NewFromStrLayout Uses

func NewFromStrLayout(str string, layout string) *Time

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

func NewFromTime Uses

func NewFromTime(t time.Time) *Time

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

func NewFromTimeStamp Uses

func NewFromTimeStamp(timestamp int64) *Time

时间戳转换为时间对象,时间戳支持到纳秒的数值

func Now Uses

func Now() *Time

当前时间对象

func ParseTimeFromContent Uses

func ParseTimeFromContent(content string, format ...string) *Time

从字符串内容中(也可以是文件名称等等)解析时间,并返回解析成功的时间对象,否则返回nil。 注意当内容中存在多个时间时,会解析第一个。 format参数可以指定需要解析的时间格式。

func StrToTime Uses

func StrToTime(str string, format ...string) (*Time, error)

字符串转换为时间对象,format参数指定格式的format(如: Y-m-d H:i:s),当指定format参数时效果同StrToTimeFormat方法。 注意:自动解析日期时间时,必须有日期才能解析成功,如果字符串中不带有日期字段,那么解析失败。

func StrToTimeFormat Uses

func StrToTimeFormat(str string, format string) (*Time, error)

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

func StrToTimeLayout Uses

func StrToTimeLayout(str string, layout string) (*Time, error)

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

func (*Time) Add Uses

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

当前时间加上指定时间段

func (*Time) AddDate Uses

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

时间日期计算

func (*Time) Clone Uses

func (t *Time) Clone() *Time

复制当前时间对象

func (*Time) Format Uses

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

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

func (*Time) Layout Uses

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

格式化,使用标准库格式

func (*Time) Local Uses

func (t *Time) Local() *Time

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

func (*Time) Microsecond Uses

func (t *Time) Microsecond() int64

微秒数

func (*Time) Millisecond Uses

func (t *Time) Millisecond() int64

毫秒数

func (*Time) Nanosecond Uses

func (t *Time) Nanosecond() int64

纳秒数

func (*Time) Round Uses

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

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

func (*Time) Second Uses

func (t *Time) Second() int64

秒数(时间戳)

func (*Time) String Uses

func (t *Time) String() string

转换为字符串

func (*Time) ToLocation Uses

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

时区转换为指定的时区(通过time.Location)

func (*Time) ToTime Uses

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

转换为标准库日期对象

func (*Time) ToZone Uses

func (t *Time) ToZone(zone string) *Time

时区转换为指定的时区(通过时区名称,如:Asia/Shanghai)

func (*Time) Truncate Uses

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

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

func (*Time) UTC Uses

func (t *Time) UTC() *Time

时区转换为UTC时区

Package gtime imports 7 packages (graph). Updated 2019-02-21. Refresh now. Tools for package owners.