datetime

Documentation

Index

• Constants
• Variables
• func DaysCountOfMonth(year, month int) int
• func ElapsedDaysBetween(start, end time.Time) int
• func EndOfWeek(t time.Time) time.Time
• func FirstDayOfYear(year int) time.Time
• func FormatMsTime(ms int64) string
• func FormatMsTimeUTC(ms int64) string
• func FormatNanoTime(nano int64) string
• func FormatNanoTimeUTC(nano int64) string
• func FormatTime(t time.Time) string
• func FormatTimeUTC(t time.Time) string
• func GetNextMonday(now time.Time) time.Time
• func IsLeapYear(year int) bool
• func LastDayOfYear(year int) time.Time
• func MidnightTimeOf(t time.Time) time.Time
• func NextMidnight(ts int64) int64
• func ParseDuration(s string) (time.Duration, error)
• func PrettyDuration(d time.Duration) string
• func PrettyTime(ms int64) string
• func StartingOfWeek(t time.Time) time.Time
• func ThisMomentAfterDays(this time.Time, days int) time.Time
• func TimeOfMS(ms int64) time.Time
• func UTCTimeOfMS(ms int64) time.Time
• type Clock
  • func NewClock(interval time.Duration) *Clock
  • func (c *Clock) DateTime() string
  • func (c *Clock) Go()
  • func (c *Clock) Now() time.Time
  • func (c *Clock) NowMs() int64
  • func (c *Clock) Reset()
  • func (c *Clock) Stop()
  • func (c *Clock) Travel(d time.Duration)

Constants

const (
	ClockPrecision = time.Millisecond * 100
	ISO8601Format  = "2006-01-02T15:04:05-0700"
)

const (
	Day  = 24 * time.Hour
	Week = 7 * Day
)

const (
	DateLayout      = "2006-01-02T15:04:05"
	MsTimeLayout    = "2006-01-02T15:04:05.000"
	MicroTimeLayout = "2006-01-02T15:04:05.000000"

	MsPerSecond = 1000
	MsPerMinute = 60 * MsPerSecond
	MsPerHour   = 60 * MsPerMinute
	MsPerDay    = 24 * MsPerHour
	MsPerWeek   = 7 * MsPerDay

	SecondsPerMin  = 60
	SecondsPerHour = 60 * SecondsPerMin
	SecondsPerDay  = 24 * SecondsPerHour
)

Variables

var (
	FirstDayIsMonday = false
	DefaultLoc       = time.UTC
)

Functions

func DaysCountOfMonth

func DaysCountOfMonth(year, month int) int

DaysCountOfMonth 一个月的天数

func ElapsedDaysBetween

func ElapsedDaysBetween(start, end time.Time) int

ElapsedDaysBetween 获取两个时间中经过的天数

func EndOfWeek

func EndOfWeek(t time.Time) time.Time

EndOfWeek 本周的最后一天

func FirstDayOfYear

func FirstDayOfYear(year int) time.Time

FirstDayOfYear 年度第一天

func FormatMsTime

func FormatMsTime(ms int64) string

func FormatMsTimeUTC

func FormatMsTimeUTC(ms int64) string

func FormatNanoTime

func FormatNanoTime(nano int64) string

func FormatNanoTimeUTC

func FormatNanoTimeUTC(nano int64) string

func FormatTime

func FormatTime(t time.Time) string

func FormatTimeUTC

func FormatTimeUTC(t time.Time) string

func GetNextMonday

func GetNextMonday(now time.Time) time.Time

GetNextMonday 计算当前时间的下周一的凌晨0点

func IsLeapYear

func IsLeapYear(year int) bool

IsLeapYear 是否闰年

func LastDayOfYear

func LastDayOfYear(year int) time.Time

LastDayOfYear 年度最后一天

func MidnightTimeOf

func MidnightTimeOf(t time.Time) time.Time

MidnightTimeOf 当日零点

func NextMidnight

func NextMidnight(ts int64) int64

NextMidnight 下一个凌晨

func ParseDuration

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

ParseDuration parses a duration string, this extends `time.ParseDuration` with days A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h", "d".

func PrettyDuration

func PrettyDuration(d time.Duration) string

PrettyDuration returns a string representing the duration in the form of "4d2h3m5s".

func PrettyTime

func PrettyTime(ms int64) string

PrettyTime 返回毫秒时间的字符串显示，100000 => 1d3h46m40s

func StartingOfWeek

func StartingOfWeek(t time.Time) time.Time

StartingOfWeek 本周的起点

func ThisMomentAfterDays

func ThisMomentAfterDays(this time.Time, days int) time.Time

ThisMomentAfterDays N天后的这个时候

func TimeOfMS

func TimeOfMS(ms int64) time.Time

func UTCTimeOfMS

func UTCTimeOfMS(ms int64) time.Time

Types

type Clock

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

Clock 提供一些对壁钟时间的操作，不适用于高精度的计时场景 设计初衷是为精度至少为秒的上层业务服务, 支持时钟的往前/后调拨

func NewClock

func NewClock(interval time.Duration) *Clock

func (*Clock) DateTime

func (c *Clock) DateTime() string

func (*Clock) Go

func (c *Clock) Go()

func (*Clock) Now

func (c *Clock) Now() time.Time

func (*Clock) NowMs

func (c *Clock) NowMs() int64

func (*Clock) Reset

func (c *Clock) Reset()

Reset 恢复时钟

func (*Clock) Stop

func (c *Clock) Stop()

func (*Clock) Travel

func (c *Clock) Travel(d time.Duration)

Travel 拨动时钟（时间旅行）