timeutil

package
v1.1.39 Latest Latest
Warning

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

 Go to latest Published: May 7, 2026 License: MIT Imports: 9 Imported by: 4

Documentation

Index

Constants

View Source 
const (
	DateLayout  = "2006-01-02"
	ClockLayout = "15:04:05"
	TimeLayout  = DateLayout + " " + ClockLayout

	DefaultTimeLocationName = "Asia/Shanghai"
)
View Source 
const (
	DT14                = "20060102150405"
	DT8                 = "20060102"
	DT8MDY              = "01022006"
	DT6                 = "200601"
	MonthDay            = "1/2"
	DIN5008FullDate     = "02.01.2006" // German DIN 5008 standard
	DIN5008Date         = "02.01.06"
	RFC3339FullDate     = time.DateOnly
	RFC3339Milli        = "2006-01-02T15:04:05.999Z07:00"
	RFC3339Dash         = "2006-01-02T15-04-05Z07-00"
	ISO8601             = "2006-01-02T15:04:05Z0700"
	ISO8601TZHour       = "2006-01-02T15:04:05Z07"
	ISO8601NoTZ         = "2006-01-02T15:04:05"
	ISO8601MilliNoTZ    = "2006-01-02T15:04:05.999"
	ISO8601Milli        = "2006-01-02T15:04:05.999Z0700"
	ISO8601CompactZ     = "20060102T150405Z0700"
	ISO8601CompactNoTZ  = "20060102T150405"
	ISO8601YM           = "2006-01"
	ISO9075             = time.DateTime                    // ISO/IEC 9075 used by MySQL, BigQuery, etc.
	ISO9075MicroTZ      = "2006-01-02 15:04:05.999999-07"  // ISO/IEC 9075 used by PostgreSQL
	RFC5322             = "Mon, 2 Jan 2006 15:04:05 -0700" // RFC5322             = "Mon Jan 02 15:04:05 -0700 2006"
	SQLTimestamp        = ISO9075
	SQLTimestampMinutes = "2006-01-02 15:04"
	Ruby                = "2006-01-02 15:04:05 -0700" // Ruby Time.now.to_s
	InsightlyAPIQuery   = "_1/_2/2006 _3:04:05 PM"
	DateMDY             = "1/2/2006" // an underscore results in a space.
	DateMDYSlash        = "01/02/2006"
	DateDMYDash         = "_2-01-2006"     // Jira XML Date format
	DateDMYHM2          = "02:01:06 15:04" // GMT time in format dd:mm:yy hh:mm
	DateYMD             = RFC3339FullDate
	DateTextUS          = "January 2, 2006"
	DateTextUSAbbr3     = "Jan 2, 2006"
	DateTextEU          = "2 January 2006"
	DateTextEUAbbr3     = "2 Jan 2006"
	MonthAbbrYear       = "Jan 2006"
	MonthYear           = "January 2006"
)

More predefined layouts for use in Time.Format and time.Parse.

View Source 
const (
	RFC3339Min         = "0000-01-01T00:00:00Z"
	RFC3339Max         = "9999-12-31T23:59:59Z"
	RFC3339Zero        = "0001-01-01T00:00:00Z" // Golang zero value
	RFC3339ZeroUnix    = "1970-01-01T00:00:00Z"
	RFC3339YMDZeroUnix = int64(-62135596800)
)
View Source 
const (
	LayoutNameDT4  = "dt4"
	LayoutNameDT6  = "dt6"
	LayoutNameDT8  = "dt8"
	LayoutNameDT14 = "dt14"
)

Variables

View Source 
var FormatMap = map[string]string{
	"RFC3339":    time.RFC3339,
	"RFC3339YMD": RFC3339FullDate,
	"ISO8601YM":  ISO8601YM,
}
View Source 
var ReferenceTimeValue time.Time = time.Date(2006, 1, 2, 15, 4, 5, 999999999, time.FixedZone("MST", -7*60*60))

Functions

func DayDifferenceHours 

func DayDifferenceHours(startDate, endDate string) float64

DayDifferenceHours 两天之间相差了多少小时

func DaySecondsDifferenceHours 

func DaySecondsDifferenceHours(startSecond, endSecond int64) float64

func DayTimeDifferenceHours 

func DayTimeDifferenceHours(startDate, endDate time.Time) float64

func DurationHMS 

func DurationHMS(d time.Duration) (int, int, int)

DurationHMS Extracts the hours, minutes, and seconds from the given duration.

func DurationToDurationpb added in v1.1.15 

func DurationToDurationpb(duration *time.Duration) *durationpb.Duration

func DurationpbToDuration added in v1.1.15 

func DurationpbToDuration(duration *durationpb.Duration) *time.Duration

func DurationpbToFloat added in v1.1.14 

func DurationpbToFloat(duration *durationpb.Duration, timePrecision time.Duration) *float64

