Go每日一庫(kù)之dateparse處理時(shí)間

第Go每日一庫(kù)之dateparse處理時(shí)間目錄簡(jiǎn)介

快速使用

格式

時(shí)區(qū)

cli

總結(jié)

參考

簡(jiǎn)介

不管什么時(shí)候，處理時(shí)間總是讓人頭疼的一件事情。因?yàn)闀r(shí)間格式太多樣化了，再加上時(shí)區(qū)，夏令時(shí)，閏秒這些細(xì)枝末節(jié)處理起來(lái)更是困難。所以在程序中，涉及時(shí)間的處理我們一般借助于標(biāo)準(zhǔn)庫(kù)或第三方提供的時(shí)間庫(kù)。今天要介紹的dateparse專(zhuān)注于一個(gè)很小的時(shí)間處理領(lǐng)域——解析日期時(shí)間格式的字符串。

快速使用

本文代碼使用GoModules。

創(chuàng)建目錄并初始化：

$mkdirdateparsecddateparse

$gomodinit/darjun/go-daily-lib/dateparse

安裝dateparse庫(kù)：

$goget-u/araddon/dateparse

使用：

packagemain

import(

"fmt"

"log"

"/araddon/dateparse"

funcmain(){

t1,err:=dateparse.ParseAny("3/1/2014")

iferr!=nil{

log.Fatal(err)

fmt.Println(t1.Format("2006-01-0215:04:05"))

t2,err:=dateparse.ParseAny("mm/dd/yyyy")

iferr!=nil{

log.Fatal(err)

fmt.Println(t2.Format("2006-01-0215:04:05"))

ParseAny()方法接受一個(gè)日期時(shí)間字符串，解析該字符串，返回time.Time類(lèi)型的值。如果傳入的字符串dateparse庫(kù)無(wú)法識(shí)別，則返回一個(gè)錯(cuò)誤。上面程序運(yùn)行輸出：

$gorunmain.go

2014-03-0100:00:00

2025/06/2414:52:39Couldnotfindformatfor"mm/dd/yyyy"

exitstatus1

需要注意，當(dāng)我們寫(xiě)出"3/1/2014"這個(gè)時(shí)間的時(shí)候，可以解釋為2014年3月1日，也可以解釋為2014年1月3日。這就存在二義性，dateparse默認(rèn)采用mm/dd/yyyy這種格式，也就是2014年3月1日。我們也可以使用ParseStrict()函數(shù)讓這種具有二義性的字符串解析失敗：

funcmain(){

t,err:=dateparse.ParseStrict("3/1/2014")

iferr!=nil{

log.Fatal(err)

fmt.Println(t.Format("2006-01-0215:04:05"))

運(yùn)行：

$gorunmain.go

2025/06/2414:57:18Thisdatehasambiguousmm/ddvsdd/mmtypeformat

exitstatus1

格式

dateparse支持豐富的日期時(shí)間格式，基本囊括了所有常用的格式。它支持標(biāo)準(zhǔn)庫(kù)time中預(yù)定義的所有格式：

//src/time/format.go

const(

ANSIC="MonJan_215:04:052006"

UnixDate="MonJan_215:04:05MST2006"

RubyDate="MonJan0215:04:05-07002006"

RFC822="02Jan0615:04MST"

RFC822Z="02Jan0615:04-0700"http://RFC822withnumericzone

RFC850="Monday,02-Jan-0615:04:05MST"

RFC1123="Mon,02Jan200615:04:05MST"

RFC1123Z="Mon,02Jan200615:04:05-0700"http://RFC1123withnumericzone

RFC3339="2006-01-02T15:04:05Z07:00"

RFC3339Nano="2006-01-02T15:04:05.999999999Z07:00"

Kitchen="3:04PM"

//Handytimestamps.

Stamp="Jan_215:04:05"

StampMilli="Jan_215:04:05.000"

StampMicro="Jan_215:04:05.000000"

StampNano="Jan_215:04:05.000000000"

)

支持的完整格式查看dateparseREADME。

時(shí)區(qū)

dateparse支持在特定時(shí)區(qū)解析日期時(shí)間字符串。我們可以通過(guò)調(diào)用標(biāo)準(zhǔn)庫(kù)的time.LoadLocation()方法，傳入時(shí)區(qū)標(biāo)識(shí)字符串來(lái)獲得時(shí)區(qū)對(duì)象。時(shí)區(qū)標(biāo)識(shí)字符串是類(lèi)似Asia/Shanghai，America/Chicago這樣的格式，它表示一個(gè)具體的時(shí)區(qū)，前者上海，后者洛杉磯。調(diào)用dateparse.ParseIn()方法傳入時(shí)區(qū)對(duì)象，在指定時(shí)區(qū)中解析。time包中還預(yù)定義了兩個(gè)時(shí)區(qū)對(duì)象，time.Local表示本地時(shí)區(qū)，time.UTC表示UTC時(shí)區(qū)。時(shí)區(qū)的權(quán)威數(shù)據(jù)請(qǐng)看IANA。

funcmain(){

tz1,_:=time.LoadLocation("America/Chicago")

t1,_:=dateparse.ParseIn("2025-06-2415:50:30",tz1)

fmt.Println(t1.Local().Format("2006-01-0215:04:05"))

t2,_:=dateparse.ParseIn("2025-06-2415:50:30",time.Local)

fmt.Println(t2.Local().Format("2006-01-0215:04:05"))

運(yùn)行：

$gorunmain.go

2025-06-2504:50:30

2025-06-2415:50:30

美國(guó)洛杉磯時(shí)區(qū)的"2025年6月24日15時(shí)30分30秒"等于本地時(shí)區(qū)（北京時(shí)間）的"2025年6月25日04時(shí)50分30秒"。

cli

dateparse還提供了一個(gè)命令行工具，用于極快地查看日期時(shí)間格式。安裝：

$goinstall/araddon/dateparse/dateparse

默認(rèn)會(huì)安裝在$GOPATH路徑下，我習(xí)慣上把$GOPATH/bin放到$PATH中。所以dateparse命令可以直接使用。

dateparse命令接收一個(gè)字符串，和一個(gè)可選的時(shí)區(qū)選項(xiàng)：

$dateparse--timezone="Asia/Shanghai""2025-06-2406:46:08"

YourCurrenttime.LocalzoneisCST

LayoutString:dateparse.ParseFormat()=2006-01-0215:04:05

YourUsingtime.Localsettolocation=Asia/ShanghaiCST

+-------------+---------------------------+-------------------------------+-------------------------------------+

|method|ZoneSource|Parsed|Parsed:t.In(time.UTC)|

+-------------+---------------------------+-------------------------------+-------------------------------------+

|ParseAny|time.Local=nil|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTCday=4|

|ParseAny|time.Local=timezonearg|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTCday=4|

|ParseAny|time.Local=time.UTC|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTCday=4|

|ParseIn|time.Local=nil|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTC|

|ParseIn|time.Local=timezonearg|2025-06-2406:46:08+0800CST|2025-06-2322:46:08+0000UTC|

|ParseIn|time.Local=time.UTC|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTC|

|ParseLocal|time.Local=nil|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTC|

|ParseLocal|time.Local=timezonearg|2025-06-2406:46:08+0800CST|2025-06-2322:46:08+0000UTC|

|ParseLocal|time.Local=time.UTC|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTC|

|ParseStrict|time.Local=nil|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTC|

|ParseStrict|time.Local=timezonearg|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTC|

|ParseStrict|time.Local=time.UTC|2025-06-2406:46:08+0000UTC|2025-06-2406:46:08+0000UTC|

+-------------+---------------------------+-------------------------------+-------------------------------------+

輸出當(dāng)前本地時(shí)區(qū)，格式字符串（可用于生成同樣格式的日期時(shí)間字符串）和一個(gè)表格。表格里面的數(shù)據(jù)是分別對(duì)ParseAny/ParseIn/ParseLocal/ParseStrict在不同的時(shí)區(qū)下調(diào)用的結(jié)果。

method列表示調(diào)用的方法，ZoneSource列表示將本地時(shí)區(qū)設(shè)置的值，Parsed列是以日期時(shí)間字符串調(diào)用ParseAny()返回的time.Time對(duì)象的Format()方法調(diào)用結(jié)果，Parsed:t.In(time.UTC)列在返回的time.Time對(duì)象調(diào)用Format()方法前將其轉(zhuǎn)為UTC時(shí)間。

由于ParseAny/ParseStrict不會(huì)考慮本地時(shí)區(qū)，都是在UTC下解析字符串，所以這6行的最后兩列結(jié)果都一樣。

ParseIn的第二行，將time.Local設(shè)置為我們通過(guò)命令行選項(xiàng)設(shè)置的時(shí)區(qū)，上面我設(shè)置為Asia/Shanghai，對(duì)應(yīng)的UTC時(shí)間相差8小時(shí)。ParseLocal也是如此。

下面是dateparse命令行的部分源碼，可以對(duì)照查看：

funcmain(){

parsers:=map[string]parser{

"ParseAny":parseAny,

"ParseIn":parseIn,

"ParseLocal":parseLocal,

"ParseStrict":parseStrict,

forname,parser:=rangeparsers{

time.Local=nil

table.AddRow(name,"time.Local=nil",parser(datestr,nil,false),parser(datestr,nil,true))

iftimezone!=""{

time.Local=loc

table.AddRow(name,"time.Local=timezonearg",parser(datestr,loc,false),parser(datestr,loc,true))

time.Local=time.UTC

table.AddRow(name,"time.Local=time.UTC",parser(datestr,time.UTC,false),parser(datestr,time.UTC,true))

funcparseIn(datest