Go time.Duration.Microseconds 怎样转换微秒并保留负数

Go 中把 time.Duration 转成整数微秒，直接调用 d.Microseconds() 即可。它返回 int64，正数保持正数，负数保持负数；当纳秒数不足一个微秒时，整数除法会向零截断，不会四舍五入。

官方文档：https://pkg.go.dev/time#Duration.Microseconds

先理解 Duration 的纳秒存储模型

time.Duration 是一个有符号的 int64 类型，表示两个时刻之间经过的时间，内部单位是纳秒。也就是说，time.Second、time.Microsecond 和 time.Nanosecond 都是带有明确单位的 Duration 常量。

Microseconds 的作用是把这个纳秒计数转换成整数微秒计数。它不是把时间格式化成字符串，也不是把数值转换成浮点数，因此适合把耗时放进整数指标、比较阈值或编码到结构化数据中。

用 Microseconds 完成整数微秒转换

最小写法是对一个 Duration 值直接调用方法。下面的示例把正数、负数和不足一个微秒的输入放在一起，便于读者对照转换语义。

package main

import (
    "fmt"
    "time"
)

func main() {
    samples := []time.Duration{
        2*time.Second + 350*time.Microsecond,
        -1500 * time.Nanosecond,
        999 * time.Nanosecond,
    }

    for _, d := range samples {
        // Microseconds 返回整数微秒，适合直接参与整数比较或记录。
        fmt.Printf("%v -> %d 微秒\n", d, d.Microseconds())
    }
}

这里没有手写 int64(d) / int64(time.Microsecond)，因为标准库方法已经表达了意图，调用方也不需要重复维护单位换算常量。Microseconds 的返回类型是 int64，因此保存结果时不要误用 int 去表达跨平台或长期累计的指标。

负数和不足一微秒为什么向零截断

转换的关键不是“保留几位小数”，而是把纳秒整数换算成整数微秒。整数除法会丢掉不能组成完整微秒的部分，并且向零靠拢：

因此，-999ns 变成 0 并不代表原始持续时间是正数，而是代表它的整数微秒部分为零。如果业务必须区分“负的亚微秒”与“没有耗时”，就不能只保存 Microseconds() 的结果，应保留原始 Duration 或使用纳秒值。

在计时和超时判断中选对单位

如果目标是记录接口耗时、比较一个明确的微秒阈值，使用 Microseconds 很直接；如果目标是判断一个很短的等待是否已经发生，先转成微秒可能会过早丢失信息。

func overBudget(elapsed time.Duration, budgetMicros int64) bool {
    // 先统一成微秒，再与同单位的业务预算比较。
    return elapsed.Microseconds() > budgetMicros
}

func stillShort(elapsed time.Duration, budget time.Duration) bool {
    // 需要保留亚微秒信息时，直接比较 Duration，不要先转整数微秒。
    return elapsed 

还要注意比较符号：若预算是“超过才算超时”，通常使用 >；若预算是“达到就算超时”，则应使用 >=。这和单位转换是两件事，不要因为看到整数结果就顺手改变业务边界。

常见问题

Microseconds 会返回浮点数吗？

不会。它返回 int64 整数微秒计数；需要小数微秒或小数秒时，应明确选择浮点方法或保留原始 Duration，不要把整数结果再猜测成精确小数。

负的 Duration 转成微秒后会变成正数吗？

不会。只要绝对值至少包含一个完整微秒，符号会保留；只有负的亚微秒持续时间会因为向零截断得到 0。

什么时候应该用 Nanoseconds？

当测量对象可能小于一微秒，或业务需要区分 -999ns、0 和 999ns 时，直接保留 Duration 或调用 Nanoseconds()，不要先丢掉精度。