「有问必答」Go如何优雅的对时间进行格式化?

简介: 「有问必答」Go如何优雅的对时间进行格式化?

一番讨论

昨天 交流群 关于「Go如何优雅的对时间进行格式化?」展开了讨论:

image.png

image.png

咋搞捏?

如何在不循环的情况下,把列表数据结构体的时间修改为咱们习惯的格式,而不是UTC模式

我们要实现的效果如下:

  • created_at 是go语言原生的方式,
  • updated_at 是我们期望优化成的方式
{
    "code": 200,
    "data": {
        "count": 12,
        "info": [
            {
                "created_at": "2021-03-17T07:11:24+08:00" //原生方式
                "updated_at": "2021-03-17 07:11:24",  //需要优化成这种
            }
        ]
    },
    "message": "成功"
}

引入神器

  1. 首先我们引入一个包,在控制台运行
go get github.com/liamylian/jsontime
  1. 下载相关依赖
go mod download
  1. 修改结构体,声明要处理时间的字段
type Order struct {
    .
    .
    .
  CreatedAt       time.Time `json:"created_at" time_format:"sql_datetime" time_utc:"false"`       // 格式化时间示例
  UpdatedAt       string  `json:"updated_at"`       // 原生状态示例
}
  1. 取值时调用MarshalToString把结构体数据转为字符串
  2. 但是转完的字符串存在反斜线的问题,使用json.RawMessage()处理一下
var timeJson = jsontime.ConfigWithCustomTimeFormat
func AllOrder(c *gin.Context) {
  limitStr := c.DefaultQuery("limit", "10")
  pageStr := c.DefaultQuery("page", "0")
  orderType := c.DefaultQuery("orderType", "desc")
  orderField := c.DefaultQuery("orderField", "id")
  orderSql := orderField + " " + orderType
  limit, _ := strconv.Atoi(limitStr)
  page, _ := strconv.Atoi(pageStr)
  count, res := model.QueryOrder(0, limit, page, orderSql)
  //处理1:MarshalToString
  bytes, _ := timeJson.MarshalToString(&res)
  jsonInfo := map[string]interface{}{
    "count": count,
    //处理2:解决反斜线的问题
    "info":  json.RawMessage(bytes), 
  }
  c.JSON(http.StatusOK, ReturnJson{
    http.StatusOK,
    jsonInfo,
    "成功",
  })
}

我们最终实现出来的效果

{
    "code": 200,
    "data": {
        "count": 12,
        "info": [
            {
                "updated_at": "2021-03-17 07:13:24",
                "created_at": "2021-03-17 07:11:24",  
            }
        ]
    },
    "message": "成功"
}

好了,通过引入上面的神器就解决了我们的问题。

我们再深入理解一下time包的使用:

time包

time包提供了时间的显示和测量用的函数。日历的计算采用的是公历。

时间类型

time.Time类型表示时间。我们可以通过time.Now()函数获取当前的时间对象,然后获取时间对象的年月日时分秒等信息。示例代码如下:

func timeDemo() {
  now := time.Now() //获取当前时间
  fmt.Printf("current time:%v\n", now)
  year := now.Year()     //年
  month := now.Month()   //月
  day := now.Day()       //日
  hour := now.Hour()     //小时
  minute := now.Minute() //分钟
  second := now.Second() //秒
  fmt.Printf("%d-%02d-%02d %02d:%02d:%02d\n", year, month, day, hour, minute, second)
}

时间戳

时间戳是自1970年1月1日(08:00:00GMT)至当前时间的总毫秒数。它也被称为Unix时间戳(UnixTimestamp)。

基于时间对象获取时间戳的示例代码如下:

func timestampDemo() {
  now := time.Now()            //获取当前时间
  timestamp1 := now.Unix()     //时间戳
  timestamp2 := now.UnixNano() //纳秒时间戳
  fmt.Printf("current timestamp1:%v\n", timestamp1)
  fmt.Printf("current timestamp2:%v\n", timestamp2)
}

使用time.Unix()函数可以将时间戳转为时间格式。

func timestampDemo2(timestamp int64) {
  timeObj := time.Unix(timestamp, 0) //将时间戳转为时间格式
  fmt.Println(timeObj)
  year := timeObj.Year()     //年
  month := timeObj.Month()   //月
  day := timeObj.Day()       //日
  hour := timeObj.Hour()     //小时
  minute := timeObj.Minute() //分钟
  second := timeObj.Second() //秒
  fmt.Printf("%d-%02d-%02d %02d:%02d:%02d\n", year, month, day, hour, minute, second)
}

时间间隔

time.Duration是time包定义的一个类型,它代表两个时间点之间经过的时间,以纳秒为单位。time.Duration表示一段时间间隔,可表示的最长时间段大约290年。

time包中定义的时间间隔类型的常量如下:

const (
    Nanosecond  Duration = 1
    Microsecond          = 1000 * Nanosecond
    Millisecond          = 1000 * Microsecond
    Second               = 1000 * Millisecond
    Minute               = 60 * Second
    Hour                 = 60 * Minute
)

例如:time.Duration表示1纳秒,time.Second表示1秒。

时间操作

Add 我们在日常的编码过程中可能会遇到要求时间+时间间隔的需求,Go语言的时间对象有提供Add方法如下:

