mirror of
https://gitee.com/johng/gf.git
synced 2024-12-04 21:28:22 +08:00
261 lines
7.6 KiB
Go
261 lines
7.6 KiB
Go
// Copyright 2018 gf Author(https://github.com/gogf/gf). 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"
|
||
"github.com/gogf/gf/g/text/gregex"
|
||
"github.com/gogf/gf/g/text/gstr"
|
||
"strconv"
|
||
"strings"
|
||
)
|
||
|
||
var (
|
||
// 参考：http://php.net/manual/zh/function.date.php
|
||
formats = map[byte]string{
|
||
// ================== 日 ==================
|
||
'd': "02", // 月份中的第几天，有前导零的 2 位数字(01 到 31)
|
||
'D': "Mon", // 星期中的第几天，文本表示，3 个字母(Mon 到 Sun)
|
||
'w': "Monday", // 星期中的第几天，数字型式的文本表示 0为星期天 6为星期六
|
||
'N': "Monday", // ISO-8601 格式数字表示的星期中的第几天 1（表示星期一）到 7（表示星期天）
|
||
'j': "=j=02", // 月份中的第几天，没有前导零(1 到 31)
|
||
'S': "02", // 每月天数后面的英文后缀，2 个字符 st，nd，rd 或者 th。可以和 j 一起用
|
||
'l': "Monday", // ("L"的小写字母)星期几，完整的文本格式(Sunday 到 Saturday)
|
||
'z': "", // 年份中的第几天 0到365
|
||
|
||
// ================== 日 ==================
|
||
'W': "", // ISO-8601 格式年份中的第几周，每周从星期一开始 例如：42（当年的第 42 周）
|
||
|
||
// ================== 月 ==================
|
||
'F': "January", // 月份，完整的文本格式，例如 January 或者 March January 到 December
|
||
'm': "01", // 数字表示的月份，有前导零(01 到 12)
|
||
'M': "Jan", // 三个字母缩写表示的月份(Jan 到 Dec)
|
||
'n': "1", // 数字表示的月份，没有前导零(1 到 12)
|
||
't': "", // 指定的月份有几天 28到31
|
||
|
||
// ================== 年 ==================
|
||
'Y': "2006", // 4 位数字完整表示的年份, 例如：1999 或 2003
|
||
'y': "06", // 2 位数字表示的年份, 例如：99 或 03
|
||
|
||
// ================== 时间 ==================
|
||
'a': "pm", // 小写的上午和下午值 am 或 pm
|
||
'A': "PM", // 大写的上午和下午值 AM 或 PM
|
||
'g': "3", // 小时，12 小时格式，没有前导零, 1 到 12
|
||
'G': "=G=15", // 小时，24 小时格式，没有前导零, 0 到 23
|
||
'h': "03", // 小时，12 小时格式，有前导零, 01 到 12
|
||
'H': "15", // 小时，24 小时格式，有前导零, 00 到 23
|
||
'i': "04", // 有前导零的分钟数, 00 到 59
|
||
's': "05", // 秒数，有前导零, 00 到 59
|
||
'u': "=u=.000", // 毫秒(3位)
|
||
'U': "", // 将时间格式化为Unix时间，即从时间点January 1, 1970 UTC到时间点t所经过的时间（单位秒）
|
||
|
||
// ================== 时区 ==================
|
||
'O': "-0700", // 与UTC相差的小时数, 例如：+0200
|
||
'P': "-07:00", // 与UTC的差别，小时和分钟之间有冒号分隔, 例如：+02:00
|
||
'T': "MST", // 时区缩写, 例如: UTC, EST, MDT
|
||
|
||
// ================== 完整的日期／时间 ==================
|
||
'c': "2006-01-02T15:04:05-07:00", // ISO 8601 格式的日期，例如：2004-02-12T15:19:21+00:00
|
||
'r': "Mon, 02 Jan 06 15:04 MST", // RFC 822 格式的日期，例如：Thu, 21 Dec 2000 16:01:07 +0200
|
||
}
|
||
|
||
// 星期的英文值和数字值对应map
|
||
weekMap = map[string]string{
|
||
"Sunday": "0",
|
||
"Monday": "1",
|
||
"Tuesday": "2",
|
||
"Wednesday": "3",
|
||
"Thursday": "4",
|
||
"Friday": "5",
|
||
"Saturday": "6",
|
||
}
|
||
|
||
// 每个月累计的天数 不含润年的时候
|
||
dayOfMonth = []int{0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334}
|
||
)
|
||
|
||
// 使用自定义日期格式格式化输出日期。
|
||
func (t *Time) Format(format string) string {
|
||
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)
|
||
// 有几个转换的符号需要特殊处理
|
||
switch runes[i] {
|
||
case 'j':
|
||
buffer.WriteString(gstr.ReplaceByArray(result, []string{"=j=0", "", "=j=", ""}))
|
||
case 'G':
|
||
buffer.WriteString(gstr.ReplaceByArray(result, []string{"=G=0", "", "=G=", ""}))
|
||
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()
|
||
}
|
||
|
||
// 通过自定义格式转换当前日期为新的日期。
|
||
func (t *Time) FormatTo(format string) *Time {
|
||
t.Time = NewFromStr(t.Format(format)).Time
|
||
return t
|
||
}
|
||
|
||
// 使用标准库格式格式化输出日期。
|
||
func (t *Time) Layout(layout string) string {
|
||
return t.Time.Format(layout)
|
||
}
|
||
|
||
// 通过标准库格式转换当前日期为新的日期。
|
||
func (t *Time) LayoutTo(layout string) *Time {
|
||
t.Time = NewFromStr(t.Layout(layout)).Time
|
||
return t
|
||
}
|
||
|
||
// 返回是否是润年
|
||
func (t *Time) IsLeapYear() bool {
|
||
year := t.Year()
|
||
if (year%4 == 0 && year%100 != 0) || year%400 == 0 {
|
||
return true
|
||
}
|
||
return false
|
||
}
|
||
|
||
// 返回一个时间点在当年中是第几天 0到365 有润年情况
|
||
func (t *Time) DayOfYear() int {
|
||
month := int(t.Month())
|
||
day := t.Day()
|
||
|
||
// 判断是否润年
|
||
if t.IsLeapYear() {
|
||
if month > 2 {
|
||
return dayOfMonth[month-1] + day
|
||
}
|
||
return dayOfMonth[month-1] + day - 1
|
||
}
|
||
return dayOfMonth[month-1] + day - 1
|
||
}
|
||
|
||
// 一个时间点所在的月最长有多少天 28至31
|
||
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
|
||
}
|
||
|
||
// 只剩下第二月份,润年29天
|
||
if t.IsLeapYear() {
|
||
return 29
|
||
}
|
||
return 28
|
||
}
|
||
|
||
// 获取时间点在本年内是第多少周
|
||
func (t *Time) WeeksOfYear() int {
|
||
_, week := t.ISOWeek()
|
||
return week
|
||
}
|
||
|
||
// 将自定义的格式转换为标准库时间格式
|
||
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 {
|
||
// 有几个转换的符号需要特殊处理
|
||
switch format[i] {
|
||
case 'j':
|
||
b.WriteString("02")
|
||
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()
|
||
}
|
||
|
||
// 将format格式转换为正则表达式规则
|
||
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)
|
||
return s
|
||
}
|
||
|
||
// 每月天数后面的英文后缀，2 个字符st nd，rd 或者 th
|
||
func formatMonthDaySuffixMap(day string) string {
|
||
switch day {
|
||
case "01":
|
||
return "st"
|
||
case "02":
|
||
return "nd"
|
||
case "03":
|
||
return "rd"
|
||
default:
|
||
return "th"
|
||
}
|
||
}
|