Go time包AddDate使用解惑实例详解

 更新时间:2022年09月20日 16:17:25   作者:Mr_houzi  
这篇文章主要为大家介绍了Go time包AddDate使用解惑实例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

我们经常会使用 Go time 包 AddDate(),对日期进行计算。而它得到的结果,可能会往往超出我们的“预期”。(为什么预期要打引号,因为我们的预期可能是模糊、偏差的)。

引例

假设,今天是10月31日,是10月的最后一天,我们想通过 AddDate()计算下个月的最后一天。

today := time.Date(2022, 10, 31, 0, 0, 0, 0, time.Local)
nextDay := today.AddDate(0, 1, 0)
fmt.Println(nextDay.Format("20060102"))
// 输出:20221201

结果输出:20221201,而非我们预期的下个月最后一天11月30日。

Go Time 包中是这么处理的

  • AddDate() 对月份+1,即变成了11-31,换算成对应的天数、最终换算成对应的纳秒数存储在 Time 对象中;
  • 输出时,Format()将输出标准的日期,Time 中的纳秒会转为 12-01,而不是 11-31,因为这天并不存在;

只要是涉及到大小月的最后一天都会出现这个问题。

today := time.Date(2022, 3, 31, 0, 0, 0, 0, time.Local)
d := today.AddDate(0, -1, 0)
fmt.Println(d.Format("20060102"))
// 20220303
today := time.Date(2022, 3, 31, 0, 0, 0, 0, time.Local)
d := today.AddDate(0, 1, 0)
fmt.Println(d.Format("20060102"))
// 20220501
today := time.Date(2022, 10, 31, 0, 0, 0, 0, time.Local)
d := today.AddDate(0, -1, 0)
fmt.Println(d.Format("20060102"))
// 20221001
today := time.Date(2022, 10, 31, 0, 0, 0, 0, time.Local)
d := today.AddDate(0, 1, 0)
fmt.Println(d.Format("20060102"))
// 20221201

源码分析

看一下 Go Time 包具体源码,仍以开头10-31 + 1 month的例子为用例。
AddDate(),首先对 month+1,然后调用Date()处理。

// time/time.go
func (t Time) AddDate(years int, months int, days int) Time {
    year, month, day := t.Date() // 获取当前年月日
    hour, min, sec := t.Clock() // 获取当前时分秒
    return Date(year+years, month+Month(months), day+days, hour, min, sec, int(t.nsec()), t.Location())
}

Date()中此时传入的参数是

  • year 2020
  • month 11
  • day 31
  • hour、min、sec、nsec 为运行时的时分秒纳秒

d 计算的是绝对纪元到今天之前的天数:

**d = 今年之前的天数 + 年初到当月之前的天数 + 月初到当天之前的天数;**

最终,将 d 转换成纳秒 + 当天经过的纳秒存储在 Time 对象中。

// time/time.go
func Date(year int, month Month, day, hour, min, sec, nsec int, loc *Location) Time {
    ……
    // Compute days since the absolute epoch.
    d := daysSinceEpoch(year)
    // Add in days before this month.
    d += uint64(daysBefore[month-1])
    if isLeap(year) && month >= March {
        d++ // February 29
    }
    // Add in days before today.
    d += uint64(day - 1)
    // Add in time elapsed today.
    abs := d * secondsPerDay
    abs += uint64(hour*secondsPerHour + min*secondsPerMinute + sec)
    ……
    return t
}

对 Date() 输入2022-11-31和输入2022-12-01,将得到同样的 d(天数)。两者底层存储的时候都是一样的数据,Format() 时将2022-11-31的Time 格式化成 2022-12-01也就不例外了,输出当然要显示让人看得懂的常规标准日期嘛。

// 2022-11-31
d = 2022年之前的天数 + 1月到10月的总天数 + 30天
// 2022-12-01
d = 2022年之前的天数 + 1月到11月的总天数 + 0天
  = 2022年之前的天数 + 1月到10月的总天数 + 30天 + 0天

你甚至可以往 Date() 输入非标准日期2022-11-35,它和标准日期 2022-12-05,将得到同样的 d (天数)。
“非标准日期”和“标准日期”就像天平的两边,虽然形式不一样,但他们实际的质量(d 天数)是一样的。记住这句话,后面有用。

预期偏差

我们弄清楚了原理,但仍然不能接受这个结果。这样的结果是 Go 的 bug 吗?还是 Go Time 包偷懒了?

