Go每日一库之dateparse处理时间
简介
不管什么时候，处理时间总是让人头疼的一件事情。因为时间格式太多样化了，再加上时区，夏令时，闰秒这些细枝末节处理起来更是困难。所以在程序中，涉及时间的处理我们一般借助于标准库或第三方提供的时间库。今天要介绍的dateparse专注于一个很小的时间处理领域——解析日期时间格式的字符串。
快速使用
本文代码使用 Go Modules。
创建目录并初始化：
$ mkdir dateparse && cd dateparse $ go mod init github.com/darjun/go-daily-lib/dateparse
安装dateparse库：
$ 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()方法接受一个日期时间字符串，解析该字符串，返回time.Time类型的值。如果传入的字符串dateparse库无法识别，则返回一个错误。上面程序运行输出：
$ 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
需要注意，当我们写出"3/1/2014"这个时间的时候，可以解释为2014年3月1日，也可以解释为2014年1月3日。这就存在二义性，dateparse默认采用mm/dd/yyyy这种格式，也就是2014年3月1日。我们也可以使用ParseStrict()函数让这种具有二义性的字符串解析失败：
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"))
}
运行：
$ 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支持丰富的日期时间格式，基本囊括了所有常用的格式。它支持标准库time中预定义的所有格式：
// 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。
时区
dateparse支持在特定时区解析日期时间字符串。我们可以通过调用标准库的time.LoadLocation()方法，传入时区标识字符串来获得时区对象。时区标识字符串是类似Asia/Shanghai，America/Chicago这样的格式，它表示一个具体的时区，前者上海，后者洛杉矶。调用dateparse.ParseIn()方法传入时区对象，在指定时区中解析。time包中还预定义了两个时区对象，time.Local表示本地时区，time.UTC表示 UTC 时区。时区的权威数据请看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"))
}
运行：
$ go run main.go
2021-06-25 04:50:30
2021-06-24 15:50:30
美国洛杉矶时区的"2021年6月24日 15时30分30秒"等于本地时区（北京时间）的"2021年6月25日 04时50分30秒"。
cli
dateparse还提供了一个命令行工具，用于极快地查看日期时间格式。安装：
$ go install github.com/araddon/dateparse/dateparse
默认会安装在$GOPATH路径下，我习惯上把$GOPATH/bin放到$PATH中。所以dateparse命令可以直接使用。
dateparse命令接收一个字符串，和一个可选的时区选项：
$ 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 | +-------------+---------------------------+-------------------------------+-------------------------------------+
输出当前本地时区，格式字符串（可用于生成同样格式的日期时间字符串）和一个表格。表格里面的数据是分别对ParseAny/ParseIn/ParseLocal/ParseStrict在不同的时区下调用的结果。
method列表示调用的方法，Zone Source列表示将本地时区设置的值，Parsed列是以日期时间字符串调用ParseAny()返回的time.Time对象的Format()方法调用结果，Parsed: t.In(time.UTC)列在返回的time.Time对象调用Format()方法前将其转为 UTC 时间。
由于ParseAny/ParseStrict不会考虑本地时区，都是在 UTC 下解析字符串，所以这 6 行的最后两列结果都一样。
ParseIn的第二行，将time.Local设置为我们通过命令行选项设置的时区，上面我设置为Asia/Shanghai，对应的 UTC 时间相差 8 小时。ParseLocal也是如此。
下面是dateparse命令行的部分源码，可以对照查看：
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()
}
注意输出的本地时区为 CST，它可以代表不同的时区：
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 可以同时表示美国、澳大利亚、中国和古巴四个国家的标准时间。
总结
使用dateparse可以很方便地从日期时间字符串中解析出时间对象和格式（layout）。同时dateparse命令行可以快速的查看和转换相应时区的时间，是一个非常不错的小工具。
大家如果发现好玩、好用的 Go 语言库，欢迎到 Go 每日一库 GitHub 上提交 issue😄
参考
dateparse GitHub：https://github.com/araddon/dateparse
Go 每日一库 GitHub：https://github.com/darjun/go-daily-lib
到此这篇关于Go每日一库之dateparse处理时间的文章就介绍到这了,更多相关Go dateparse处理时间内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
最近接手一个商城运单号模块，接手后发现有部分运单号返回给前端是按照科学计数法的方式返回，本文就介绍一下Golang科学计数法转换string数字输出，感兴趣的可以了解一下2021-07-07
这篇文章主要为大家介绍了Go语言基础map的用法及示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2021-11-11
作为最常用的分布式缓存中间件——Redis,了解运作原理和如何使用是十分有必要的,今天来学习如何通过Go来操作Redis实现基本的读写操作,需要的朋友可以参考下2023-09-09
刚开始接触go就遇到了一个内存问题,在进行内存分析的时候发现了一下比较好的工具,在此留下记录,下面这篇文章主要给大家介绍了关于go性能分析工具pprof的性能测试,需要的朋友可以参考下2023-04-04
插入排序是一种简单的排序算法。这篇文章将利用Go语言实现冒泡排序算法，文中的示例代码讲解详细，对学习Go语言有一定的帮助，需要的可以参考一下2022-12-12
go允许定义多个init(),多个init()会涉及到执行先后的问题,本文将详细讲解Go中init()执行顺序，感兴趣的朋友一起看看吧2022-09-09
这篇文章主要给大家介绍了关于特殊字符的json序列化的相关资料，通过示例代码分别给大家介绍了关于python 、 rust 、 java 和golang对特殊字符的json序列化操作，需要的朋友可以参考借鉴，下面来一起学习学习吧2018-09-09
这篇文章主要介绍了Golang实现web文件共享服务的示例代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2018-10-10
Golang执行go get私有库提示"410 Gone" 的问题及解决办法
这篇文章主要介绍了Golang执行go get私有库提示”410 Gone“ 解决办法,本文给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下2020-02-02
如果大家系统的学过C++、Java等语言以及面向对象的话，相信应该对多态不会陌生。多态是面向对象范畴当中经常使用并且非常好用的一个功能，它主要是用在强类型语言当中，像是Python这样的弱类型语言，变量的类型可以随意变化，也没有任何限制，其实区别不是很大2021-06-06
最新评论