时间格式布局

Go 的时间格式布局不是常见的 YYYY-MM-DD 模板，而是把一个固定的参考时间当作“格式词典”：2006-01-02 15:04:05 中的每一段数字都有特殊含义。需要补零时使用 01、02、03；不补零时使用 1、2、3。因此，标题中的 01 与 1 不是同义写法。

排查时间格式时，先把目标样例拆成“年、月、日、小时、分钟、秒和时区”，再用 Go 参考时间中的对应片段拼布局。格式化和解析必须使用同一套布局，输入不匹配时要保留并处理返回的错误。

• 2006 与 06：四位年份与两位年份。
• 01 与 1：两位月份与不补零月份。
• 02 与 2：两位日期与不补零日期。
• 15：24 小时制；3 或 03：12 小时制，通常配合 PM。

Go 时间布局为什么使用 2006-01-02

time 包将参考时间定义为 01/02 03:04:05PM '06 -0700，也就是 2006 年 1 月 2 日 15 点 04 分 05 秒、MST 时区。布局字符串不是把字母 Y、M、D 替换成值，而是从这个参考时间里选取片段。这样设计后，布局本身可以直接读成一个示例日期。

例如，下面的布局会输出四位年份、两位月份、两位日期和 24 小时制时间。代码中的注释只说明关键标记，不把布局写成其他语言常见的占位符。

package main

import (
	"fmt"
	"time"
)

func main() {
	value := time.Date(2026, time.January, 2, 15, 4, 5, 0, time.UTC)

	// 2006、01、02、15、04、05 分别代表年、月、日、24 小时制时分秒。
	layout := "2006-01-02 15:04:05"
	fmt.Println(value.Format(layout))
}

01 和 1 的区别不只是写法长短

需要固定宽度时使用带零的布局标记：01 会把一月写成 01，02 会把二日写成 02。日志、文件名和接口字段通常适合固定宽度，因为字符串排序和列对齐更稳定。不需要补零的展示场景则可使用 1、2。

小时还要先确定制式。15 表示 24 小时制；03 表示带前导零的 12 小时制，配合 PM 才能区分上午和下午。把 03 当成 24 小时制，或把 15 与 PM 混在一起，都会让布局语义变得混乱。

package main

import (
	"fmt"
	"time"
)

func main() {
	value := time.Date(2026, time.January, 2, 15, 4, 5, 0, time.UTC)

	// 01 与 1 控制月份是否补零；03 与 15 分别表示 12/24 小时制。
	fmt.Println(value.Format("2006-1-2"))
	fmt.Println(value.Format("2006-01-02"))
	fmt.Println(value.Format("2006-01-02 03:04:05 PM"))
	fmt.Println(value.Format("2006-01-02 15:04:05"))
}

Format 和 Parse 要共用同一套布局

格式化和解析是同一组标记的两个方向。输出是 2026/01/02 15:04 时，解析布局就应写成 2006/01/02 15:04；不要把输入中的分隔符、补零规则或小时制悄悄改掉。解析失败时，返回的 error 是定位输入问题的依据。

package main

import (
	"fmt"
	"time"
)

func main() {
	text := "2026/01/02 15:04"
	layout := "2006/01/02 15:04"

	// Parse 失败时保留错误信息，避免把零值时间误当成有效结果。
	parsed, err := time.Parse(layout, text)
	if err != nil {
		fmt.Println("解析失败:", err)
		return
	}

	// 使用同一布局格式化，便于检查输入与输出的字段是否一致。
	fmt.Println(parsed.Format(layout))
}

出现格式不对时按这几个信号排查

如果月份或日期少了一个零，先检查是否误用了 1 或 2。如果下午时间变成了上午，检查是否用了 12 小时制却漏写 PM，或者本来需要 15 却写成了 03。如果 Parse 返回错误，逐个对照输入文本与布局的分隔符、字段宽度、小时制和时区部分。

时区也是布局的一部分。Format 使用 time.Time 当前携带的 location；如果业务要求固定时区，应在进入格式化边界前明确时间值的 location，而不是只修改布局字符串。布局只能描述显示方式，不能替业务决定“这个时间属于哪个地区”。

package main

import (
	"fmt"
	"time"
)

func main() {
	value := time.Now()
	loc, err := time.LoadLocation("Asia/Shanghai")
	if err != nil {
		// 时区数据不可用时立即停止，避免输出带错误地区含义的时间。
		panic(err)
	}

	// 先确定 location，再用布局控制显示字段和补零规则。
	value = value.In(loc)
	fmt.Println(value.Format("2006-01-02 15:04:05 MST"))
}

常见问题

Go 能不能使用 YYYY-MM-DD 作为布局？

不能把它当作 Go 的年月日标记。Go 应使用参考时间片段，例如 2006-01-02。

为什么月份写 01，日期却写 2 也能工作？

两种标记都有效，但含义不同：01 补零，2 不补零。是否补零取决于目标文本格式。

解析成功但时区不符合预期怎么办？

检查布局是否包含时区信息，以及是否在解析前选择了正确的 location。仅调整年月日片段不能改变时间所属地区。

速查结论：先用参考时间拼出布局，再决定补零和小时制；Format 与 Parse 共用布局；遇到异常优先对照输入文本、布局标记和 location 三者是否一致。