func DurationpbToNumber added in v1.1.14 

func DurationpbToNumber[T int | int8 | int16 | int32 | int64 | uint | uint8 | uint16 | uint32 | uint64 | float32 | float64](duration *durationpb.Duration, timePrecision time.Duration) *T

func DurationpbToSecond added in v1.1.23 

func DurationpbToSecond(duration *durationpb.Duration) *float64

func DurationpbToString added in v1.1.23 

func DurationpbToString(in *durationpb.Duration) *string

func Float64ToDurationpb added in v1.1.20 

func Float64ToDurationpb(d float64) *durationpb.Duration

func FloatToDurationpb added in v1.1.14 

func FloatToDurationpb(duration *float64, timePrecision time.Duration) *durationpb.Duration

func FormatTimeMulti added in v1.1.24 

func FormatTimeMulti(dateFormat string, v any) string

FormatTimeMulti formats a `time.Time` object or an epoch number. It is adapted from `github.com/wcharczuk/go-chart`.

func FormatTimeToString added in v1.1.24 

func FormatTimeToString(format string) func(time.Time) string

func FormatTimer 

func FormatTimer(d time.Duration) string

FormatTimer Formats the given duration in a colon-separated timer format in the form [HH:]MM:SS.

func FormatTimerf 

func FormatTimerf(format string, d time.Duration) string

FormatTimerf Formats the given duration using the given format string. The string follows the same formatting rules as described in the fmt package, and will receive three integer arguments: hours, minutes, and seconds.

func FromTo added in v1.1.24 

func FromTo(value, fromLayout, toLayout string) (string, error)

Reformat a time string from one format to another Deprecated...

func FromTo2 added in v1.1.24 

func FromTo2(fromLayout, toLayout, value string) (string, error)

Reformat a time string from one format to another

func FromToFirstValue added in v1.1.24 

func FromToFirstValue(fromLayout, toLayout string, values []string) (string, error)

func FromToFirstValueOrEmpty added in v1.1.24 

func FromToFirstValueOrEmpty(fromLayout, toLayout string, values []string) string

func GetCurrentMonthRangeDateString 

func GetCurrentMonthRangeDateString() (string, string)

GetCurrentMonthRangeDateString 获取区间时间内的日期字符串（比如：2023-05-23 2023-05-23） - 本月

func GetCurrentMonthRangeTime 

func GetCurrentMonthRangeTime() (time.Time, time.Time)

GetCurrentMonthRangeTime 获取区间时间 - 本月

func GetCurrentMonthRangeTimeString 

func GetCurrentMonthRangeTimeString() (string, string)

GetCurrentMonthRangeTimeString 获取区间时间内的时间字符串（比如：2023-05-23 00:00:00 2023-05-23 23:59:59） - 本月

func GetCurrentYearRangeDateString 

func GetCurrentYearRangeDateString() (string, string)

GetCurrentYearRangeDateString 获取区间时间内的日期字符串（比如：2023-05-23 2023-05-23） - 今年

func GetCurrentYearRangeTime 

func GetCurrentYearRangeTime() (time.Time, time.Time)

GetCurrentYearRangeTime 获取区间时间 - 今年

func GetCurrentYearRangeTimeString 

func GetCurrentYearRangeTimeString() (string, string)

GetCurrentYearRangeTimeString 获取区间时间内的时间字符串（比如：2023-05-23 00:00:00 2023-05-23 23:59:59） - 今年

func GetDefaultTimeLocation added in v1.1.20 

func GetDefaultTimeLocation() *time.Location

func GetFormat added in v1.1.24 

func GetFormat(formatName string) (string, error)

func GetLastMonthRangeDateString 

func GetLastMonthRangeDateString() (string, string)

GetLastMonthRangeDateString 获取区间时间内的日期字符串（比如：2023-05-23 2023-05-23） - 上个月

func GetLastMonthRangeTime 

func GetLastMonthRangeTime() (time.Time, time.Time)

GetLastMonthRangeTime 获取区间时间 - 上个月

func GetLastMonthRangeTimeString 

func GetLastMonthRangeTimeString() (string, string)

GetLastMonthRangeTimeString 获取区间时间内的时间字符串（比如：2023-05-23 00:00:00 2023-05-23 23:59:59） - 上个月

func GetLastYearRangeDateString 

func GetLastYearRangeDateString() (string, string)

GetLastYearRangeDateString 获取区间时间内的日期字符串（比如：2023-05-23 2023-05-23） - 去年

func GetLastYearRangeTime 

func GetLastYearRangeTime() (time.Time, time.Time)

GetLastYearRangeTime 获取区间时间 - 去年

func GetLastYearRangeTimeString 

func GetLastYearRangeTimeString() (string, string)

