mirror of
https://gitee.com/johng/gf.git
synced 2024-12-02 12:17:53 +08:00
28f83d3d32
when day is 21，abbreviated as 21st，suffix is st ,is not th when day is 22，abbreviated as 22nd，suffix is nd ,is not th when day is 23，abbreviated as 23rd，suffix is rd ,is not th when day is 31，abbreviated as 31st，suffix is st ,is not th
279 lines
8.9 KiB
Go
279 lines
8.9 KiB
Go
// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
|
|
//
|
|
// 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,
|
|
// You can obtain one at https://github.com/gogf/gf.
|
|
|
|
package gtime
|
|
|
|
import (
|
|
"bytes"
|
|
"strconv"
|
|
"strings"
|
|
|
|
"github.com/gogf/gf/text/gregex"
|
|
)
|
|
|
|
var (
|
|
// Refer: http://php.net/manual/en/function.date.php
|
|
formats = map[byte]string{
|
|
'd': "02", // Day: Day of the month, 2 digits with leading zeros. Eg: 01 to 31.
|
|
'D': "Mon", // Day: A textual representation of a day, three letters. Eg: Mon through Sun.
|
|
'w': "Monday", // Day: Numeric representation of the day of the week. Eg: 0 (for Sunday) through 6 (for Saturday).
|
|
'N': "Monday", // Day: ISO-8601 numeric representation of the day of the week. Eg: 1 (for Monday) through 7 (for Sunday).
|
|
'j': "=j=02", // Day: Day of the month without leading zeros. Eg: 1 to 31.
|
|
'S': "02", // Day: English ordinal suffix for the day of the month, 2 characters. Eg: st, nd, rd or th. Works well with j.
|
|
'l': "Monday", // Day: A full textual representation of the day of the week. Eg: Sunday through Saturday.
|
|
'z': "", // Day: The day of the year (starting from 0). Eg: 0 through 365.
|
|
'W': "", // Week: ISO-8601 week number of year, weeks starting on Monday. Eg: 42 (the 42nd week in the year).
|
|
'F': "January", // Month: A full textual representation of a month, such as January or March. Eg: January through December.
|
|
'm': "01", // Month: Numeric representation of a month, with leading zeros. Eg: 01 through 12.
|
|
'M': "Jan", // Month: A short textual representation of a month, three letters. Eg: Jan through Dec.
|
|
'n': "1", // Month: Numeric representation of a month, without leading zeros. Eg: 1 through 12.
|
|
't': "", // Month: Number of days in the given month. Eg: 28 through 31.
|
|
'Y': "2006", // Year: A full numeric representation of a year, 4 digits. Eg: 1999 or 2003.
|
|
'y': "06", // Year: A two digit representation of a year. Eg: 99 or 03.
|
|
'a': "pm", // Time: Lowercase Ante meridiem and Post meridiem. Eg: am or pm.
|
|
'A': "PM", // Time: Uppercase Ante meridiem and Post meridiem. Eg: AM or PM.
|
|
'g': "3", // Time: 12-hour format of an hour without leading zeros. Eg: 1 through 12.
|
|
'G': "=G=15", // Time: 24-hour format of an hour without leading zeros. Eg: 0 through 23.
|
|
'h': "03", // Time: 12-hour format of an hour with leading zeros. Eg: 01 through 12.
|
|
'H': "15", // Time: 24-hour format of an hour with leading zeros. Eg: 00 through 23.
|
|
'i': "04", // Time: Minutes with leading zeros. Eg: 00 to 59.
|
|
's': "05", // Time: Seconds with leading zeros. Eg: 00 through 59.
|
|
'u': "=u=.000", // Time: Milliseconds. Eg: 234, 678.
|
|
'U': "", // Time: Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT).
|
|
'O': "-0700", // Zone: Difference to Greenwich time (GMT) in hours. Eg: +0200.
|
|
'P': "-07:00", // Zone: Difference to Greenwich time (GMT) with colon between hours and minutes. Eg: +02:00.
|
|
'T': "MST", // Zone: Timezone abbreviation. Eg: UTC, EST, MDT ...
|
|
'c': "2006-01-02T15:04:05-07:00", // Format: ISO 8601 date. Eg: 2004-02-12T15:19:21+00:00.
|
|
'r': "Mon, 02 Jan 06 15:04 MST", // Format: RFC 2822 formatted date. Eg: Thu, 21 Dec 2000 16:01:07 +0200.
|
|
}
|
|
|
|
// Week to number mapping.
|
|
weekMap = map[string]string{
|
|
"Sunday": "0",
|
|
"Monday": "1",
|
|
"Tuesday": "2",
|
|
"Wednesday": "3",
|
|
"Thursday": "4",
|
|
"Friday": "5",
|
|
"Saturday": "6",
|
|
}
|
|
|
|
// Day count of each month which is not in leap year.
|
|
dayOfMonth = []int{0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334}
|
|
)
|
|
|
|
// Format formats and returns the formatted result with custom <format>.
|
|
func (t *Time) Format(format string) string {
|
|
if t == nil {
|
|
return ""
|
|
}
|
|
runes := []rune(format)
|
|
buffer := bytes.NewBuffer(nil)
|
|
for i := 0; i < len(runes); {
|
|
switch runes[i] {
|
|
case '\\':
|
|
if i < len(runes)-1 {
|
|
buffer.WriteRune(runes[i+1])
|
|
i += 2
|
|
continue
|
|
} else {
|
|
return buffer.String()
|
|
}
|
|
case 'W':
|
|
buffer.WriteString(strconv.Itoa(t.WeeksOfYear()))
|
|
case 'z':
|
|
buffer.WriteString(strconv.Itoa(t.DayOfYear()))
|
|
case 't':
|
|
buffer.WriteString(strconv.Itoa(t.DaysInMonth()))
|
|
case 'U':
|
|
buffer.WriteString(strconv.FormatInt(t.Unix(), 10))
|
|
default:
|
|
if runes[i] > 255 {
|
|
buffer.WriteRune(runes[i])
|
|
break
|
|
}
|
|
if f, ok := formats[byte(runes[i])]; ok {
|
|
result := t.Time.Format(f)
|
|
// Particular chars should be handled here.
|
|
switch runes[i] {
|
|
case 'j':
|
|
for _, s := range []string{"=j=0", "=j="} {
|
|
result = strings.Replace(result, s, "", -1)
|
|
}
|
|
buffer.WriteString(result)
|
|
case 'G':
|
|
for _, s := range []string{"=G=0", "=G="} {
|
|
result = strings.Replace(result, s, "", -1)
|
|
}
|
|
buffer.WriteString(result)
|
|
case 'u':
|
|
buffer.WriteString(strings.Replace(result, "=u=.", "", -1))
|
|
case 'w':
|
|
buffer.WriteString(weekMap[result])
|
|
case 'N':
|
|
buffer.WriteString(strings.Replace(weekMap[result], "0", "7", -1))
|
|
case 'S':
|
|
buffer.WriteString(formatMonthDaySuffixMap(result))
|
|
default:
|
|
buffer.WriteString(result)
|
|
}
|
|
} else {
|
|
buffer.WriteRune(runes[i])
|
|
}
|
|
}
|
|
i++
|
|
}
|
|
return buffer.String()
|
|
}
|
|
|
|
// FormatNew formats and returns a new Time object with given custom <format>.
|
|
func (t *Time) FormatNew(format string) *Time {
|
|
if t == nil {
|
|
return nil
|
|
}
|
|
return NewFromStr(t.Format(format))
|
|
}
|
|
|
|
// FormatTo formats <t> with given custom <format>.
|
|
func (t *Time) FormatTo(format string) *Time {
|
|
if t == nil {
|
|
return nil
|
|
}
|
|
t.Time = NewFromStr(t.Format(format)).Time
|
|
return t
|
|
}
|
|
|
|
// Layout formats the time with stdlib layout and returns the formatted result.
|
|
func (t *Time) Layout(layout string) string {
|
|
if t == nil {
|
|
return ""
|
|
}
|
|
return t.Time.Format(layout)
|
|
}
|
|
|
|
// LayoutNew formats the time with stdlib layout and returns the new Time object.
|
|
func (t *Time) LayoutNew(layout string) *Time {
|
|
if t == nil {
|
|
return nil
|
|
}
|
|
return NewFromStr(t.Layout(layout))
|
|
}
|
|
|
|
// LayoutTo formats <t> with stdlib layout.
|
|
func (t *Time) LayoutTo(layout string) *Time {
|
|
if t == nil {
|
|
return nil
|
|
}
|
|
t.Time = NewFromStr(t.Layout(layout)).Time
|
|
return t
|
|
}
|
|
|
|
// IsLeapYear checks whether the time is leap year.
|
|
func (t *Time) IsLeapYear() bool {
|
|
year := t.Year()
|
|
if (year%4 == 0 && year%100 != 0) || year%400 == 0 {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// DayOfYear checks and returns the position of the day for the year.
|
|
func (t *Time) DayOfYear() int {
|
|
day := t.Day()
|
|
month := int(t.Month())
|
|
if t.IsLeapYear() {
|
|
if month > 2 {
|
|
return dayOfMonth[month-1] + day
|
|
}
|
|
return dayOfMonth[month-1] + day - 1
|
|
}
|
|
return dayOfMonth[month-1] + day - 1
|
|
}
|
|
|
|
// DaysInMonth returns the day count of current month.
|
|
func (t *Time) DaysInMonth() int {
|
|
switch t.Month() {
|
|
case 1, 3, 5, 7, 8, 10, 12:
|
|
return 31
|
|
case 4, 6, 9, 11:
|
|
return 30
|
|
}
|
|
if t.IsLeapYear() {
|
|
return 29
|
|
}
|
|
return 28
|
|
}
|
|
|
|
// WeeksOfYear returns the point of current week for the year.
|
|
func (t *Time) WeeksOfYear() int {
|
|
_, week := t.ISOWeek()
|
|
return week
|
|
}
|
|
|
|
// formatToStdLayout converts custom format to stdlib layout.
|
|
func formatToStdLayout(format string) string {
|
|
b := bytes.NewBuffer(nil)
|
|
for i := 0; i < len(format); {
|
|
switch format[i] {
|
|
case '\\':
|
|
if i < len(format)-1 {
|
|
b.WriteByte(format[i+1])
|
|
i += 2
|
|
continue
|
|
} else {
|
|
return b.String()
|
|
}
|
|
|
|
default:
|
|
if f, ok := formats[format[i]]; ok {
|
|
// Handle particular chars.
|
|
switch format[i] {
|
|
case 'j':
|
|
b.WriteString("2")
|
|
case 'G':
|
|
b.WriteString("15")
|
|
case 'u':
|
|
if i > 0 && format[i-1] == '.' {
|
|
b.WriteString("000")
|
|
} else {
|
|
b.WriteString(".000")
|
|
}
|
|
|
|
default:
|
|
b.WriteString(f)
|
|
}
|
|
} else {
|
|
b.WriteByte(format[i])
|
|
}
|
|
i++
|
|
}
|
|
}
|
|
return b.String()
|
|
}
|
|
|
|
// formatToRegexPattern converts the custom format to its corresponding regular expression.
|
|
func formatToRegexPattern(format string) string {
|
|
s := gregex.Quote(formatToStdLayout(format))
|
|
s, _ = gregex.ReplaceString(`[0-9]`, `[0-9]`, s)
|
|
s, _ = gregex.ReplaceString(`[A-Za-z]`, `[A-Za-z]`, s)
|
|
s, _ = gregex.ReplaceString(`\s+`, `\s+`, s)
|
|
return s
|
|
}
|
|
|
|
// formatMonthDaySuffixMap returns the short english word for current day.
|
|
func formatMonthDaySuffixMap(day string) string {
|
|
switch day {
|
|
case "01", "21", "31":
|
|
return "st"
|
|
case "02", "22":
|
|
return "nd"
|
|
case "03", "23":
|
|
return "rd"
|
|
default:
|
|
return "th"
|
|
}
|
|
}
|