Uber Go 语言编程规范:使用time处理时间

Golang使用Date进行Java日期格式化 Github https://github.com/noogo/date Date Date是一个基于time包装的一个日期包,通过此包可以快速创建日期、获取时间戳、毫秒数及最重要的日期格式化,另外你还可以继续使用time包下的所有函数(除time.Foramt(string)外)你可以通过以下方法快速创建一个Date对象: Now() WithTime(t time.Time) WithTim... 阅读详情

时间处理是很复杂的。关于时间的错误的假设通常包括以下几个方面:

  1. 一天有 24 小时
  2. 一小时有 60 分钟
  3. 一周有七天
  4. 一年 365 天
  5. 还有更多

例如,1表示在一个时间点上加上24小时,并不总能产生一个新的日历日期。

因此, 在处理时间时,始终使用 "time" 包,因为它有助于以更安全、更精确的方式处理这些错误的假设。

使用time.Time表达瞬时时间

处理瞬时时间时请使用time.Time ,在比较、添加和减少时间时使用time.Time 中的方法。

Bad

func isActive(now, start, stop int) bool {
  return start <= now && now < stop //使用了int 比较
}

Good

func isActive(now, start, stop time.Time) bool {
 //使用time.Time中的方法
  return (start.Before(now) || start.Equal(now)) && now.Before(stop)
}

使用 time.Duration  处理间隔时间

在处理间隔时间(时间段)时使用 time.Duration .

Bad

func poll(delay int) {
  for {
    // ...
    time.Sleep(time.Duration(delay) * time.Millisecond)
  }
}

poll(10) // 参数代表的是几秒钟还是几毫秒?

Good

//代表了时间段
func poll(delay time.Duration) {
  for {
    // ...
    time.Sleep(delay)
  }
}

poll(10*time.Second) //可以看出是10秒钟

回到前面的例子,给一个时间点瞬时加上24小时,我们用于添加时间的方法取决于要达到的目的:如果我们想要下一个日历日(当前天的下一天)的同一个时间点,我们应该使用Time.AddDate.方法。如果我们想保证某一时刻比前一时刻晚 24 小时,我们应该使用 Time.Add。

newDay := t.AddDate(0 /* years */, 0 /* months */, 1 /* days */)
maybeNewDay := t.Add(24 * time.Hour)

对外部系统使用time.Time和time.Duration

尽可能在与外部系统的交互中,使用 time.Duration 和 time.Time . 例如 :

当不能在这些交互中使用time.Duration,请使用 int 或 float64,并且要在字段名称中包含时间单位。

例如encoding/json不支持time.Duration,时间单位则包含在了字段名称中。

Bad

// {"interval": 2}
type Config struct {
  Interval int `json:"interval"` //没有表明时间单位
}

Good

// {"intervalMillis": 2000}
type Config struct {
  IntervalMillis int `json:"intervalMillis"`
}

如果当在这些交互中不能使用 time.Time 时,除非替代方法达成一致了,否则使用 string 和 RFC 3339 中定义的格式时间戳。默认情况下,Time.UnmarshalText 使用此格式,并可通过 time.RFC3339 在 Time.Format 和 time.Parse 中使用。

尽管这在实践中并不成问题,但请记住,"time" 包不支持解析闰秒时间戳(8728),也不在计算中考虑闰秒(15190)。如果您比较两个时间瞬间,则差异将不包括这两个瞬间之间可能发生的闰秒。

Uber 公司推出的 GoLang 编程规范 如果不是lib库,就需要增加所需的上下文信息,不然就会出现 "connection refused" 这样非常 模糊的错误,理论上应该添加上下文,来得到这样的报错信息:"call service foo: connection refused"。最好的情况下,编译器会直接报错,最糟糕的情况下,这样的代码会引入难以排查的bug。如果结构体中包含mutex,在使用结构体的指针时,mutex应该是结构体的非指针字段,也不要把mutex内嵌到结构体中,即使结构体是非导出类型。尽管编写内嵌类型已实现的方法是乏味的。 阅读详情

相关推荐

【CANoe16安装教程】亲测安装成功

CANoe16安装教程

qq_45302638的博客 2万+

golang time 时间 加减法

