timex

package
v0.6.3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 11, 2023 License: MIT Imports: 3 Imported by: 13

README

Timex

Provides an enhanced time.Time implementation, and add more commonly used functional methods.

Install

go get github.com/gookit/goutil/timex

Usage

Create timex instance
now := timex.Now()

// from time.Time
tx := timex.New(time.Now())
tx := timex.FromTime(time.Now())

// from time unix
tx := timex.FromUnix(1647411580)

Create from datetime string:

// auto match layout by datetime
tx, err  := timex.FromString("2022-04-20 19:40:34")
// custom set the datetime layout
tx, err  := timex.FromString("2022-04-20 19:40:34", "2006-01-02 15:04:05")
// use date template as layout
tx, err  := timex.FromDate("2022-04-20 19:40:34", "Y-m-d H:I:S")
Use timex instance
tx := timex.Now()

Change time:

tx.Yesterday()
tx.Tomorrow()

tx.DayStart() // get time at Y-m-d 00:00:00
tx.DayEnd() // get time at Y-m-d 23:59:59
tx.HourStart() // get time at Y-m-d H:00:00
tx.HourEnd() // get time at Y-m-d H:59:59

tx.AddDay(2)
tx.AddHour(1)
tx.AddMinutes(15)
tx.AddSeconds(120)

Compare time:

// before compare
tx.IsBefore(u time.Time)
tx.IsBeforeUnix(1647411580)
// after compare
tx.IsAfter(u time.Time)
tx.IsAfterUnix(1647411580)
Helper functions
ts := timex.NowUnix() // current unix timestamp

t := NowAddDay(1) // from now add 1 day
t := NowAddHour(1) // from now add 1 hour
t := NowAddMinutes(3) // from now add 3 minutes
t := NowAddSeconds(180) // from now add 180 seconds
Convert time to date by template

Template Chars:

 Y,y - year
  Y - year 2006
  y - year 06
 m - month 01-12
 d - day 01-31
 H,h - hour
  H - hour 00-23
  h - hour 01-12
 I,i - minute
  I - minute 00-59
  i - minute 0-59
 S,s - second
  S - second 00-59
  s - second 0-59
... ...

More, please see charMap

Examples, use timex format date:

tx := timex.Now()
date := tx.DateFormat("Y-m-d H:I:S") // Output: 2022-04-20 19:09:03
date = tx.DateFormat("y-m-d h:i:s") // Output: 22-04-20 07:9:3

Format time.Time:

tx := time.Now()
date := timex.DateFormat(tx, "Y-m-d H:I:S") // Output: 2022-04-20 19:40:34

More usage:

ts := timex.NowUnix() // current unix timestamp

date := FormatUnix(ts, "2006-01-02 15:04:05") // Get: 2022-04-20 19:40:34
date := FormatUnixByTpl(ts, "Y-m-d H:I:S") // Get: 2022-04-20 19:40:34

Functions

func AddDay(t time.Time, day int) time.Time
func AddHour(t time.Time, hour int) time.Time
func AddMinutes(t time.Time, minutes int) time.Time
func AddSeconds(t time.Time, seconds int) time.Time
func Date(t time.Time, template string) string
func DateFormat(t time.Time, template string) string
func DayEnd(t time.Time) time.Time
func DayStart(t time.Time) time.Time
func Format(t time.Time) string
func FormatBy(t time.Time, layout string) string
func FormatByTpl(t time.Time, template string) string
func FormatUnix(sec int64) string
func FormatUnixBy(sec int64, layout string) string
func FormatUnixByTpl(sec int64, template string) string
func HourEnd(t time.Time) time.Time
func HourStart(t time.Time) time.Time
func HowLongAgo(sec int64) string
func NowAddDay(day int) time.Time
func NowAddHour(hour int) time.Time
func NowAddMinutes(minutes int) time.Time
func NowAddSeconds(seconds int) time.Time
func NowHourEnd() time.Time
func NowHourStart() time.Time
func NowUnix() int64
func SetLocalByName(tzName string) error
func ToDuration(s string) (time.Duration, error)
func ToLayout(template string) string
func TodayEnd() time.Time
func TodayStart() time.Time

