gtime

通用时间管理模块,封装了常用的时间/日期相关的方法。并支持自定义的日期格式化语法,格式化语法灵感来源于PHPdate函数语法 ( http://php.net/manual/zh/function.date.php )。

gtime的时间格式语法对于熟悉PHP的开发者来说非常友好。

使用方式

  1. import "github.com/gogf/gf/g/os/gtime"

接口文档

https://godoc.org/github.com/gogf/gf/g/os/gtime

时间格式

gtime模块最大的特点是支持自定义的时间格式,以下是支持的时间格式语法列表:

格式 说明 返回值示例
d 月份中的第几天,有前导零的 2 位数字 01 到 31
D 星期中的第几天,文本表示,3 个字母 Mon 到 Sun
N ISO-8601 格式数字表示的星期中的第几天 1(表示星期一)到 7(表示星期天)
j 月份中的第几天,没有前导零 1 到 31
l (“L”的小写字母)星期几,完整的文本格式 Sunday 到 Saturday
S 每月天数后面的英文后缀,2 个字符 st,nd,rd 或者 th。可以和 j 一起用
w 星期中的第几天,数字表示 0(表示星期天)到 6(表示星期六)
z 年份中的第几天 0 到 365
W ISO-8601 格式年份中的第几周,每周从星期一开始 例如:42(当年的第 42 周)
F 月份,完整的文本格式 January 到 December
m 数字表示的月份,有前导零 01 到 12
M 三个字母缩写表示的月份 Jan 到 Dec
n 数字表示的月份,没有前导零 1 到 12
t 指定的月份有几天 28 到 31
Y 4 位数字完整表示的年份 例如:1999 或 2003
y 2 位数字表示的年份 例如:99 或 03
时间
a 小写的上午和下午值 am 或 pm
A 大写的上午和下午值 AM 或 PM
g 小时,12 小时格式,没有前导零 1 到 12
G 小时,24 小时格式,没有前导零 0 到 23
h 小时,12 小时格式,有前导零 01 到 12
H 小时,24 小时格式,有前导零 00 到 23
i 有前导零的分钟数 00 到 59
s 秒数,有前导零 00 到 59
u 毫秒数(3位) 例如:000, 123, 239
U UNIX时间戳(秒) 例如:1559648183
时区
O 与UTC相差的小时数 例如:+0200
P 与UTC的差别,小时和分钟之间有冒号分隔 例如:+02:00
T 时区缩写 例如:UTC,GMT,CST
日期
c ISO 8601 格式的日期 例如:2004-02-12T15:19:21+00:00
r RFC 822 格式的日期 例如:Thu, 21 Dec 2000 16:01:07 +0200