GetLastYearRangeTimeString 获取区间时间内的时间字符串（比如：2023-05-23 00:00:00 2023-05-23 23:59:59） - 去年

func GetTodayRangeDateString 

func GetTodayRangeDateString() (string, string)

GetTodayRangeDateString 获取区间时间内的日期字符串（比如：2023-05-23 2023-05-23） - 今天

func GetTodayRangeTime 

func GetTodayRangeTime() (time.Time, time.Time)

GetTodayRangeTime 获取区间时间 - 今天

func GetTodayRangeTimeString 

func GetTodayRangeTimeString() (string, string)

GetTodayRangeTimeString 获取区间时间内的时间字符串（比如：2023-05-23 00:00:00 2023-05-23 23:59:59） - 今天

func GetYesterdayRangeDateString 

func GetYesterdayRangeDateString() (string, string)

GetYesterdayRangeDateString 获取区间时间内的日期字符串（比如：2023-05-23 2023-05-23） - 昨天

func GetYesterdayRangeTime 

func GetYesterdayRangeTime() (time.Time, time.Time)

GetYesterdayRangeTime 获取区间时间 - 昨天

func GetYesterdayRangeTimeString 

func GetYesterdayRangeTimeString() (string, string)

GetYesterdayRangeTimeString 获取区间时间内的时间字符串（比如：2023-05-23 00:00:00 2023-05-23 23:59:59） - 昨天

func IsDTX added in v1.1.24 

func IsDTX(d int) (string, error)

IsDTX returns the dtx format if conformant to various DTX values (dt4, dt6, dt8, dt14).

func MicrosecondsToTimestamp added in v1.1.30 

func MicrosecondsToTimestamp(microseconds *int64) *timestamppb.Timestamp

func MillisecondsToTimestamp added in v1.1.30 

func MillisecondsToTimestamp(milliseconds *int64) *timestamppb.Timestamp

func NanosecondsToTimestamp added in v1.1.30 

func NanosecondsToTimestamp(nanoseconds *int64) *timestamppb.Timestamp

NanosecondsToTimestamp 将纳秒转换为 timestamppb.Timestamp

func NumberToDurationpb added in v1.1.14 

func NumberToDurationpb[T int | int8 | int16 | int32 | int64 | uint | uint8 | uint16 | uint32 | uint64 | float32 | float64](duration *T, timePrecision time.Duration) *durationpb.Duration

func OffsetFormat added in v1.1.24 

func OffsetFormat(offset int, useColon, useZ bool) string

OffsetFormat converts an integer offset value to a string value to use in string time formats. Note: RFC-3339 times use colons and the UTC "Z" offset.

func ParseFirst added in v1.1.24 

func ParseFirst(layouts []string, value string) (time.Time, error)

ParseFirst attempts to parse a string with a set of layouts.

func ParseFirstValue added in v1.1.24 

func ParseFirstValue(layout string, values []string) (time.Time, error)

func ParseFirstValueOrZero added in v1.1.24 

func ParseFirstValueOrZero(layout string, values []string) time.Time

func ParseOrZero added in v1.1.24 

func ParseOrZero(layout, value string) time.Time

ParseOrZero returns a parsed time.Time or the RFC-3339 zero time.

func ParseSlice added in v1.1.24 

func ParseSlice(layout string, strings []string) ([]time.Time, error)

func ParseTimeSQLTimestampUsingOffset added in v1.1.24 

func ParseTimeSQLTimestampUsingOffset(timeStr string, offset int) (time.Time, error)

ParseTimeSQLTimestampUsingOffset converts a SQL timestamp without timezone adding in a manual integer timezone.

func ParseTimeUsingOffset added in v1.1.24 

func ParseTimeUsingOffset(format, raw, sep string, offset int, useColon, useZ bool) (time.Time, error)

func RangeStringDateToTime added in v1.1.30 

func RangeStringDateToTime(startDate, endDate string) (time.Time, time.Time)

func ReferenceTime 

func ReferenceTime() time.Time

ReferenceTime Return the standard Golang reference time (2006-01-02T15:04:05.999999999Z07:00)

func RefreshDefaultTimeLocation 

func RefreshDefaultTimeLocation(name string) *time.Location

func SecondToDurationpb added in v1.1.20 

func SecondToDurationpb(seconds *float64) *durationpb.Duration

func SecondsDifferenceDays 

func SecondsDifferenceDays(startSecond, endSecond int64) int

SecondsDifferenceDays 两天之间相差了多少天

func SecondsToTimestamp added in v1.1.30 

func SecondsToTimestamp(seconds *int64) *timestamppb.Timestamp

SecondsToTimestamp 将秒转换为 timestamppb.Timestamp

func StringDateToTime 

func StringDateToTime(str *string) *time.Time

StringDateToTime 字符串 -> 时间

func StringDifferenceDays 

