Go每日一庫之dateparse處理時間

第Go每日一庫之dateparse處理時間目錄簡介

快速使用

格式

時區(qū)

cli

總結(jié)

參考

簡介

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

快速使用

本文代碼使用GoModules。

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

$mkdirdateparsecddateparse

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

安裝dateparse庫：

$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()方法接受一個日期時間字符串，解析該字符串，返回time.Time類型的值。如果傳入的字符串dateparse庫無法識別，則返回一個錯誤。上面程序運行輸出：

$gorunmain.go

2014-03-0100:00:00

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

exitstatus1

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

funcmain(){

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

iferr!=nil{

log.Fatal(err)

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

運行：

$gorunmain.go

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

exitstatus1

格式

dateparse支持豐富的日期時間格式，基本囊括了所有常用的格式。它支持標準庫time中預定義的所有格式：

//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。

時區(qū)

dateparse支持在特定時區(qū)解析日期時間字符串。我們可以通過調(diào)用標準庫的time.LoadLocation()方法，傳入時區(qū)標識字符串來獲得時區(qū)對象。時區(qū)標識字符串是類似Asia/Shanghai，America/Chicago這樣的格式，它表示一個具體的時區(qū)，前者上海，后者洛杉磯。調(diào)用dateparse.ParseIn()方法傳入時區(qū)對象，在指定時區(qū)中解析。time包中還預定義了兩個時區(qū)對象，time.Local表示本地時區(qū)，time.UTC表示UTC時區(qū)。時區(qū)的權(quán)威數(shù)據(jù)請看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"))

運行：

$gorunmain.go

2025-06-2504:50:30

2025-06-2415:50:30

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

cli

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

$goinstall/araddon/dateparse/dateparse

默認會安裝在$GOPATH路徑下，我習慣上把$GOPATH/bin放到$PATH中。所以dateparse命令可以直接使用。

dateparse命令接收一個字符串，和一個可選的時區(qū)選項：

$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|

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

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

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

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

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

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

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