Go time.Duration.String 为什么会输出负号和小数单位

在 Go 日志里打印一个 time.Duration，结果可能是 1.5s、500ms、1.5µs，也可能带着负号。这个结果通常不是精度丢失，而是 Duration.String 在按照纳秒整数自动选择更容易阅读的单位。

判断它是否正确，可以记住三句话：Duration 存的是 int64 纳秒数；String 会省略高位的零单位；小于 1 秒的值会优先使用毫秒、微秒或纳秒，让首位数字不是 0。零值则固定写成 0s。

先区分 Duration 的数值和显示方式

time.Duration 不是浮点秒数，而是两个时间点之间的纳秒整数。负数只表示时间间隔方向为负，调用 String 时负号会保留在整个结果最前面。

package main

import (
	"fmt"
	"time"
)

func main() {
	values := []time.Duration{
		72*time.Hour + 3*time.Minute + 500*time.Millisecond,
		1500 * time.Millisecond,
		-1500 * time.Millisecond,
		500 * time.Microsecond,
		0,
	}

	for _, value := range values {
		// String 只负责可读展示，不改变 Duration 的纳秒数。
		fmt.Printf("%d ns => %s\n", value.Nanoseconds(), value.String())
	}
}

这个例子里，组合值会按小时、分钟、秒和小数秒展示；负的 1.5 秒会得到 -1.5s；500 微秒不会写成 0.0005s，而会选择更直观的 500µs；零值则是 0s。

为什么有时是小数秒，有时直接换成毫秒

String 的目标是紧凑且可读，而不是固定小数位。大于等于 1 秒的值可以在秒后保留小数，例如 1500 毫秒表示为 1.5s；小于 1 秒的值则换用更小单位，避免出现 0.5s 这种首位为零的表达。

因此，下面这些输出表达的是不同的纳秒数量：

• 1s：整秒，没有必要追加小数。
• 1.25s：秒级值仍有小数部分，精度继续保留。
• 250ms：小于一秒，改用毫秒。
• 250µs：毫秒仍会以 0 开头，继续改用微秒。

负号、前导零和多单位要怎么判断

排查日志时可以按三个层次看。第一，确认计算方向：start.Sub(end) 与 end.Sub(start) 的顺序相反，前者可能自然得到负值。第二，看最高的非零单位，String 不会输出没有意义的前导零。第三，再看秒以下的剩余部分是否需要用小数表达。

package main

import (
	"fmt"
	"time"
)

func main() {
	start := time.Date(2026, 10, 14, 10, 0, 0, 0, time.UTC)
	end := start.Add(1500 * time.Millisecond)

	// 先用较晚时间减较早时间，得到正的耗时。
	positive := end.Sub(start)
	// 调换减法顺序会保留方向，所以结果带负号。
	negative := start.Sub(end)

	fmt.Println("positive:", positive.String())
	fmt.Println("negative:", negative.String())
}

如果日志中的负号不符合业务语义，先检查减法方向，不要直接用 Abs 掩盖问题。只有在业务明确只关心耗时绝对值时，才考虑 d.Abs()；而且极小的边界值仍应按业务规则处理。

接口需要固定单位时不要依赖 String

String 适合日志、调试信息和人类阅读，不适合要求固定单位或固定小数位的协议字段。接口若约定毫秒整数，可以调用 Milliseconds()；若约定秒的小数，可以调用 Seconds() 后自行决定格式；若要传输原始精度，则使用 Nanoseconds()。

package main

import (
	"fmt"
	"time"
)

func main() {
	d := 1500 * time.Millisecond

	// 日志可读性优先，允许 String 自动选择单位。
	fmt.Println("log:", d.String())
	// 协议字段要固定语义，明确发送毫秒整数。
	fmt.Println("api_ms:", d.Milliseconds())
	// 需要秒的小数时由调用方决定保留几位。
	fmt.Printf("api_seconds: %.3f\n", d.Seconds())
}

这样可以把“人类展示”和“机器协议”分开：日志中看到 1.5s 不代表接口也必须传这个字符串，接口字段的单位和精度应由协议单独约定。

常见问题

为什么 500ms 不显示为 0.5s？

因为小于 1 秒的 Duration 会优先选择毫秒、微秒或纳秒，让结果的首位数字非零，所以 500ms 是预期格式。

String 会四舍五入吗？

它主要是在选择单位并组织字符串，不应把它当作固定小数位的舍入工具。需要舍入时，先使用 Round 或 Truncate 得到明确的 Duration，再决定展示方式。

怎样让所有接口都返回毫秒？

接口层统一使用 Milliseconds() 或 Nanoseconds() 等明确的数值方法，并在字段文档中写清单位。不要让接收方猜测 String 自动选出的单位。

小结：time.Duration.String 的负号来自 Duration 本身的方向，小数和单位来自可读性规则。日志排查先检查计算顺序；协议输出则明确使用毫秒、秒或纳秒数值。