// for create timex.Time
    func FromDate(s string, template ...string) (*Time, error)
    func FromString(s string, layouts ...string) (*Time, error)
    func FromTime(t time.Time) *Time
    func FromUnix(sec int64) *Time
    func Local() *Time
    func LocalByName(tzName string) *Time
    func New(t time.Time) *Time
    func Now() *Time
    func Wrap(t time.Time) *Time
Methods in timex.Time
func (t *Time) AddDay(day int) *Time
func (t *Time) AddHour(hours int) *Time
func (t *Time) AddMinutes(minutes int) *Time
func (t *Time) AddSeconds(seconds int) *Time
func (t *Time) CustomHMS(hour, min, sec int) *Time
func (t *Time) DateFormat(template string) string
func (t *Time) Datetime() string
func (t *Time) DayAfter(day int) *Time
func (t *Time) DayAgo(day int) *Time
func (t *Time) DayEnd() *Time
func (t *Time) DayStart() *Time
func (t Time) Diff(u time.Time) time.Duration
func (t Time) DiffSec(u time.Time) int
func (t *Time) Format(layout string) string
func (t *Time) HourEnd() *Time
func (t *Time) HourStart() *Time
func (t Time) HowLongAgo(before time.Time) string
func (t *Time) IsAfter(u time.Time) bool
func (t *Time) IsAfterUnix(ux int64) bool
func (t *Time) IsBefore(u time.Time) bool
func (t *Time) IsBeforeUnix(ux int64) bool
func (t *Time) SubDay(day int) *Time
func (t *Time) SubHour(hours int) *Time
func (t *Time) SubMinutes(minutes int) *Time
func (t *Time) SubSeconds(seconds int) *Time
func (t Time) SubUnix(u time.Time) int
func (t Time) T() time.Time
func (t Time) Timestamp() int64
func (t *Time) Tomorrow() *Time
func (t *Time) TplFormat(template string) string
func (t *Time) UnmarshalJSON(data []byte) error
func (t *Time) UnmarshalText(data []byte) error
func (t *Time) Yesterday() *Time

Code Check & Testing

gofmt -w -l ./
golint ./...

Testing:

go test -v ./timex/...

Test limit by regexp:

go test -v -run ^TestSetByKeys ./timex/...

Documentation

Overview

Package timex provides an enhanced time.Time implementation. Add more commonly used functional methods.

such as: DayStart(), DayAfter(), DayAgo(), DateFormat() and more.

Index

Constants

View Source 
const (
	OneSecond  = 1
	OneMinSec  = 60
	OneHourSec = 3600
	OneDaySec  = 86400
	OneWeekSec = 7 * 86400

	Second  = time.Second
	OneMin  = time.Minute
	OneHour = time.Hour
	OneDay  = 24 * time.Hour
	OneWeek = 7 * 24 * time.Hour

	DatetimeLayout = "2006-01-02 15:04:05"
	DateOnlyLayout = "2006-01-02"
	TimeOnlyLayout = "15:04:05"
)

provide some commonly time consts

Variables

View Source 
var (
	// DefaultLayout template for format time
	DefaultLayout = "2006-01-02 15:04:05"
)

Functions

func AddDay 

func AddDay(t time.Time, day int) time.Time

AddDay add some day time for given time

func AddHour 

func AddHour(t time.Time, hour int) time.Time

AddHour add some hour time for given time

func AddMinutes 

func AddMinutes(t time.Time, minutes int) time.Time

AddMinutes add some minutes time for given time

func AddSeconds 

func AddSeconds(t time.Time, seconds int) time.Time

AddSeconds add some seconds time for given time

func Date added in v0.5.1 

func Date(t time.Time, template string) string

Date format time by given date template. see ToLayout()

func DateFormat added in v0.5.1 

func DateFormat(t time.Time, template string) string

DateFormat format time by given date template. see ToLayout()

func DayEnd added in v0.5.1 

func DayEnd(t time.Time) time.Time

DayEnd time for given time

func DayStart added in v0.5.1 

func DayStart(t time.Time) time.Time

DayStart time for given time

func Format 

func Format(t time.Time) string

Format use default layout

func FormatBy 

