2019-02-02 16:18:25 +08:00
|
|
|
// Copyright 2017 gf Author(https://github.com/gogf/gf). All Rights Reserved.
|
2018-06-21 11:44:58 +08:00
|
|
|
//
|
|
|
|
// This Source Code Form is subject to the terms of the MIT License.
|
|
|
|
// If a copy of the MIT was not distributed with this file,
|
2019-02-02 16:18:25 +08:00
|
|
|
// You can obtain one at https://github.com/gogf/gf.
|
2018-06-21 11:44:58 +08:00
|
|
|
|
2019-01-15 23:27:47 +08:00
|
|
|
// Package gtime provides functionality for measuring and displaying time.
|
2018-06-21 11:44:58 +08:00
|
|
|
package gtime
|
|
|
|
|
|
|
|
import (
|
2019-06-19 09:06:52 +08:00
|
|
|
"errors"
|
|
|
|
"regexp"
|
|
|
|
"strconv"
|
|
|
|
"strings"
|
|
|
|
"time"
|
2019-07-25 23:25:30 +08:00
|
|
|
|
2019-07-29 21:01:19 +08:00
|
|
|
"github.com/gogf/gf/text/gregex"
|
2018-06-21 11:44:58 +08:00
|
|
|
)
|
|
|
|
|
2018-06-29 13:03:29 +08:00
|
|
|
const (
|
2019-09-29 20:12:59 +08:00
|
|
|
// Short writes for common usage durations.
|
2019-06-19 09:06:52 +08:00
|
|
|
D = 24 * time.Hour
|
|
|
|
H = time.Hour
|
|
|
|
M = time.Minute
|
|
|
|
S = time.Second
|
|
|
|
MS = time.Millisecond
|
|
|
|
US = time.Microsecond
|
|
|
|
NS = time.Nanosecond
|
2019-01-18 11:30:52 +08:00
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// Regular expression1(datetime separator supports '-', '/', '.').
|
|
|
|
// Eg:
|
2019-06-19 09:06:52 +08:00
|
|
|
// "2017-12-14 04:51:34 +0805 LMT",
|
|
|
|
// "2017-12-14 04:51:34 +0805 LMT",
|
|
|
|
// "2006-01-02T15:04:05Z07:00",
|
|
|
|
// "2014-01-17T01:19:15+08:00",
|
|
|
|
// "2018-02-09T20:46:17.897Z",
|
|
|
|
// "2018-02-09 20:46:17.897",
|
|
|
|
// "2018-02-09T20:46:17Z",
|
|
|
|
// "2018-02-09 20:46:17",
|
|
|
|
// "2018/10/31 - 16:38:46"
|
|
|
|
// "2018-02-09",
|
|
|
|
// "2018.02.09",
|
|
|
|
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]*)`
|
2019-09-29 20:12:59 +08:00
|
|
|
|
|
|
|
// Regular expression2(datetime separator supports '-', '/', '.').
|
|
|
|
// Eg:
|
2019-06-19 09:06:52 +08:00
|
|
|
// 01-Nov-2018 11:50:28
|
|
|
|
// 01/Nov/2018 11:50:28
|
|
|
|
// 01.Nov.2018 11:50:28
|
|
|
|
// 01.Nov.2018:11:50:28
|
|
|
|
TIME_REAGEX_PATTERN2 = `(\d{1,2}[-/\.][A-Za-z]{3,}[-/\.]\d{4})[:\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]*)`
|
2018-06-29 13:03:29 +08:00
|
|
|
)
|
|
|
|
|
2018-06-21 11:44:58 +08:00
|
|
|
var (
|
2019-09-29 20:12:59 +08:00
|
|
|
// It's more high performance using regular expression
|
|
|
|
// than time.ParseInLocation to parse the datetime string.
|
2019-06-19 09:06:52 +08:00
|
|
|
timeRegex1, _ = regexp.Compile(TIME_REAGEX_PATTERN1)
|
|
|
|
timeRegex2, _ = regexp.Compile(TIME_REAGEX_PATTERN2)
|
2019-09-29 20:12:59 +08:00
|
|
|
|
|
|
|
// Month words to arabic numerals mapping.
|
2019-06-19 09:06:52 +08:00
|
|
|
monthMap = map[string]int{
|
|
|
|
"jan": 1,
|
|
|
|
"feb": 2,
|
|
|
|
"mar": 3,
|
|
|
|
"apr": 4,
|
|
|
|
"may": 5,
|
|
|
|
"jun": 6,
|
|
|
|
"jul": 7,
|
|
|
|
"aug": 8,
|
|
|
|
"sep": 9,
|
|
|
|
"sept": 9,
|
|
|
|
"oct": 10,
|
|
|
|
"nov": 11,
|
|
|
|
"dec": 12,
|
|
|
|
"january": 1,
|
|
|
|
"february": 2,
|
|
|
|
"march": 3,
|
|
|
|
"april": 4,
|
|
|
|
"june": 6,
|
|
|
|
"july": 7,
|
|
|
|
"august": 8,
|
|
|
|
"september": 9,
|
|
|
|
"october": 10,
|
|
|
|
"november": 11,
|
|
|
|
"december": 12,
|
|
|
|
}
|
2018-10-16 15:49:30 +08:00
|
|
|
)
|
2018-06-21 11:44:58 +08:00
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// SetTimeZone sets the time zone for current whole process.
|
2020-01-01 14:18:00 +08:00
|
|
|
// The parameter <zone> is an area string specifying corresponding time zone,
|
|
|
|
// eg: Asia/Shanghai.
|
|
|
|
//
|
|
|
|
// Note that the time zone database needed by LoadLocation may not be
|
|
|
|
// present on all systems, especially non-Unix systems.
|
|
|
|
// LoadLocation looks in the directory or uncompressed zip file
|
|
|
|
// named by the ZONEINFO environment variable, if any, then looks in
|
|
|
|
// known installation locations on Unix systems,
|
|
|
|
// and finally looks in $GOROOT/lib/time/zoneinfo.zip.
|
2018-07-19 15:33:17 +08:00
|
|
|
func SetTimeZone(zone string) error {
|
2019-06-19 09:06:52 +08:00
|
|
|
location, err := time.LoadLocation(zone)
|
|
|
|
if err == nil {
|
|
|
|
time.Local = location
|
|
|
|
}
|
|
|
|
return err
|
2018-07-19 15:33:17 +08:00
|
|
|
}
|
|
|
|
|
2020-01-02 21:29:06 +08:00
|
|
|
// Timestamp retrieves and returns the timestamp in seconds.
|
2019-12-17 21:06:34 +08:00
|
|
|
func Timestamp() int64 {
|
|
|
|
return Now().Timestamp()
|
2018-06-21 11:44:58 +08:00
|
|
|
}
|
|
|
|
|
2020-01-02 21:29:06 +08:00
|
|
|
// TimestampMilli retrieves and returns the timestamp in milliseconds.
|
2019-12-17 21:06:34 +08:00
|
|
|
func TimestampMilli() int64 {
|
|
|
|
return Now().TimestampMilli()
|
2018-06-21 11:44:58 +08:00
|
|
|
}
|
|
|
|
|
2020-01-02 21:29:06 +08:00
|
|
|
// TimestampMicro retrieves and returns the timestamp in microseconds.
|
2019-12-17 21:06:34 +08:00
|
|
|
func TimestampMicro() int64 {
|
|
|
|
return Now().TimestampMicro()
|
|
|
|
}
|
|
|
|
|
2020-01-02 21:29:06 +08:00
|
|
|
// TimestampNano retrieves and returns the timestamp in nanoseconds.
|
2019-12-17 21:06:34 +08:00
|
|
|
func TimestampNano() int64 {
|
|
|
|
return Now().TimestampNano()
|
2018-06-21 11:44:58 +08:00
|
|
|
}
|
|
|
|
|
2020-01-02 21:29:06 +08:00
|
|
|
// TimestampStr is a convenience method which retrieves and returns
|
|
|
|
// the timestamp in seconds as string.
|
|
|
|
func TimestampStr() string {
|
|
|
|
return Now().TimestampStr()
|
|
|
|
}
|
|
|
|
|
|
|
|
// TimestampMilliStr is a convenience method which retrieves and returns
|
|
|
|
// the timestamp in milliseconds as string.
|
|
|
|
func TimestampMilliStr() string {
|
|
|
|
return Now().TimestampMilliStr()
|
|
|
|
}
|
|
|
|
|
|
|
|
// TimestampMicroStr is a convenience method which retrieves and returns
|
|
|
|
// the timestamp in microseconds as string.
|
|
|
|
func TimestampMicroStr() string {
|
|
|
|
return Now().TimestampMicroStr()
|
|
|
|
}
|
|
|
|
|
|
|
|
// TimestampNanoStr is a convenience method which retrieves and returns
|
|
|
|
// the timestamp in nanoseconds as string.
|
|
|
|
func TimestampNanoStr() string {
|
|
|
|
return Now().TimestampNanoStr()
|
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// Second returns the timestamp in seconds.
|
2019-12-17 21:06:34 +08:00
|
|
|
// Deprecated, use Timestamp instead.
|
2018-06-21 11:44:58 +08:00
|
|
|
func Second() int64 {
|
2019-12-17 21:06:34 +08:00
|
|
|
return Timestamp()
|
|
|
|
}
|
|
|
|
|
|
|
|
// Millisecond returns the timestamp in milliseconds.
|
|
|
|
// Deprecated, use TimestampMilli instead.
|
|
|
|
func Millisecond() int64 {
|
|
|
|
return TimestampMilli()
|
|
|
|
}
|
|
|
|
|
|
|
|
// Microsecond returns the timestamp in microseconds.
|
|
|
|
// Deprecated, use TimestampMicro instead.
|
|
|
|
func Microsecond() int64 {
|
|
|
|
return TimestampMicro()
|
|
|
|
}
|
|
|
|
|
|
|
|
// Nanosecond returns the timestamp in nanoseconds.
|
|
|
|
// Deprecated, use TimestampNano instead.
|
|
|
|
func Nanosecond() int64 {
|
|
|
|
return TimestampNano()
|
2018-06-21 11:44:58 +08:00
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// Date returns current date in string like "2006-01-02".
|
2018-06-21 11:44:58 +08:00
|
|
|
func Date() string {
|
2019-06-19 09:06:52 +08:00
|
|
|
return time.Now().Format("2006-01-02")
|
2018-06-21 11:44:58 +08:00
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// Datetime returns current datetime in string like "2006-01-02 15:04:05".
|
2018-06-21 11:44:58 +08:00
|
|
|
func Datetime() string {
|
2019-06-19 09:06:52 +08:00
|
|
|
return time.Now().Format("2006-01-02 15:04:05")
|
2018-06-21 11:44:58 +08:00
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// ISO8601 returns current datetime in ISO8601 format like "2006-01-02T15:04:05-07:00".
|
2019-07-25 23:25:30 +08:00
|
|
|
func ISO8601() string {
|
|
|
|
return time.Now().Format("2006-01-02T15:04:05-07:00")
|
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// ISO8601 returns current datetime in RFC822 format like "Mon, 02 Jan 06 15:04 MST".
|
2019-07-25 23:25:30 +08:00
|
|
|
func RFC822() string {
|
|
|
|
return time.Now().Format("Mon, 02 Jan 06 15:04 MST")
|
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// parseDateStr parses the string to year, month and day numbers.
|
2018-11-06 10:59:32 +08:00
|
|
|
func parseDateStr(s string) (year, month, day int) {
|
2019-06-19 09:06:52 +08:00
|
|
|
array := strings.Split(s, "-")
|
|
|
|
if len(array) < 3 {
|
|
|
|
array = strings.Split(s, "/")
|
|
|
|
}
|
|
|
|
if len(array) < 3 {
|
|
|
|
array = strings.Split(s, ".")
|
|
|
|
}
|
2019-09-29 20:12:59 +08:00
|
|
|
// Parsing failed.
|
2019-06-19 09:06:52 +08:00
|
|
|
if len(array) < 3 {
|
|
|
|
return
|
|
|
|
}
|
2019-09-29 20:12:59 +08:00
|
|
|
// Checking the year in head or tail.
|
2019-06-19 09:06:52 +08:00
|
|
|
if isNumeric(array[1]) {
|
|
|
|
year, _ = strconv.Atoi(array[0])
|
|
|
|
month, _ = strconv.Atoi(array[1])
|
|
|
|
day, _ = strconv.Atoi(array[2])
|
|
|
|
} else {
|
|
|
|
if v, ok := monthMap[strings.ToLower(array[1])]; ok {
|
|
|
|
month = v
|
|
|
|
} else {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
year, _ = strconv.Atoi(array[2])
|
|
|
|
day, _ = strconv.Atoi(array[0])
|
|
|
|
}
|
|
|
|
return
|
2018-11-06 10:59:32 +08:00
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// StrToTime converts string to *Time object.
|
|
|
|
// The parameter <format> is unnecessary, which specifies the format for converting like "Y-m-d H:i:s".
|
|
|
|
// If <format> is given, it acts as same as function StrToTimeFormat.
|
|
|
|
// If <format> is not given, it converts string as a "standard" datetime string.
|
|
|
|
// Note that, it fails and returns error if there's no date string in <str>.
|
2019-06-19 09:06:52 +08:00
|
|
|
func StrToTime(str string, format ...string) (*Time, error) {
|
|
|
|
if len(format) > 0 {
|
|
|
|
return StrToTimeFormat(str, format[0])
|
|
|
|
}
|
|
|
|
var year, month, day int
|
|
|
|
var hour, min, sec, nsec int
|
|
|
|
var match []string
|
|
|
|
var local = time.Local
|
|
|
|
if match = timeRegex1.FindStringSubmatch(str); len(match) > 0 && match[1] != "" {
|
|
|
|
for k, v := range match {
|
|
|
|
match[k] = strings.TrimSpace(v)
|
|
|
|
}
|
|
|
|
year, month, day = parseDateStr(match[1])
|
|
|
|
} else if match = timeRegex2.FindStringSubmatch(str); len(match) > 0 && match[1] != "" {
|
|
|
|
for k, v := range match {
|
|
|
|
match[k] = strings.TrimSpace(v)
|
|
|
|
}
|
|
|
|
year, month, day = parseDateStr(match[1])
|
|
|
|
} else {
|
|
|
|
return nil, errors.New("unsupported time format")
|
|
|
|
}
|
2018-11-01 17:22:55 +08:00
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// Time
|
2019-06-19 09:06:52 +08:00
|
|
|
if len(match[2]) > 0 {
|
|
|
|
s := strings.Replace(match[2], ":", "", -1)
|
|
|
|
if len(s) < 6 {
|
|
|
|
s += strings.Repeat("0", 6-len(s))
|
|
|
|
}
|
|
|
|
hour, _ = strconv.Atoi(s[0:2])
|
|
|
|
min, _ = strconv.Atoi(s[2:4])
|
|
|
|
sec, _ = strconv.Atoi(s[4:6])
|
|
|
|
}
|
2019-09-29 20:12:59 +08:00
|
|
|
// Nanoseconds, check and perform bit filling
|
2019-06-19 09:06:52 +08:00
|
|
|
if len(match[3]) > 0 {
|
|
|
|
nsec, _ = strconv.Atoi(match[3])
|
|
|
|
for i := 0; i < 9-len(match[3]); i++ {
|
|
|
|
nsec *= 10
|
|
|
|
}
|
|
|
|
}
|
2019-09-29 20:12:59 +08:00
|
|
|
// If there's zone information in the string,
|
|
|
|
// it then performs time zone conversion, which converts the time zone to UTC.
|
2019-06-19 09:06:52 +08:00
|
|
|
if match[4] != "" && match[6] == "" {
|
|
|
|
match[6] = "000000"
|
|
|
|
}
|
2019-09-29 20:12:59 +08:00
|
|
|
// If there's offset in the string, it then firstly processes the offset.
|
2019-06-19 09:06:52 +08:00
|
|
|
if match[6] != "" {
|
|
|
|
zone := strings.Replace(match[6], ":", "", -1)
|
|
|
|
zone = strings.TrimLeft(zone, "+-")
|
|
|
|
if len(zone) <= 6 {
|
|
|
|
zone += strings.Repeat("0", 6-len(zone))
|
|
|
|
h, _ := strconv.Atoi(zone[0:2])
|
|
|
|
m, _ := strconv.Atoi(zone[2:4])
|
|
|
|
s, _ := strconv.Atoi(zone[4:6])
|
2019-09-29 20:12:59 +08:00
|
|
|
// Comparing the given time zone whether equals to current tine zone,
|
|
|
|
// it converts it to UTC if they does not.
|
2019-06-19 09:06:52 +08:00
|
|
|
_, localOffset := time.Now().Zone()
|
2019-09-29 20:12:59 +08:00
|
|
|
// Comparing in seconds.
|
2019-06-19 09:06:52 +08:00
|
|
|
if (h*3600 + m*60 + s) != localOffset {
|
|
|
|
local = time.UTC
|
2019-09-29 20:12:59 +08:00
|
|
|
// UTC conversion.
|
2019-06-19 09:06:52 +08:00
|
|
|
operation := match[5]
|
|
|
|
if operation != "+" && operation != "-" {
|
|
|
|
operation = "-"
|
|
|
|
}
|
|
|
|
switch operation {
|
|
|
|
case "+":
|
|
|
|
if h > 0 {
|
|
|
|
hour -= h
|
|
|
|
}
|
|
|
|
if m > 0 {
|
|
|
|
min -= m
|
|
|
|
}
|
|
|
|
if s > 0 {
|
|
|
|
sec -= s
|
|
|
|
}
|
|
|
|
case "-":
|
|
|
|
if h > 0 {
|
|
|
|
hour += h
|
|
|
|
}
|
|
|
|
if m > 0 {
|
|
|
|
min += m
|
|
|
|
}
|
|
|
|
if s > 0 {
|
|
|
|
sec += s
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2019-09-29 20:12:59 +08:00
|
|
|
// It finally converts all time to UTC time zone.
|
2019-06-19 09:06:52 +08:00
|
|
|
return NewFromTime(time.Date(year, time.Month(month), day, hour, min, sec, nsec, local)), nil
|
2018-06-21 11:44:58 +08:00
|
|
|
}
|
2018-07-11 13:51:03 +08:00
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// ConvertZone converts time in string <strTime> from <fromZone> to <toZone>.
|
|
|
|
// The parameter <fromZone> is unnecessary, it is current time zone in default.
|
2019-06-19 09:06:52 +08:00
|
|
|
func ConvertZone(strTime string, toZone string, fromZone ...string) (*Time, error) {
|
|
|
|
t, err := StrToTime(strTime)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
if len(fromZone) > 0 {
|
|
|
|
if l, err := time.LoadLocation(fromZone[0]); err != nil {
|
|
|
|
return nil, err
|
|
|
|
} else {
|
|
|
|
t.Time = time.Date(t.Year(), t.Month(), t.Day(), t.Hour(), t.Minute(), t.Time.Second(), t.Time.Nanosecond(), l)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if l, err := time.LoadLocation(toZone); err != nil {
|
|
|
|
return nil, err
|
|
|
|
} else {
|
|
|
|
return t.ToLocation(l), nil
|
|
|
|
}
|
2018-10-16 15:49:30 +08:00
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// StrToTimeFormat parses string <str> to *Time object with given format <format>.
|
|
|
|
// The parameter <format> is like "Y-m-d H:i:s".
|
2018-11-01 17:22:55 +08:00
|
|
|
func StrToTimeFormat(str string, format string) (*Time, error) {
|
2019-06-19 09:06:52 +08:00
|
|
|
return StrToTimeLayout(str, formatToStdLayout(format))
|
2018-07-11 17:06:47 +08:00
|
|
|
}
|
2018-11-01 17:22:55 +08:00
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// StrToTimeLayout parses string <str> to *Time object with given format <layout>.
|
|
|
|
// The parameter <layout> is in stdlib format like "2006-01-02 15:04:05".
|
2018-11-01 17:22:55 +08:00
|
|
|
func StrToTimeLayout(str string, layout string) (*Time, error) {
|
2019-06-19 09:06:52 +08:00
|
|
|
if t, err := time.ParseInLocation(layout, str, time.Local); err == nil {
|
|
|
|
return NewFromTime(t), nil
|
|
|
|
} else {
|
|
|
|
return nil, err
|
|
|
|
}
|
2018-07-11 13:51:03 +08:00
|
|
|
}
|
2018-11-01 17:22:55 +08:00
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// ParseTimeFromContent retrieves time information for content string, it then parses and returns it as *Time object.
|
|
|
|
// It returns the first time information if there're more than one time string in the content.
|
|
|
|
// It only retrieves and parses the time information with given <format> if it's passed.
|
2019-06-19 09:06:52 +08:00
|
|
|
func ParseTimeFromContent(content string, format ...string) *Time {
|
|
|
|
if len(format) > 0 {
|
|
|
|
if match, err := gregex.MatchString(formatToRegexPattern(format[0]), content); err == nil && len(match) > 0 {
|
|
|
|
return NewFromStrFormat(match[0], format[0])
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
if match := timeRegex1.FindStringSubmatch(content); len(match) >= 1 {
|
|
|
|
return NewFromStr(strings.Trim(match[0], "./_- \n\r"))
|
|
|
|
} else if match := timeRegex2.FindStringSubmatch(content); len(match) >= 1 {
|
|
|
|
return NewFromStr(strings.Trim(match[0], "./_- \n\r"))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return nil
|
2018-11-05 13:53:17 +08:00
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// FuncCost calculates the cost time of function <f> in nanoseconds.
|
2018-11-05 13:53:17 +08:00
|
|
|
func FuncCost(f func()) int64 {
|
2019-06-19 09:06:52 +08:00
|
|
|
t := Nanosecond()
|
|
|
|
f()
|
|
|
|
return Nanosecond() - t
|
2019-01-31 13:00:17 +08:00
|
|
|
}
|
|
|
|
|
2019-09-29 20:12:59 +08:00
|
|
|
// isNumeric checks whether given <s> is a number.
|
2019-01-31 13:00:17 +08:00
|
|
|
func isNumeric(s string) bool {
|
2019-06-19 09:06:52 +08:00
|
|
|
length := len(s)
|
|
|
|
if length == 0 {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
for i := 0; i < len(s); i++ {
|
|
|
|
if s[i] < byte('0') || s[i] > byte('9') {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return true
|
|
|
|
}
|