Go time.Time.AppendFormat 怎样把时间格式化到已有缓冲区

在日志前缀、协议头或批量导出记录已经写入 []byte 时，如果再用 t.Format(layout) 生成字符串，通常还要把字符串追加到缓冲区。这个场景可以直接换成 t.AppendFormat(buffer, layout)：它按照同样的布局格式化时间，但把结果接在已有字节切片后面，并返回扩展后的切片。

这次只解决一个具体问题：已有缓冲区里有固定前缀，怎样继续追加时间文本，同时保留前缀、正确处理布局，并让循环写日志时能够复用容量。是否真的减少分配，最后用基准中的 allocs/op 和吞吐确认，不凭感觉下结论。

先分清 Format 和 AppendFormat 的输出方向

Format 的结果类型是 string，适合直接展示或交给字符串 API；AppendFormat 的结果类型是 []byte，它接收一个已有切片，把格式化结果追加进去。两者使用同一种 Go 时间布局规则，例如 2006-01-02 15:04:05。

关键点是必须接住返回值。切片的长度可能增长，底层数组也可能因为容量不足而更换；只调用方法却继续使用旧切片，无法得到完整结果。

把时间追加到已有的日志前缀

下面的函数先写入事件名称，再把时间追加到同一块字节结果中。布局中的数字和字母不是普通占位符，而是 Go 规定的参考时间写法，不能随意改成常见的 YYYY。

package main

import (
	"fmt"
	"time"
)

func eventLine(now time.Time, name string) []byte {
	line := make([]byte, 0, 64)
	line = append(line, "event="...)
	line = append(line, name...)
	line = append(line, " time="...)
	// AppendFormat 直接接到已有字节后，并返回可能扩容后的切片。
	line = now.AppendFormat(line, time.RFC3339Nano)
	return line
}

func main() {
	now := time.Date(2026, time.October, 21, 16, 45, 0, 123456789, time.FixedZone("CST", 8*60*60))
	// 示例输出保留前缀，时间部分由 AppendFormat 追加。
	fmt.Println(string(eventLine(now, "cache-refresh")))
}

这个函数返回的是完整的字节切片，所以调用方可以继续交给 io.Writer.Write 或网络编码器。若只需要一次性的展示文本，Format 读起来更直观；只有目标本来就是字节缓冲区时，追加式接口才有明确价值。

循环写日志时怎样复用容量

在循环里，容量复用和内容清空是两件事。可以用 buffer[:0] 把长度归零、保留底层数组，再重新追加前缀和时间。每轮都必须重新接住 AppendFormat 的返回值。

func writeLines(times []time.Time) [][]byte {
	buffer := make([]byte, 0, 96)
	result := make([][]byte, 0, len(times))
	for _, now := range times {
		buffer = buffer[:0] // 保留容量，只清除本轮可见长度。
		buffer = append(buffer, "time="...)
		buffer = now.AppendFormat(buffer, time.RFC3339)
		// 复制一份当前内容，避免下一轮覆盖已经保存的结果。
		line := append([]byte(nil), buffer...)
		result = append(result, line)
	}
	return result
}

这里特意复制了 buffer，因为下一轮会继续复用它。如果下游能够立即消费并且不保存切片，可以省掉复制；如果要把多行结果放进返回值、队列或异步任务，就必须明确所有权，否则每一行可能最后都指向同一块被反复覆盖的数组。

布局、时区和性能判断的边界

第一，布局要用 Go 的参考时间语法；第二，AppendFormat只负责按 Time 当前携带的时区解释和输出，不会替你把时间转换到业务时区，需要时先调用 In(location)；第三，缓冲区不是并发安全容器，不能让多个 goroutine 同时追加。

如果要确认替换是否值得，建议分别比较 Format 后再 append 与直接 AppendFormat 两种实现，观察 ns/op、allocs/op、输出长度和是否发生额外复制。不同布局、不同前缀长度和不同 Go 版本都可能改变结果，不能把某一次机器上的数字当成通用保证。

相关问题

问：AppendFormat 会修改传入的时间吗？答：不会，它只读取 Time 并把文本追加到字节切片。

问：为什么一定要接收返回值？答：追加可能触发扩容并返回新的切片头，继续使用旧切片可能看不到新增内容。

问：AppendFormat 是否一定比 Format 更快？答：不一定。只有在已有字节缓冲区、后续也按字节处理且基准测量支持时，替换才有意义。