time包中的Add和Sub的用法,Add用于计算某个时间之前和之后的时间点,Sub用于计算两个时间差 实例如下: package main import ( "fmt" "strings" "time" ) func main() { // Add 时间相加 now := time.Now() // ParseDuration parses a duration string. // A duration string is a possibly signed sequence o

whatday的专栏 1万+

手把手教你复现KDD 2024时空预测顶会论文:以UniST和ImputeFormer为例的代码实战与避坑指南

本文详细指导如何复现KDD 2024顶会论文中的UniST和ImputeFormer模型,涵盖环境配置、数据处理、模型训练及评估等关键步骤。通过实战案例和避坑指南,帮助研究者掌握时空预测与插补技术,提升在智慧城市、交通管理等领域的应用能力。

weixin_29204205的博客 285

Go time Sleep 实现延时

Go 中 time.Sleep 不能传入数字来实现延时,而是传入 time.Duration time.Sleep(time.Duration(200) * time.Millisecond) time.Sleep(1 * time.Second)

深望的博客 1384

转录组数据提取技巧汇总

数据整理是数据分析的前提,而数据的正确提取则是数据整理的前提。

zfyyzhys的博客 1784

PDF批量加水印 与 去除水印实践

我们可以给PDF加图片水印或文字水印,要去除图片水印,一般只需要删除最后一个图片对象即可。要去除文字水印,需要保证主体内容和文字水印在/Contents中位于不同的对象内,这样我们只需要删除文字水印对应的对象即可删除水印。而对于主体内容和文字水印已经混合在一个对象时,本文的提供的方法则无能为力,需要进一步深入分析PDF细节。

小小明-代码实体的专栏 2763

golang time 时间的加减法

time包中Add和Sub的用法,Add用于计算某个时间之前和之后的时间点,Sub用于计算两个时间差

CodyGuo的博客 7万+

STM32G474多通道ADC电压采集:软件触发与单次转换实战

本文详细介绍了STM32G474多通道ADC电压采集的实战方法,重点讲解了软件触发与单次转换的实现技巧。通过硬件设计、HAL库配置、多通道轮询采集及数据处理等环节的详细解析,帮助开发者高效完成精确电压采集任务。文章还提供了常见问题调试技巧和性能优化建议,适用于需要高精度电压监测的嵌入式应用场景。

weixin_28720767的博客 466

【Golang】理解Golang中的time.Duration

在传递时间参数的时候,很多函数的参数类型是time.Duration 官方解释: Duration 将两个瞬间之间的经过时间表示为 int64 纳秒计数。 该表示将最大可表示持续时间限制为大约 290 年。 默认是纳秒单位 如果想传递一个10秒的时间进去,需要这样转换,其实就是把我们传递的整型进行了乘法 second := 10 time.Duration(seconds)*time.Secon...

程序员老狼专注开发aigc或客服系统应用 4600

从零到一:Ubuntu22.04下VSCode与中文输入法的深度整合指南

本文详细介绍了在Ubuntu22.04系统中如何深度整合VSCode与中文输入法,包括环境准备、安装方案对比、输入法配置及常见问题解决方案。通过fcitx框架优化中文输入体验,提供从基础设置到高级调试的全方位指南,帮助开发者提升在Linux环境下的开发效率。

weixin_29158047的博客 483

34、量子概率幅世界与相关操作解析

本文详细解析了量子概率幅的概念及其在量子力学中的核心作用,介绍了量子态的表示方法与叠加原理,讨论了幺正操作在量子演化中的重要性,并阐述了量子测量的基本原理与影响。此外,文章还分析了量子系统在量子计算中的应用,包括干涉在量子算法中的作用、量子门的组合使用以及量子测量的关键地位,总结了量子系统的独特特性与面临的挑战,展望了量子计算的未来发展趋势。

pytorch8learner的博客 176

Uber Go 语言编码规范

Uber Go 语言编码规范 中文版

J_Lee 2214

【机械臂视觉抓取从理论到实战】

首先声明一下,此项目是参考B站哈萨克斯坦UP的【机械臂视觉抓取从理论到实战】 此内容为他研究生生涯的阶段性成果展示和技术分享,所有数据和代码均开源。所以鹏鹏我特此来复现一下,我采用的硬件与之有所不同,UP主使用UR5,我实验室采用的是UR3,下面列出相关材料 UR3CB3.12:https://www.universal-robots.cn/cb3/ 【UR3系统升级到CB3.12附带URcap1.05】硬件支持代码支持 jacquard数据集:https://pan.baidu.com/s/1524HrV

vor234的博客 5194

值得参考的golang语言开发规范:Uber Go 语言编码规范,一些优秀的技巧可以提升代码的质量、避免代码缺陷和bug漏洞

值得参考的golang语言开发规范:Uber Go 语言编码规范,一些优秀的技巧可以提升代码的质量、避免代码缺陷和bug漏洞。

代码讲故事 1113

RU DOS版、EFI版32bit/64bit BIOS常用工具

DOS版、EFI版的RU工具,可用来查看IO、MEM、PCI、SMBIOS等资源。亲测在EFI SHELL下可用。

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

使用 Go 标准库 time 正确处理时间:Uber Go Style Guide 时间处理实践全解析

时间处理是 Go 开发中最容易被低估的复杂度来源——"一天有 24 小时""一小时有 60 分钟"这类直觉假设在夏令时、时区与闰秒面前往往不成立。本篇文章以 Uber Go Style Guide(本仓库核心文档,见 [style.md](https://link.gitcode.com/i/0abbd30e92c5e8dbda405a3ea2f4906e))中 "Use `"time"` to

gitblog_00434的博客 469

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

Uber Go 语言编程规范

文章目录1. 介绍2. 编程指南2.1 指向 Interface 的指针2.2 Receiver 和 Interface2.3 mutex 默认 0 值是合法的2.4 拷贝 Slice 和 Map2.5 使用 defer 做资源清理2.6 channel 的 size 最好是 1 或者是 unbuffered2.7 枚举变量应该从 1 开始2.8 Error 类型2.9 Error Wrappin...

稻草人技术博客 606

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

uber_go_guide_tw:Uber Go 语言编写规范繁体中文翻译

uber_go_guide_tw:Uber Go 语言编写规范繁体中文翻译 项目介绍 Uber Go 语言编写规范是由Uber公司开源的一套用于指导Go语言编写的最佳实践。这些规范旨在帮助开发者编写易于管理、高效且安全的Go代码。该项目在GitHub上开源,已经吸引了众多开发者的关注和贡献。 项目技术分析 uber_go_guide_tw项目包含了Uber公司内部使用的Go语言编写规范,这些规范不...

gitblog_00243的博客 890

Uber Go Style Guide 变更演进解读:从 CHANGELOG 回溯官方 Go 编码规范的二十年沉淀

Uber Go Style Guide([style.md](https://link.gitcode.com/i/16c29bdb3073d8d29e68c1067401dd16))是 Uber 内部维护并对外开源的一份 Go 编码规范文档,本仓库同时保留了它的完整变更记录 [CHANGELOG.md](https://link.gitcode.com/i/83d280f43d618a39e56

gitblog_00914的博客 721

Uber Go Style Guide 导读:从《Uber Go 风格指南》intro 看 Go 代码约定的核心思想与落地工具链

本文围绕 [Uber Go Style Guide](https://link.gitcode.com/i/88c33d53e4f926903fe8d902607d9962) 的开篇章节([src/intro.md](https://link.gitcode.com/i/78788d6902d8a16ea246621a118f016e))展开,讲清楚“风格约定”到底约束什么、这份指南为什么存在、它

gitblog_01103的博客 1102

Uber Go 编码规范:避免可变全局变量,用依赖注入取代包级状态

本篇技术指南聚焦 Uber Go 语言编码规范(uber_go_guide_cn)中的一条核心原则:**避免修改全局变量(Avoid Mutable Globals)**。无论你是想消除包级可变状态带来的数据竞争隐患,还是想让函数更容易被单元测试与 mock,读完本文你将掌握:为什么全局可变变量(包括函数指针)是危险的设计,如何通过结构体字段注入依赖来重构,以及如何在测试中优雅地替换时间等外部依赖

gitblog_00487的博客 703

Uber Go 编码规范之 Handle Errors Once:一次处理错误,避免重复处理与日志噪音

本篇文章聚焦 Uber Go Style Guide(本仓库中文版为 `uber_go_guide_cn`)Errors 章节中的 **Handle Errors Once(一次处理错误)** 准则。该准则回答了一个 Go 服务开发中反复出现的问题:当函数收到下游错误时,究竟应该"记录日志再返回"、"包装后返回",还是"就地降级处理"?读完本文你将掌握一套可判定的错误处理决策框架,明确 `erro

gitblog_00642的博客 336

对Uber Go Style Guide的理解和总结

1.不使用指向interface的指针 直接将接口作为值传递即可 传递过程中,底层数据仍然可以是指针 接口在底层的实质有两个字段:1.指向特定类型信息的指针 2.数据指针 2.接收器 ①使用值接收器的方法可以通过值或者指针调用 ②使用指针接收器的方法只能在指针或者可寻址值调用 type S struct { data string } func (s S) Read() string { return s.data } func (s *S) Write(str string) { s.da

llllleapfrog的博客 477

Uber的Go语言指南

1.接口实质上在底层用两个字段表示: 一个指向某些特定类型信息的指针。您可以将其视为"type"。 数据指针。如果存储的数据是指针,则直接存储。如果存储的数据是一个值,则存储指向该值的指针。 如果希望接口方法修改基础数据,则必须使用指针传递。 2.使用值接收器的方法既可以通过值调用,也可以通过指针调用。 值接收器实现的接口,值和指针都可用。 指针接收器实现的接口,只能指针可用,值会编译失败。 3....

Salted fish in hand, I have the world. 459

Uber Go Style Guide:函数命名规范(MixedCaps 与测试函数命名)深度解析

本篇技术指南聚焦于 Uber Go Style Guide 中关于**函数命名(Function Names)**的核心规范,即遵循 Go 社区广泛采用的 MixedCaps 命名约定,并为测试函数保留下划线以对相关用例进行分组。文章在完整继承 [src/function-name.md](https://link.gitcode.com/i/e41661d547c17dd11a6ab0f70ef

gitblog_00101的博客 482
上一篇: Uber Go 语言编程规范:枚举从1开始
下一篇: Uber Go 语言编程规范:错误类型
DreamCatcher
博客等级 码龄20年 23粉丝 151原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

DreamCatcher

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值