Go每日一庫(kù)之dateparse處理時(shí)間
簡(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í)間格式的字符串。
快速使用
本文代碼使用 Go Modules。
創(chuàng)建目錄并初始化：
$ mkdir dateparse && cd dateparse $ go mod init github.com/darjun/go-daily-lib/dateparse
安裝dateparse庫(kù)：
$ go get -u github.com/araddon/dateparse
使用：
package main
import (
"fmt"
"log"
"github.com/araddon/dateparse"
)
func main() {
t1, err := dateparse.ParseAny("3/1/2014")
if err != nil {
log.Fatal(err)
}
fmt.Println(t1.Format("2006-01-02 15:04:05"))
t2, err := dateparse.ParseAny("mm/dd/yyyy")
if err != nil {
log.Fatal(err)
}
fmt.Println(t2.Format("2006-01-02 15:04:05"))
}
ParseAny()方法接受一個(gè)日期時(shí)間字符串，解析該字符串，返回time.Time類(lèi)型的值。如果傳入的字符串dateparse庫(kù)無(wú)法識(shí)別，則返回一個(gè)錯(cuò)誤。上面程序運(yùn)行輸出：
$ go run main.go
2014-03-01 00:00:00
2021/06/24 14:52:39 Could not find format for "mm/dd/yyyy"
exit status 1
需要注意，當(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ù)讓這種具有二義性的字符串解析失?。?br />
func main() {
t, err := dateparse.ParseStrict("3/1/2014")
if err != nil {
log.Fatal(err)
}
fmt.Println(t.Format("2006-01-02 15:04:05"))
}
運(yùn)行：
$ go run main.go
2021/06/24 14:57:18 This date has ambiguous mm/dd vs dd/mm type format
exit status 1
格式
dateparse支持豐富的日期時(shí)間格式，基本囊括了所有常用的格式。它支持標(biāo)準(zhǔn)庫(kù)time中預(yù)定義的所有格式：
// src/time/format.go const ( ANSIC = "Mon Jan _2 15:04:05 2006" UnixDate = "Mon Jan _2 15:04:05 MST 2006" RubyDate = "Mon Jan 02 15:04:05 -0700 2006" RFC822 = "02 Jan 06 15:04 MST" RFC822Z = "02 Jan 06 15:04 -0700" // RFC822 with numeric zone RFC850 = "Monday, 02-Jan-06 15:04:05 MST" RFC1123 = "Mon, 02 Jan 2006 15:04:05 MST" RFC1123Z = "Mon, 02 Jan 2006 15:04:05 -0700" // RFC1123 with numeric zone RFC3339 = "2006-01-02T15:04:05Z07:00" RFC3339Nano = "2006-01-02T15:04:05.999999999Z07:00" Kitchen = "3:04PM" // Handy time stamps. Stamp = "Jan _2 15:04:05" StampMilli = "Jan _2 15:04:05.000" StampMicro = "Jan _2 15:04:05.000000" StampNano = "Jan _2 15:04:05.000000000" )
支持的完整格式查看dateparse README。
時(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。
func main() {
tz1, _ := time.LoadLocation("America/Chicago")
t1, _ := dateparse.ParseIn("2021-06-24 15:50:30", tz1)
fmt.Println(t1.Local().Format("2006-01-02 15:04:05"))
t2, _ := dateparse.ParseIn("2021-06-24 15:50:30", time.Local)
fmt.Println(t2.Local().Format("2006-01-02 15:04:05"))
}
運(yùn)行：
$ go run main.go
2021-06-25 04:50:30
2021-06-24 15:50:30
美國(guó)洛杉磯時(shí)區(qū)的"2021年6月24日 15時(shí)30分30秒"等于本地時(shí)區(qū)（北京時(shí)間）的"2021年6月25日 04時(shí)50分30秒"。
cli
dateparse還提供了一個(gè)命令行工具，用于極快地查看日期時(shí)間格式。安裝：
$ go install github.com/araddon/dateparse/dateparse
默認(rèn)會(huì)安裝在$GOPATH路徑下，我習(xí)慣上把$GOPATH/bin放到$PATH中。所以dateparse命令可以直接使用。
dateparse命令接收一個(gè)字符串，和一個(gè)可選的時(shí)區(qū)選項(xiàng)：
$ dateparse --timezone="Asia/Shanghai" "2021-06-24 06:46:08" Your Current time.Local zone is CST Layout String: dateparse.ParseFormat() => 2006-01-02 15:04:05 Your Using time.Local set to location=Asia/Shanghai CST +-------------+---------------------------+-------------------------------+-------------------------------------+ | method | Zone Source | Parsed | Parsed: t.In(time.UTC) | +-------------+---------------------------+-------------------------------+-------------------------------------+ | ParseAny | time.Local = nil | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC day=4 | | ParseAny | time.Local = timezone arg | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC day=4 | | ParseAny | time.Local = time.UTC | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC day=4 | | ParseIn | time.Local = nil | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC | | ParseIn | time.Local = timezone arg | 2021-06-24 06:46:08 +0800 CST | 2021-06-23 22:46:08 +0000 UTC | | ParseIn | time.Local = time.UTC | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC | | ParseLocal | time.Local = nil | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC | | ParseLocal | time.Local = timezone arg | 2021-06-24 06:46:08 +0800 CST | 2021-06-23 22:46:08 +0000 UTC | | ParseLocal | time.Local = time.UTC | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC | | ParseStrict | time.Local = nil | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC | | ParseStrict | time.Local = timezone arg | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC | | ParseStrict | time.Local = time.UTC | 2021-06-24 06:46:08 +0000 UTC | 2021-06-24 06:46:08 +0000 UTC | +-------------+---------------------------+-------------------------------+-------------------------------------+
輸出當(dāng)前本地時(shí)區(qū)，格式字符串（可用于生成同樣格式的日期時(shí)間字符串）和一個(gè)表格。表格里面的數(shù)據(jù)是分別對(duì)ParseAny/ParseIn/ParseLocal/ParseStrict在不同的時(shí)區(qū)下調(diào)用的結(jié)果。
method列表示調(diào)用的方法，Zone Source列表示將本地時(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ì)照查看：
func main() {
parsers := map[string]parser{
"ParseAny": parseAny,
"ParseIn": parseIn,
"ParseLocal": parseLocal,
"ParseStrict": parseStrict,
}
for name, parser := range parsers {
time.Local = nil
table.AddRow(name, "time.Local = nil", parser(datestr, nil, false), parser(datestr, nil, true))
if timezone != "" {
time.Local = loc
table.AddRow(name, "time.Local = timezone arg", 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))
}
}
func parseIn(datestr string, loc *time.Location, utc bool) string {
t, err := dateparse.ParseIn(datestr, loc)
if err != nil {
return err.Error()
}
if utc {
return t.In(time.UTC).String()
}
return t.String()
}
注意輸出的本地時(shí)區(qū)為 CST，它可以代表不同的時(shí)區(qū)：
Central Standard Time (USA) UT-6:00
Central Standard Time (Australia) UT+9:30
China Standard Time UT+8:00
Cuba Standard Time UT-4:00
CST 可以同時(shí)表示美國(guó)、澳大利亞、中國(guó)和古巴四個(gè)國(guó)家的標(biāo)準(zhǔn)時(shí)間。
總結(jié)
使用dateparse可以很方便地從日期時(shí)間字符串中解析出時(shí)間對(duì)象和格式（layout）。同時(shí)dateparse命令行可以快速的查看和轉(zhuǎn)換相應(yīng)時(shí)區(qū)的時(shí)間，是一個(gè)非常不錯(cuò)的小工具。
大家如果發(fā)現(xiàn)好玩、好用的 Go 語(yǔ)言庫(kù)，歡迎到 Go 每日一庫(kù) GitHub 上提交 issue😄
參考
dateparse GitHub：https://github.com/araddon/dateparse
Go 每日一庫(kù) GitHub：https://github.com/darjun/go-daily-lib
到此這篇關(guān)于Go每日一庫(kù)之dateparse處理時(shí)間的文章就介紹到這了,更多相關(guān)Go dateparse處理時(shí)間內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Go語(yǔ)言學(xué)習(xí)之JSON編碼解析與使用
這篇文章主要為大家詳細(xì)介紹了Go語(yǔ)言中JSON編碼的解析與使用已經(jīng)JSON與Map、結(jié)構(gòu)體的互相轉(zhuǎn)化，文中的示例代碼講解詳細(xì)，需要的可以參考一下2023-02-02
這篇文章主要給大家介紹了關(guān)于golang如何利用原始套接字構(gòu)造UDP包的相關(guān)資料，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者使用golang具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來(lái)一起看看吧。2017-10-10
這篇文章主要介紹了淺談GoLang幾種讀文件方式的比較，一般來(lái)說(shuō)常用的有三種。使用Read加上buffer，使用bufio庫(kù)和ioutil 庫(kù)，非常具有實(shí)用價(jià)值，需要的朋友可以參考下2019-01-01
這篇文章給大家介紹了golang獲取用戶(hù)輸入的幾種方式,文中通過(guò)代碼示例給大家講解的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作有一定的幫助,需要的朋友跟著小編一起來(lái)學(xué)習(xí)吧2024-01-01
Go 自定義package包設(shè)置與導(dǎo)入操作
這篇文章主要介紹了Go 自定義package包設(shè)置與導(dǎo)入操作，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2021-05-05
Go語(yǔ)言的 os 包中提供了操作系統(tǒng)函數(shù)的接口，是一個(gè)比較重要的包。顧名思義，os 包的作用主要是在服務(wù)器上進(jìn)行系統(tǒng)的基本操作，本文將詳細(xì)介紹了golang的os包用法,需要的朋友可以參考下2023-05-05
這篇文章主要介紹了詳解如何在Go項(xiàng)目中輸出版本信息，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-01-01
利用Golang實(shí)現(xiàn)對(duì)配置文件加密
在實(shí)際的應(yīng)用中,配置文件通常包含了一些敏感的信息,如數(shù)據(jù)庫(kù)密碼、API密鑰等,為了保護(hù)這些敏感信息不被惡意獲取,我們可以對(duì)配置文件進(jìn)行加密,本文將介紹如何使用Go語(yǔ)言實(shí)現(xiàn)對(duì)配置文件的加密,需要的朋友可以參考下2023-10-10
golang 實(shí)現(xiàn)struct、json、map互相轉(zhuǎn)化
這篇文章主要介紹了golang 實(shí)現(xiàn)struct、json、map互相轉(zhuǎn)化，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-12-12
go語(yǔ)言的指針類(lèi)型和C/C++的指針類(lèi)型用法是一樣的，那么Go語(yǔ)言應(yīng)該什么情況使用指針，本文就詳細(xì)的介紹一下，感興趣的可以了解一下2021-07-07