func FormatBy(t time.Time, layout string) string

FormatBy given default layout

func FormatByTpl added in v0.5.1 

func FormatByTpl(t time.Time, template string) string

FormatByTpl format time by given date template. see ToLayout()

func FormatUnix 

func FormatUnix(sec int64) string

FormatUnix time seconds use default layout

func FormatUnixBy 

func FormatUnixBy(sec int64, layout string) string

FormatUnixBy format time seconds use given layout

func FormatUnixByTpl added in v0.5.1 

func FormatUnixByTpl(sec int64, template string) string

FormatUnixByTpl format time seconds use given date template. see ToLayout()

func HourEnd added in v0.5.2 

func HourEnd(t time.Time) time.Time

HourEnd time for given time

func HourStart added in v0.5.1 

func HourStart(t time.Time) time.Time

HourStart time for given time

func HowLongAgo added in v0.5.1 

func HowLongAgo(sec int64) string

HowLongAgo format given timestamp to string.

func NowAddDay 

func NowAddDay(day int) time.Time

NowAddDay add some day time from now

func NowAddHour 

func NowAddHour(hour int) time.Time

NowAddHour add some hour time from now

func NowAddMinutes 

func NowAddMinutes(minutes int) time.Time

NowAddMinutes add some minutes time from now

func NowAddSeconds 

func NowAddSeconds(seconds int) time.Time

NowAddSeconds add some seconds time from now

func NowHourEnd added in v0.5.5 

func NowHourEnd() time.Time

NowHourEnd time

func NowHourStart added in v0.5.1 

func NowHourStart() time.Time

NowHourStart time

func NowUnix 

func NowUnix() int64

NowUnix is short of time.Now().Unix()

func SetLocalByName 

func SetLocalByName(tzName string) error

SetLocalByName set local by tz name. eg: UTC, PRC

func ToDuration added in v0.5.6 

func ToDuration(s string) (time.Duration, error)

ToDuration parses a duration string. such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".

func ToLayout added in v0.5.1 

func ToLayout(template string) string

ToLayout convert chars date template to Go date layout.

Chars see charMap

func TodayEnd added in v0.5.1 

func TodayEnd() time.Time

TodayEnd time

func TodayStart added in v0.5.1 

func TodayStart() time.Time

TodayStart time

Types

type Time added in v0.5.13 

type Time struct {
	time.Time
	// Layout set the default date format layout. default use DefaultLayout
	Layout string
}

Time an enhanced time.Time implementation.

func FromDate added in v0.5.2 

func FromDate(s string, template ...string) (*Time, error)

FromDate create from datetime string.

func FromString added in v0.5.1 

func FromString(s string, layouts ...string) (*Time, error)

FromString create from datetime string. see strutil.ToTime()

func FromTime added in v0.5.2 

func FromTime(t time.Time) *Time

FromTime new instance form given time.Time. alias of the New()

func FromUnix added in v0.5.1 

func FromUnix(sec int64) *Time

FromUnix create from unix time

func Local 

func Local() *Time

Local time for now

func LocalByName 

func LocalByName(tzName string) *Time

LocalByName time for now

func New added in v0.5.1 

func New(t time.Time) *Time

New instance form given time

func Now 

func Now() *Time

Now time instance

func Wrap added in v0.5.2 

func Wrap(t time.Time) *Time

Wrap the go time instance. alias of the New()

func (*Time) AddDay added in v0.5.13 

func (t *Time) AddDay(day int) *Time

AddDay add some day time for the time

func (*Time) AddHour added in v0.5.13 

func (t *Time) AddHour(hours int) *Time

AddHour add some hour time

func (*Time) AddMinutes added in v0.5.13 

func (t *Time) AddMinutes(minutes int) *Time

AddMinutes add some minutes time for the time

func (*Time) AddSeconds added in v0.5.13 

func (t *Time) AddSeconds(seconds int) *Time

AddSeconds add some seconds time the time

func (*Time) CustomHMS added in v0.5.13 

func (t *Time) CustomHMS(hour, min, sec int) *Time

CustomHMS custom change the hour, minute, second for create new time.

func (*Time) DateFormat added in v0.5.13 

