文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

记一次go语言使用time.Duration类型踩过的坑

2024-04-02 19:55

关注

01 踩到的坑

先来说说在项目中踩到的使用time.Duration类型的坑。我们的背景是要做一个延时任务。延时任务就是指将一个任务延迟到一定的时间后再执行,所以就需要根据延时时间计算出该任务要执行的时间。我们这里的延时时间以毫秒为单位,当时我们定义的是500毫秒。即设置了一个全局的变量interval time.Duration。 即interval = 500 * time.Milliseconds。然后就通过以下公式来计算要

执行的时间了:

可执行时间=当前时间+延迟时间可执行时间=当前时间 + 延迟时间可执行时间=当前时间+延迟时间

由以上公式可得到我们的一个任务的可执行时间为 time.Now().UnixMilli() + int64(interval) 。大家看这里有什么问题吗?
问题在于计算的结果值不是在当前的毫秒数上增加了500,而是增加了500000000,多了6个零。这是为什么呢?

02 time.Duration的真实面目

我们从源码中找到答案。我们从time包中看到time.Duration的定义:

// A Duration represents the elapsed time between two instants
// as an int64 nanosecond count. The representation limits the
// largest representable duration to approximately 290 years.
type Duration int64

由源码可知,Duration本质上是一个int64的类型。从注释可知,代表的是两个时间点之间持续的纳秒数 。 所以这里有两点信息 :一是该类型代表的是一段持续时间,二是该类型的基本单位是纳秒。 这里我先重点关注基本单位是纳秒这点。我们再来看几个常量的定义:

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

一个单位的Duration是代表1纳秒。 而time.Micorsecond、time.Millisecond、time.Second、time.Minute、time.Hour的单位实际上都是纳秒。也就是说我们使用到的time.Millisecond实际上是1000000纳秒。所以就有了interval=500*time.Millisecond=500 * 1000000 = 500000000,然后在计算延时后的执行时间时两个单位不一样造成计算出来的值不是预期的增加500毫秒的结果。

03 问题解决

知道了time.Duration类型的基本单位是代表纳秒之后,我们就可以很好的解决了。就是统一单位。
我们也发现,在time包中对于time.Duration类型的对象有转换成秒、毫秒等对应的函数。如下:

所以我们直接获取即可:

可执行时间 := time.Now().UnixMilli() + interval.Millisecond()

04 time.Duration编程实践

上面是我在编码时因为没搞懂time.Duration类型的本质含义猜到的一个坑。那么我们在实际编码时在定义和持续时间有关的变量时应该使用int类型还是time.Duration类型呢?
我的建议是大家尽量用time.Duration类型。为什么呢?第一个原因是和标准库类型统一,不用做过多的转换。因为我们观察可以发现,无论是开源程序,还是go的标准库,凡是和持续时间相关的变量类型都是使用的time.Duration,这样类型统一我们来看几个例子。

示例一:context.WithTimeout

func WithTimeout(parent Context, timeout time.Duration) (Context, CancelFunc) {
    return WithDeadline(parent, time.Now().Add(timeout))
}

我们看到,context包中的WithTimeout函数中的timeout的类型是time.Duration。

示例二:time.Sleep

func Sleep(d Duration)

time包中的Sleep函数的d参数也是Duration类型。

示例三:time.NewTicker

func NewTicker(d Duration) *Ticker

如果我们自己的程序中相关变量使用的也是time.Duration类型,那么在调用标准库函数时就不用进行类型转化了。

第二个原因就是该类型在语义上就明确了time.Duration类型值的基本单位是纳秒。这样在函数调用过程中就不用进行单位换算了。我们看下面以连接redis的示例是如何进行类型转换的。

我们在连接redis的时候,一般都会设置读写超时时间以及定义redis的地址,我们有如下配置:

type config struct {
    Addr string
    ReadTimeout int64 //以秒为单位
}

我们使用包github.com/go-redis/redis/v8包来连接redis。我们看到

func NewRedisClient(conf config) *redis.Client {
    opt := redis.Options{
        Addr: conf.Addr,
        ReadTimeout: conf.ReadTimeout * time.Second
    }
    
    client := redis.NewClient(opt)
    
    return client
}

我们知道redis.Options中的ReadTimeout的类型是time.Duration。 那么,如果我们在config配置文件中定义的int64类型以秒为单位的话,则在NewRedisClient中给redis.Options中的ReadTimeout赋值时,需要做如下转换:

conf.ReadTimeout * time.Second

那如果我们在config中定义的ReadTimeout的代表的是毫秒的话,那么在NewRedisClient函数中就需要做如下转换:

conf.ReadTimeout * time.Millisecond

那在config结构体中的ReadTimeout所代表的含义是秒还是毫秒还是其他的由谁来保证呢,只能是人为的进行保证。而如果使用time.Duration类型就是由系统类型来保证的,因为go的标准库定义的该类型就是代表纳秒数。

05 总结

本文从在实际编程中遇到的问题出发,了解到time.Duration类型实际代表的是持续的纳秒数。同时又分析了使用time.Duration类型的好处。在项目中,如果遇到和持续时间相关的变量的定义,也建议大家尽量使用time.Duration类型。

到此这篇关于记一次go语言使用time.Duration类型踩过的坑的文章就介绍到这了,更多相关go time.Duration内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