func (t Time) Add(d Duration) Time 举个例子,求一个小时之后的时间:

func main() {
  now := time.Now()
  later := now.Add(time.Hour) // 当前时间加1小时后的时间
  fmt.Println(later)
}

Sub

求两个时间之间的差值:

func (t Time) Sub(u Time) Duration

返回一个时间段t-u。如果结果超出了Duration可以表示的最大值/最小值,将返回最大值/最小值。要获取时间点t-d(d为Duration),可以使用t.Add(-d)。

Equal

func (t Time) Equal(u Time) bool

判断两个时间是否相同,会考虑时区的影响,因此不同时区标准的时间也可以正确比较。本方法和用t==u不同,这种方法还会比较地点和时区信息。

Before

func (t Time) Before(u Time) bool

如果t代表的时间点在u之前,返回真;否则返回假。

After

func (t Time) After(u Time) bool

如果t代表的时间点在u之后,返回真;否则返回假。

定时器

使用time.Tick(时间间隔)来设置定时器,定时器的本质上是一个通道(channel)。

func tickDemo() {
  ticker := time.Tick(time.Second) //定义一个1秒间隔的定时器
  for i := range ticker {
    fmt.Println(i)//每秒都会执行的任务
  }
}

时间格式化

时间类型有一个自带的方法Format进行格式化,需要注意的是Go语言中格式化时间模板不是常见的Y-m-d H:M:S而是使用Go的诞生时间2006年1月2号15点04分(记忆口诀为2006 1 2 3 4)。

也许这就是技术人员的浪漫吧~(当然,也有人说这事瞎搞~)

补充:如果想格式化为12小时方式,需指定PM。

func formatDemo() {
  now := time.Now()
  // 格式化的模板为Go的出生时间2006年1月2号15点04分 Mon Jan
  // 24小时制
  fmt.Println(now.Format("2006-01-02 15:04:05.000 Mon Jan"))
  // 12小时制
  fmt.Println(now.Format("2006-01-02 03:04:05.000 PM Mon Jan"))
  fmt.Println(now.Format("2006/01/02 15:04"))
  fmt.Println(now.Format("15:04 2006/01/02"))
  fmt.Println(now.Format("2006/01/02"))
}

解析字符串格式的时间

now := time.Now()
fmt.Println(now)
// 加载时区
loc, err := time.LoadLocation("Asia/Shanghai")
if err != nil {
  fmt.Println(err)
  return
}
// 按照指定时区和指定格式解析字符串时间
timeObj, err := time.ParseInLocation("2006/01/02 15:04:05", "2019/08/04 14:15:20", loc)
if err != nil {
  fmt.Println(err)
  return
}
fmt.Println(timeObj)
fmt.Println(timeObj.Sub(now))


相关文章
|
5月前
|
Go
go fmt包格式化
go fmt包格式化
53 0
|
2月前
|
Go
Go - time.RFC3339 时间格式化
Go - time.RFC3339 时间格式化
43 7
|
2月前
|
人工智能 Go
go 中如何格式化时间
go 中如何格式化时间
29 0
|
3月前
|
存储 Go
go语言中fmt格式化包和内置函数汇总
【7月更文挑战第10天】本文介绍fmt包和`Errorf`用于创建格式化的错误消息。`fmt`包还涉及一些接口,如`Formatter`、`GoStringer`、`ScanState`、`Scanner`和`Stringer`,支持自定义格式化和输入/输出处理。
48 1
|
3月前
|
Go
go语言中格式化输出的占位符
【7月更文挑战第10天】`fmt` 包在 Go 语言中用于格式化输出,包括不同类型的占位符:%v(默认格式)、%+v(带字段名的结构体)、%#v(Go语法表示)、%T(类型表示)、%%(百分号)。布尔值用%t,整数有%b、%c、%d、%o、%q、%x、%X和%U。浮点数和复数用%b、%e、%E、%f、%g、%G。字符串和字节切片用%s、%q、%x、%X。指针用%p。占位符可配合+、-、#、空格和0进行调整。宽度和精度控制输出格式,例如 %.4g 控制小数精度。Go 没有 `%u`,但无符号整数默认打印为正数。运算符包括逻辑、比较、加减、乘除、移位、按位和按位异或等。
47 1
|
4月前
|
程序员 Go
【Go语言精进之路】Go语言fmt包深度探索:格式化输入输出的利器
【Go语言精进之路】Go语言fmt包深度探索:格式化输入输出的利器
80 3
|
5月前
|
自然语言处理 IDE Go
高效Go编程之格式化+代码注释+命名+分号+控制结构
【2月更文挑战第6天】高效Go编程之格式化+代码注释+命名+分号+控制结构
58 0
|
5月前
|
Go
Go 语言 Printf 函数和格式化动词详解
Printf() 函数可以使用多种格式化动词对输出进行格式化。下面是可以与所有数据类型一起使用的一些通用格式化动词: 以下动词适用于所有数据类型:
114 0
|
Go
go fmt包格式化
go fmt包格式化
57 0
Go 编程 | 连载 08 - 格式化输入输出
Go 编程 | 连载 08 - 格式化输入输出
Go 编程 | 连载 08 - 格式化输入输出