func (t *Time) DateFormat(template string) string

DateFormat use input template format time to date. see ToLayout()

func (*Time) Datetime added in v0.5.13 

func (t *Time) Datetime() string

Datetime use DefaultLayout format time to date. see Format()

func (*Time) DayAfter added in v0.5.13 

func (t *Time) DayAfter(day int) *Time

DayAfter get some day after time for the time. alias of Time.AddDay()

func (*Time) DayAgo added in v0.5.13 

func (t *Time) DayAgo(day int) *Time

DayAgo get some day ago time for the time

func (*Time) DayEnd added in v0.5.13 

func (t *Time) DayEnd() *Time

DayEnd get time at 23:59:59

func (*Time) DayStart added in v0.5.13 

func (t *Time) DayStart() *Time

DayStart get time at 00:00:00

func (Time) Diff added in v0.5.13 

func (t Time) Diff(u time.Time) time.Duration

Diff calc diff duration for t - u. alias of time.Time.Sub()

func (Time) DiffSec added in v0.5.13 

func (t Time) DiffSec(u time.Time) int

DiffSec calc diff seconds for t - u

func (Time) DiffUnix added in v0.6.0 

func (t Time) DiffUnix(u int64) int

DiffUnix calc diff seconds for t.Unix() - u

func (*Time) Format added in v0.5.13 

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

Format returns a textual representation of the time value formatted according to the layout defined by the argument.

see time.Time.Format()

func (*Time) HourEnd added in v0.5.13 

func (t *Time) HourEnd() *Time

HourEnd time

func (*Time) HourStart added in v0.5.13 

func (t *Time) HourStart() *Time

HourStart time

func (Time) HowLongAgo added in v0.5.13 

func (t Time) HowLongAgo(before time.Time) string

HowLongAgo format diff time to string.

func (*Time) IsAfter added in v0.5.13 

func (t *Time) IsAfter(u time.Time) bool

IsAfter the given time

func (*Time) IsAfterUnix added in v0.5.13 

func (t *Time) IsAfterUnix(ux int64) bool

IsAfterUnix the given unix timestamp

func (*Time) IsBefore added in v0.5.13 

func (t *Time) IsBefore(u time.Time) bool

IsBefore the given time

func (*Time) IsBeforeUnix added in v0.5.13 

func (t *Time) IsBeforeUnix(ux int64) bool

IsBeforeUnix the given unix timestamp

func (*Time) SubDay added in v0.5.13 

func (t *Time) SubDay(day int) *Time

SubDay add some day time for the time

func (*Time) SubHour added in v0.5.13 

func (t *Time) SubHour(hours int) *Time

SubHour add some hour time

func (*Time) SubMinutes added in v0.5.13 

func (t *Time) SubMinutes(minutes int) *Time

SubMinutes add some minutes time for the time

func (*Time) SubSeconds added in v0.5.13 

func (t *Time) SubSeconds(seconds int) *Time

SubSeconds add some seconds time the time

func (Time) SubUnix added in v0.5.13 

func (t Time) SubUnix(u time.Time) int

SubUnix calc diff seconds for t - u

func (Time) T added in v0.5.13 

func (t Time) T() time.Time

T returns the t.Time

func (Time) Timestamp added in v0.5.13 

func (t Time) Timestamp() int64

Timestamp value. alias t.Unix()

func (*Time) Tomorrow added in v0.5.13 

func (t *Time) Tomorrow() *Time

Tomorrow time. get tomorrow time for the time

func (*Time) TplFormat added in v0.5.13 

func (t *Time) TplFormat(template string) string

TplFormat use input template format time to date.

func (*Time) UnmarshalJSON added in v0.5.13 

func (t *Time) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.

Tip: will auto match a format by strutil.ToTime()

func (*Time) UnmarshalText added in v0.5.13 

func (t *Time) UnmarshalText(data []byte) error

UnmarshalText implements the encoding.TextUnmarshaler interface.

Tip: will auto match a format by strutil.ToTime()

func (*Time) Yesterday added in v0.5.13 

func (t *Time) Yesterday() *Time

Yesterday get day ago time for the time

type TimeX 

type TimeX = Time

TimeX alias of Time

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.