然而并不是,恰恰是我们的“预期”出现了问题。

正常来说,我们预期 10-30 + 1 month是 11-30 日,这很合理。那我们为什么还期待 10-31 + 1 month 也是 11-30 日?仅仅因为 10-31是当前月的最后一天,我们也期待 +1 month 后是下个月的最后一天吗?

10-30 和 10-31 两个日期相差一天,进行同样的 +1 month 操作后,就变成为了同一天。这就像 1 + 10 = 2 + 10 一样的结果,这显然不合理。

Go 目前的处理结果是正确的,并且他在 AddDate() 注释中也注明了会处理“溢出”的情况。况且,不止 Go 语言这么处理,PHP 也是这么处理的,见文章令人困惑的strtotime

怎么解决

道理我都懂,但我就是想获取上/下一个月的最后一天怎么办?

利用前面源码分析阶段,提到的“天平原理”,就能拿到我们想要的结果。

today := time.Date(2022, 10, 31, 0, 0, 0, 0, time.Local)
d := today.Day()
// 上个月最后一天
// 10-00 日 等于 9-30 日
day1 := today.AddDate(0, 0, -d)
fmt.Println(day1.Format("20060102"))
// 下个月最后一天
// 12-00 日 等于 11-30 日
day2 := today.AddDate(0, 2, -d)
fmt.Println(day2.Format("20060102"))
// 20220930
// 20221130

结语

最初,发现这个问题是看鸟哥文章,当时认为那是 PHP 的“坑”,并没有深入思考过。如今,在 Go 语言再次遇到这个问题,重新思考,发现日期函数本应该就那么设计,是我们对日期函数理解不够,产生了错误的“预期”。

以上就是Go time包AddDate使用解惑实例详解的详细内容,更多关于Go time包AddDate的资料请关注脚本之家其它相关文章!

相关文章

  • Golang 正则匹配效率详解

    Golang 正则匹配效率详解

    这篇文章主要介绍了Golang 正则匹配效率详解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-04-04
  • go语言template用法实例

    go语言template用法实例

    这篇文章主要介绍了go语言template用法,实例分析了template的使用技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-02-02
  • Go语言的变量、函数、Socks5代理服务器示例详解

    Go语言的变量、函数、Socks5代理服务器示例详解

    这篇文章主要介绍了Go语言的变量、函数、Socks5代理服务器的相关资料,需要的朋友可以参考下
    2017-09-09
  • 基于Go编写一个可视化Navicat本地密码解析器

    基于Go编写一个可视化Navicat本地密码解析器

    这篇文章主要给大家介绍了基于Go编写一个可视化Navicat本地密码解析器的方法,文中有详细的代码示例和图文介绍,有需要的朋友可以参考阅读本文
    2023-08-08
  • go modules中replace使用方法

    go modules中replace使用方法

    这篇文章主要为大家介绍了go modules中replace使用方法,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-06-06
  • Go语言中Struct与继承与匿名字段和内嵌结构体全面详解

    Go语言中Struct与继承与匿名字段和内嵌结构体全面详解

    这篇文章主要介绍了Go语言中Struct与继承与匿名字段和内嵌结构体,Go语言中通过结构体的内嵌再配合接口比面向对象具有更高的扩展性和灵活性,感兴趣的可以了解一下
    2023-04-04
  • GO实现协程池管理的方法

    GO实现协程池管理的方法

    这篇文章给大家介绍GO实现协程池管理的方法,分别使用channel实现协程池和消费者模式实现协程池,本文通过实例代码给大家介绍的非常详细,需要的朋友参考下吧
    2021-07-07
  • Go语言开发kube-scheduler整体架构深度剖析

    Go语言开发kube-scheduler整体架构深度剖析

    这篇文章主要为大家介绍了Go语言开发kube-scheduler整体架构深度剖析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • Go语言题解LeetCode455分发饼干示例详解

    Go语言题解LeetCode455分发饼干示例详解

    这篇文章主要为大家介绍了Go语言题解LeetCode455分发饼干示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-12-12
  • 源码分析Go语言中gofmt实现原理

    源码分析Go语言中gofmt实现原理

    gofmt 是 Go 语言官方提供的一个工具,用于自动格式化 Go 源代码,使其符合 Go 语言的官方编码风格,本文给大家源码详细分析了Go语言中gofmt实现原理,并通过图文和代码讲解的非常详细,需要的朋友可以参考下
    2024-03-03

最新评论