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

 更新时间:2022年01月26日 16:31:28   作者:Go学堂  
本文主要介绍了记一次go语言使用time.Duration类型踩过的坑,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下

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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:

相关文章

  • 深入理解Golang中的dig包管理和解决依赖关系

    深入理解Golang中的dig包管理和解决依赖关系

    这篇文章主要为大家详细介绍了golang中dig包的使用方法,探讨其应用场景,并提供一些示例,展示如何结合其他库来更好地实现这些场景,感兴趣的小伙伴可以了解下
    2024-01-01
  • 解决golang处理http response碰到的问题和需要注意的点

    解决golang处理http response碰到的问题和需要注意的点

    这篇文章主要介绍了解决golang处理http response碰到的问题和需要注意的点,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • Go代码格式化gofmt的使用方法实例

    Go代码格式化gofmt的使用方法实例

    Golang制定了统一的官方代码风格,并推出gofmt工具(go fmt)来帮助开发人员格式化代码到统一的风格,下面这篇文章主要给大家介绍了关于Go代码格式化gofmt的使用方法,需要的朋友可以参考下
    2023-04-04
  • 深入探索Go语言中unsafe包的使用

    深入探索Go语言中unsafe包的使用

    Go语言的unsafe包被誉为黑科技,它为Go语言提供了底层访问和操控内存的能力,本文将深入探讨Go语言中unsafe包的使用方法和注意事项,需要的可以参考一下
    2023-04-04
  • 使用go module导入本地包的方法教程详解

    使用go module导入本地包的方法教程详解

    go module 将是Go语言默认的依赖管理工具。到今天 Go1.14 版本推出之后 Go modules 功能已经被正式推荐在生产环境下使用了。本文重点给大家介绍如何使用 go module 导入本地包,感兴趣的朋友一起看看吧
    2020-03-03
  • golang实现简单的tcp数据传输

    golang实现简单的tcp数据传输

    这篇文章主要为大家介绍了golang实现简单的tcp数据传输,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-12-12
  • Go语言创建、初始化数组的常见方式汇总

    Go语言创建、初始化数组的常见方式汇总

    这篇文章主要介绍了Go语言创建、初始化数组的常见方式,实例汇总了Go语言操作数组的常见技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-02-02
  • Golang实现单元测试中的逻辑层

    Golang实现单元测试中的逻辑层

    前面我们完成了最麻烦的数据层的单元测试,今天我们来看看单元测试中最容易做的一层,数据逻辑层,也就是我们通常说的 service 或者 biz 等
    2023-03-03
  • Golang使用Zookeeper实现分布式锁

    Golang使用Zookeeper实现分布式锁

    分布式锁是一种在分布式系统中用于控制并发访问的机制,ZooKeeper 和 Redis 都是常用的实现分布式锁的工具,本文就来使用Zookeeper实现分布式锁,希望对大家有所帮助
    2024-02-02
  • GoLang string类型深入分析

    GoLang string类型深入分析

    string 作为 go 语言中的基础类型,其实有一些需要反复揣摩的,可能是我们使用的场景太简单,也可能是我们不需要那可怜的一点优化来提高性能,对它也就没那么上心了
    2023-01-01

最新评论