func StringDifferenceDays(startDate, endDate string) int

StringDifferenceDays 两天之间相差了多少天

func StringTimeToTime 

func StringTimeToTime(str *string) *time.Time

StringTimeToTime 时间字符串 -> 时间

func StringToDurationpb added in v1.1.23 

func StringToDurationpb(in *string) *durationpb.Duration

func StringToTime added in v1.1.27 

func StringToTime(str *string, layout string) *time.Time

func StringToTimestamppb added in v1.1.37 

func StringToTimestamppb(str *string) *timestamppb.Timestamp

StringToTimestamppb 字符串 -> timestamppb.Timestamp

func StringToUnixMilliInt64Ptr 

func StringToUnixMilliInt64Ptr(tm *string) *int64

StringToUnixMilliInt64Ptr 字符串 -> 毫秒时间戳

func TimeDifferenceDays 

func TimeDifferenceDays(startDate, endDate time.Time) int

TimeDifferenceDays 两天之间相差了多少天

func TimeMinRFC3339 added in v1.1.24 

func TimeMinRFC3339() time.Time

func TimeToDateString 

func TimeToDateString(tm *time.Time) *string

TimeToDateString 时间 -> 日期字符串

func TimeToString added in v1.1.26 

func TimeToString(tm *time.Time, layout string) *string

func TimeToTimeString 

func TimeToTimeString(tm *time.Time) *string

TimeToTimeString 时间 -> 时间字符串

func TimeToTimestamppb added in v1.1.10 

func TimeToTimestamppb(tm *time.Time) *timestamppb.Timestamp

TimeToTimestamppb time.Time -> timestamppb.Timestamp

func TimeToUnixMilliInt64Ptr added in v1.1.22 

func TimeToUnixMilliInt64Ptr(tm *time.Time) *int64

TimeToUnixMilliInt64Ptr 时间 -> 毫秒时间戳

func TimeToUnixSecondInt64Ptr added in v1.1.22 

func TimeToUnixSecondInt64Ptr(tm *time.Time) *int64

TimeToUnixSecondInt64Ptr 时间 -> 秒时间戳

func TimeZeroRFC3339 added in v1.1.24 

func TimeZeroRFC3339() time.Time

func TimeZeroUnix added in v1.1.24 

func TimeZeroUnix() time.Time

func TimestampToMicroseconds added in v1.1.30 

func TimestampToMicroseconds(ts *timestamppb.Timestamp) int64

func TimestampToMilliseconds added in v1.1.30 

func TimestampToMilliseconds(ts *timestamppb.Timestamp) int64

func TimestampToNanoseconds added in v1.1.30 

func TimestampToNanoseconds(ts *timestamppb.Timestamp) int64

TimestampToNanoseconds 将 timestamppb.Timestamp 转换为纳秒

func TimestampToSeconds added in v1.1.30 

func TimestampToSeconds(ts *timestamppb.Timestamp) int64

TimestampToSeconds 将 timestamppb.Timestamp 转换为秒

func TimestamppbToString added in v1.1.37 

func TimestamppbToString(ts *timestamppb.Timestamp) *string

TimestamppbToString timestamppb.Timestamp -> 字符串

func TimestamppbToTime added in v1.1.10 

func TimestamppbToTime(timestamp *timestamppb.Timestamp) *time.Time

TimestamppbToTime timestamppb.Timestamp -> time.Time

func UnixMilliToStringPtr 

func UnixMilliToStringPtr(milli *int64) *string

UnixMilliToStringPtr 毫秒时间戳 -> 字符串

func UnixMilliToTimePtr added in v1.1.22 

func UnixMilliToTimePtr(milli *int64) *time.Time

UnixMilliToTimePtr 毫秒时间戳 -> 时间

func UnixSecondToTimePtr added in v1.1.22 

func UnixSecondToTimePtr(second *int64) *time.Time

UnixSecondToTimePtr 秒时间戳 -> 时间

Types

type ISO8601NoTzMilliTime added in v1.1.24 

type ISO8601NoTzMilliTime struct{ time.Time }

func (ISO8601NoTzMilliTime) MarshalJSON added in v1.1.24 

func (t ISO8601NoTzMilliTime) MarshalJSON() ([]byte, error)

func (*ISO8601NoTzMilliTime) UnmarshalJSON added in v1.1.24 

func (t *ISO8601NoTzMilliTime) UnmarshalJSON(buf []byte) error

type RFC3339YMDTime added in v1.1.24 

type RFC3339YMDTime struct{ time.Time }

func (RFC3339YMDTime) MarshalJSON added in v1.1.24 

func (t RFC3339YMDTime) MarshalJSON() ([]byte, error)

func (*RFC3339YMDTime) UnmarshalJSON added in v1.1.24 

func (t *RFC3339YMDTime) UnmarshalJSON(buf []byte) error

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.