以下常用方法列表，文档更新可能滞后于代码新特性，更多的方法及示例请参考代码文档：https://pkg.go.dev/github.com/gogf/gf/v2/os/gtime

New

  • 说明：New 创建并返回一个具有给定参数的 Time对象。

  • 格式: 

    1. func New(param ...interface{}) *Time

  • 示例：创建时间对象。

    1. func ExampleNew() {
    2.     t1 := gtime.New(time.Now())
    3.     t2 := gtime.New("2018-08-08 08:08:08")
    4.     t3 := gtime.New(1533686888)
    6.     fmt.Println(t1)
    7.     fmt.Println(t2)
    8.     fmt.Println(t3)
    10.     // Output:
    11.     // 2021-11-18 14:18:27 
    12.     // 2018-08-08 08:08:08
    13.     // 2018-08-08 08:08:08

Now

  • 说明: Now创建并返回一个当前时间对象。

  • 格式：

    1. func Now() *Time

  • 示例：获取当前时间对象。

    1. func ExampleNow() {
    2.     t := gtime.Now()
    3.     fmt.Println(t)
    5.     // Output:
    6.     // 2021-11-06 13:41:08
    7. }

Format

  • 说明: 格式化输出时间

  • 格式：

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

  • 示例：格式化输出时间。完整的时间格式可查阅 时间管理-时间格式。

    1. func ExampleTime_Format() {
    2.     gt1 := gtime.New("2018-08-08 08:08:08")
    4.     fmt.Println(gt1.Format("Y-m-d"))
    5.     fmt.Println(gt1.Format("l"))
    6.     fmt.Println(gt1.Format("F j, Y, g:i a"))
    7.     fmt.Println(gt1.Format("j, n, Y"))
    8.     fmt.Println(gt1.Format("h-i-s, j-m-y, it is w Day z"))
    9.     fmt.Println(gt1.Format("D M j G:i:s T Y"))
    11.     // Output:
    12.     // 2018-08-08
    13.     // Wednesday
    14.     // August 8, 2018, 8:08 am
    15.     // 8, 8, 2018
    16.     // 08-08-08, 8-08-18, 0831 0808 3 Wedam18 219
    17.     // Wed Aug 8 8:08:08 CST 2018
    18. }

String

  • 说明: 输出字符串

  • 格式：

    1. func (t *Time) String() string

  • 示例：输出字符串类型。

    1. func ExampleTime_String() {
    2.     gt := gtime.New("2018-08-08 08:08:08")
    3.     t1 := gt.String()
    5.     fmt.Println(t1)
    6.     fmt.Println(reflect.TypeOf(t1))
    8.     // Output:
    9.     // 2018-08-08 08:08:08
    10.     // string
    11. }

Timestamp

  • 说明: 获取当前对象的秒时间戳。相应的还有TimestampMicro/TimestampMilli/TimestampNano。

  • 格式：

    1. func (t *Time) Timestamp() int64
    2. func Timestamp() int64

  • 示例：获取当前对象的秒时间戳。

    1. func ExampleTime_Timestamp() {
    2.     t := gtime.Now()
    4.     fmt.Println(t.Timestamp())
    5.     fmt.Println(gtime.Timestamp())
    6.     fmt.Println(t.TimestampMicro())
    7.      fmt.Println(t.TimestampMilli())
    8.     fmt.Println(t.TimestampNano())
    10.     // Output:
    11.     // 1533686888
    12.     // 1533686888
    13.     // 1533686888000
    14.     // 1533686888000000
    15.     // 1533686888000000000
    16. }

ToZone

  • 说明: 设置时区。

  • 格式：

    1. func (t *Time) ToZone(zone string) (*Time, error)

  • 示例：获取当前对象的秒时间戳。

    1. func ExampleTime_ToZone() {
    2.     gt1 := gtime.Now()
    3.     gt2, _ := gt1.ToZone("Asia/Shanghai")
    4.     gt3, _ := gt1.ToZone("Asia/Tokyo")
    6.     fmt.Println(gt2)
    7.     fmt.Println(gt3)
    9.     // May Output:
    10.     // 2021-11-11 17:10:10
    11.     // 2021-11-11 18:10:10
    12. }

SetTimeZone

  • 说明: 设置时区。

  • 格式：

    1. func SetTimeZone(zone string) error

  • 示例： 设置时区。

    1. func ExampleSetTimeZone() {
    2.     gtime.SetTimeZone("Asia/Shanghai")
    3.     fmt.Println(gtime.Datetime())
    5.     gtime.SetTimeZone("Asia/Tokyo")
    6.     fmt.Println(gtime.Datetime())
    7.     // May Output:
    8.     // 2018-08-08 08:08:08
    9.     // 2018-08-08 09:08:08
    10. }

StrToTime

  • 说明: 时间字符串转成时间对象。

  • 格式：

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

  • 示例： 时间字符串转成时间对象。

    1. func ExampleStrToTime() {
    2.     res, _ := gtime.StrToTime("2006-01-02T15:04:05-07:00", "Y-m-d H:i:s")
    3.     fmt.Println(res)
    5.     // May Output:
    6.     // 2006-01-02 15:04:05
    7. }

Add

  • 说明: 在当前时间对象上增加时间。

  • 格式：

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

  • 示例： 在当前时间对象上增加时间。

    1. func ExampleTime_Add() {
    2.     gt := gtime.New("2018-08-08 08:08:08")
    3.     gt1 := gt.Add(time.Duration(10) * time.Second)
    5.     fmt.Println(gt1)
    7.     // Output:
    8.     // 2018-08-08 08:08:18
    9. }

StartOfDay

  • 说明: 返回今天最开始的时间对象。类似的还有StartOfHalf/StartOfHour/StartOfMonth/StartOfMinute/StartOfQuarter等。

  • 格式：

    1. func (t *Time) StartOfDay() *Time

  • 示例： 返回今天最开始的时间对象。

    1. func ExampleTime_StartOfDay() {
    2.     gt1 := gtime.New("2018-08-08 08:08:08")
    4.     fmt.Println(gt1.StartOfDay())
    6.     // Output:
    7.     // 2018-08-08 00:00:00
    8. }

EndOfDay

  • 说明: 返回今天结束的时间对象。类似的还有EndOfHalf/EndOfHour/EndOfMonth/EndOfMinute/EndOfQuarter等。

  • 格式：

    1. func (t *Time) EndOfDay() *Time

  • 示例： 返回今天结束的时间对象。

    1. func ExampleTime_EndOfDay() {
    2.     gt1 := gtime.New("2018-08-08 08:08:08")
    4.     fmt.Println(gt1.EndOfDay())
    6.     // Output:
    7.     // 2018-08-08 23:59:59
    8. }

Month

  • 说明: 返回这个月处于全年的索引号。例如，1月对应的是1。

  • 格式：

    1. func (t *Time) Month() int

  • 示例： 返回这个月处于全年的索引号。

    1. func ExampleTime_Month() {
    2.     gt := gtime.New("2018-08-08 08:08:08")
    3.     t1 := gt.Month()
    5.     fmt.Println(t1)
    7.     // Output:
    8.     // 8
    9. }

Second

  • 说明: 返回当前分钟的秒数。例如，10:10:08 对应的秒数为8。

  • 格式：

    1. func (t *Time) Second() int

  • 示例： 返回这个月处于全年的索引号。

    1. func ExampleTime_Second() {
    2.     gt := gtime.New("2018-08-08 08:08:08")
    3.     t1 := gt.Second()
    5.     fmt.Println(t1)
    7.     // Output:
    8.     // 8
    9. }

IsZero

  • 说明: 判断时间是否等于0001-01-01 00:00:00。注意不代表时间戳为0, 时间戳为0是1970-01-01 08:00:00

  • 格式：

    1. func (t *Time) IsZero() bool

  • 示例： 返回这个月处于全年的索引号。

    1. func ExampleTime_IsZero() {
    2.     gt := gtime.New("0-0-0")
    4.     fmt.Println(gt.IsZero())
    6.     // Output:
    7.     // true
    8. }

AddDate

  • 说明: 在当前时间对象上增加指定年月日。

  • 格式：

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

  • 示例： 在当前时间对象上增加指定年月日。

    1. func ExampleTime_AddDate() {
    2.     var (
    3.         year  = 1
    4.         month = 2
    5.         day   = 3
    6.     )
    7.     gt := gtime.New("2018-08-08 08:08:08")
    8.     gt = gt.AddDate(year, month, day)
    10.     fmt.Println(gt)
    12.     // Output:
    13.     // 2019-10-11 08:08:08
    14. }

Equal

  • 说明: 判断两个时间对象是否相等。

  • 格式：

    1. func (t *Time) Equal(u *Time) bool

  • 示例： 判断两个时间对象是否相等。

    1. func ExampleTime_Equal() {
    2.     gt1 := gtime.New("2018-08-08 08:08:08")
    3.     gt2 := gtime.New("2018-08-08 08:08:08")
    5.     fmt.Println(gt1.Equal(gt2))
    7.     // Output:
    8.     // true
    9. }

Before

  • 说明: 判断两个时间对象前后顺序。

  • 格式：

    1. func (t *Time) Before(u *Time) bool

  • 示例： 判断两个时间对象前后顺序。

    1. func ExampleTime_Before() {
    2.     gt1 := gtime.New("2018-08-07 08:08:08")
    3.     gt2 := gtime.New("2018-08-08 08:08:08")
    5.     fmt.Println(gt1.Before(gt2))
    7.     // Output:
    8.     // true
    9. }

After

  • 说明: 判断两个时间对象前后顺序。

  • 格式：

    1. func (t *Time) After(u *Time) bool

  • 示例： 判断两个时间对象前后顺序。

    1. func ExampleTime_After() {
    2.     gt1 := gtime.New("2018-08-07 08:08:08")
    3.     gt2 := gtime.New("2018-08-08 08:08:08")
    5.     fmt.Println(gt1.After(gt2))
    7.     // Output:
    8.     // false
    9. }

Layout

  • 说明: 格式化输出时间。

  • 格式：

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

  • 示例： 格式化输出时间。

    1. func ExampleTime_Layout() {
    2.     gt1 := gtime.New("2018-08-08 08:08:08")
    4.     fmt.Println(gt1.Layout("2006-01-02"))
    6.     // Output:
    7.     // 2018-08-08
    8. }

IsLeapYear

  • 说明: 是否闰年。

  • 格式：

    1. func (t *Time) IsLeapYear() bool

  • 示例： 是否闰年。

    1. func ExampleTime_IsLeapYear() {
    2.     gt1 := gtime.New("2018-08-08 08:08:08")
    4.     fmt.Println(gt1.IsLeapYear())
    6.     // Output:
    7.     // false
    8. }

Date

  • 说明: 获取日期。

  • 格式：

    1. func Date() string

  • 示例： 获取日期。

    1. func ExampleDate() {
    2.     fmt.Println(gtime.Date())
    4.     // May Output:
    5.     // 2006-01-02
    6. }

Datetime

  • 说明: 获取日期时间。

  • 格式：

    1. func Datetime() string

  • 示例： 获取日期。

    1. func ExampleDatetime() {
    2.     fmt.Println(gtime.Datetime())
    4.     // May Output:
    5.     // 2006-01-02 15:04:05
    6. }

ISO8601

  • 说明: 以ISO8601的格式返回时间

  • 格式：

    1. func ISO8601() string

  • 示例：

    1. func ExampleISO8601() {
    2.     fmt.Println(gtime.ISO8601())
    4.     // May Output:
    5.     // 2006-01-02T15:04:05-07:00
    6. }

RFC822

  • 说明: 以RFC822的格式返回时间

  • 格式：

    1. func RFC822() string

  • 示例：

    1. func ExampleRFC822() {
    2.     fmt.Println(gtime.RFC822())
    4.     // May Output:
    5.     // Mon, 02 Jan 06 15:04 MST
    6. }

StrToTimeFormat

  • 说明: StrToTimeFormat根据传入的时间字符串以及格式返回时间对象

  • 格式：

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

  • 示例：

    1. func ExampleStrToTimeFormat() {
    2.     res, _ := gtime.StrToTimeFormat("2006-01-02 15:04:05", "Y-m-d H:i:s")
    3.     fmt.Println(res)
    5.     // Output:
    6.     // 2006-01-02 15:04:05
    7. }

StrToTimeLayout

  • 说明: StrToTimeLayout根据传入的时间字符串以及格式返回时间对象

  • 格式：

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

  • 示例：

    1. func ExampleStrToTimeLayout() {
    2.     res, _ := gtime.StrToTimeLayout("2018-08-08", "2006-01-02")
    3.     fmt.Println(res)
    5.     // Output:
    6.     // 2018-08-08 00:00:00
    7. }

MarshalJSON

  • 说明: MarshalJSON重载json.Marshal中的方法。

  • 格式：

    1. func (t *Time) MarshalJSON() ([]byte, error)

  • 示例：

    1. func ExampleTime_MarshalJSON() {
    2.     type Person struct {
    3.         Name string        `json:"name"`
    4.         Birthday *gtime.Time    `json:"birthday"`
    5.     }
    6.     p := new(Person)
    7.     p.Name = "goframe"
    8.     p.Birthday = gtime.New("2018-08-08 08:08:08")
    9.     j, _ := json.Marshal(p)
    10.     fmt.Println(string(j))
    12.     // Output:
    13.     // {"name":"xiaoming","birthday":"2018-08-08 08:08:08"}
    14. }

UnmarshalJSON

  • 说明: UnmarshalJSON重载json.Unmarshal中的方法。

  • 格式：

    1. func (t *Time) UnmarshalJSON() ([]byte, error)

  • 示例：

    1. func ExampleTime_MarshalJSON() {
    2.     type Person struct {
    3.         Name string        `json:"name"`
    4.         Birthday *gtime.Time    `json:"birthday"`
    5.     }
    6.     p := new(Person)
    7.     p.Name = "goframe"
    8.     p.Birthday = gtime.New("2018-08-08 08:08:08")
    9.     j, _ := json.Marshal(p)
    10.     fmt.Println(string(j))
    12.     // Output:
    13.     // {"name":"xiaoming","birthday":"2018-08-08 08:08:08"}
    14. }

WeekOfYear

  • 说明: WeekOfYear返回当前周处于全年第几周，从1开始计算。类似的还有DayOfYear/DaysInMonth

  • 格式：

    1. func (t *Time) WeeksOfYear() int

  • 示例：

    1. func ExampleTime_WeeksOfYear() {
    2.     gt1 := gtime.New("2018-01-08 08:08:08")
    4.     fmt.Println(gt1.WeeksOfYear())
    6.     // Output:
    7.     // 2
    8. }D