Go 怎样创建固定时区并格式化时间

Go 里创建带时区的时间，关键不是把字符串后面拼上一个时区缩写，而是先得到合适的 *time.Location，再用它创建或转换 time.Time。如果业务只需要一个永远不变的 UTC 偏移，可以用 time.FixedZone；如果要表达纽约、柏林这类地区随历史规则变化的时区，应使用 time.LoadLocation。

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

固定偏移用 FixedZone，地区规则用 LoadLocation；In 只改变同一时刻的显示位置，Format 再把这个时间按布局输出成文本。

先按业务约束选择 Location

time.Location 可以理解为“把一个时间点映射到当地日历和时钟表示”的规则集合。选择前先问一个问题：这个业务要的是固定偏移，还是一个真实地区的时区规则？前者通常来自协议、账单或设备约定；后者通常来自用户所在地区和日历规则。

用 FixedZone 创建固定时区

FixedZone 的签名是 time.FixedZone(name string, offset int) *time.Location。这里的偏移量不是小时，而是“向 UTC 东边偏移多少秒”：东八区写成 8 * 60 * 60，西五区写成 -5 * 60 * 60。名称主要用于该 Location 的描述和格式化显示，不会改变偏移量。

package main

import (
    "fmt"
    "time"
)

func main() {
    // FixedZone 的偏移量单位是秒；正数表示 UTC 以东，负数表示 UTC 以西。
    businessZone := time.FixedZone("BUSINESS+08", 8*60*60)

    // 把日期和时钟字段放入固定 Location，得到带业务时区的 Time。
    createdAt := time.Date(2026, time.October, 14, 9, 30, 0, 0, businessZone)

    // 这里用布局明确输出日期、时分和时区名，便于日志或报表消费。
    fmt.Println(createdAt.Format("2006-01-02 15:04:05 MST"))
}

固定时区的优势是没有外部时区数据库依赖，代码也容易复用。但它只表达一个恒定偏移：不能因为 Location 名称写成某个城市，就自动获得该城市的夏令时、历史改时或未来规则。

用 LoadLocation 表达真实地区规则

如果需求是“按用户选择的地区显示时间”，应该传入 IANA 时区名，例如 Asia/Shanghai 或 America/New_York。LoadLocation 会返回 (*time.Location, error)，因此加载失败必须显式处理，不能把空 Location 当成成功结果。

package main

import (
    "fmt"
    "time"
)

func loadBusinessLocation(name string) (*time.Location, error) {
    // 地区名称来自 IANA 时区数据库；错误通常意味着名称拼写或运行环境数据有问题。
    location, err := time.LoadLocation(name)
    if err != nil {
        return nil, fmt.Errorf("load time location %q: %w", name, err)
    }
    return location, nil
}

func main() {
    location, err := loadBusinessLocation("Asia/Shanghai")
    if err != nil {
        // 启动阶段加载失败应尽早返回，避免后续输出使用错误时区。
        panic(err)
    }

    // time.Date 直接使用地区 Location 创建当地日历时间。
    scheduled := time.Date(2026, time.October, 14, 9, 30, 0, 0, location)
    fmt.Println(scheduled.Format("2006-01-02 15:04:05 MST"))
}

这两种 Location 都能传给 time.Date、Format 和 In。差别在于规则来源：固定区只含一个偏移，地区 Location 由时区数据决定某个时刻应显示的偏移。

把已有时间转换到目标 Location

很多程序已经拿到一个 UTC 时间，之后才知道读者所在地区。这时不要重新拆分年月日再手动加小时，而是调用 In。它返回同一时刻在另一个 Location 中的表示，适合做展示层转换；保存和比较时仍然可以保留原来的时间值。

package main

import (
    "fmt"
    "time"
)

func formatForUser(instant time.Time, zoneName string) (string, error) {
    // 由调用方传入地区名，统一在展示边界加载 Location。
    location, err := time.LoadLocation(zoneName)
    if err != nil {
        return "", fmt.Errorf("load user location %q: %w", zoneName, err)
    }

    // In 只改变显示用的 Location，不把 instant 变成另一个时刻。
    localTime := instant.In(location)
    return localTime.Format("2006-01-02 15:04:05 MST"), nil
}

func main() {
    // 用 UTC 表达一个已经确定的时刻，再按用户地区转换显示。
    instant := time.Date(2026, time.October, 14, 1, 30, 0, 0, time.UTC)
    text, err := formatForUser(instant, "Asia/Shanghai")
    if err != nil {
        panic(err)
    }
    fmt.Println(text)
}

这里的布局使用 Go 的参考时间 2006-01-02 15:04:05 MST：数字部分决定日期和时分格式，MST 位置用于显示时区名称或缩写。若接口需要稳定的机器可读值，可另外输出 RFC3339，不要把展示文本当作数据库排序键。

把时区加载和格式化封装在边界上

在服务中可以在配置加载或请求入口处创建 Location，再把它传给领域函数。这样既不会让核心逻辑到处散落时区名称，也能把加载失败转成明确的配置错误。

package clock

import (
    "fmt"
    "time"
)

// Formatter 只负责把确定的时刻转换为面向读者的文字。
type Formatter struct {
    location *time.Location
}

func NewFormatter(zoneName string) (*Formatter, error) {
    // 启动时加载一次 Location，后续请求复用同一个只读规则对象。
    location, err := time.LoadLocation(zoneName)
    if err != nil {
        return nil, fmt.Errorf("invalid zone %q: %w", zoneName, err)
    }
    return &Formatter{location: location}, nil
}

func (f *Formatter) Format(t time.Time) string {
    // 展示前才转换 Location，调用方仍可保留原始 instant。
    return t.In(f.location).Format("2006-01-02 15:04:05 MST")
}

如果配置约定本来就是一个固定偏移，构造器可以把参数换成小时或分钟后转换为秒，再调用 time.FixedZone。但建议在配置层明确标注“固定偏移”，不要接受一个城市名却偷偷使用固定时区。

几个容易踩到的边界

• 偏移量单位写错：FixedZone 要秒数，直接传 8 表示 8 秒，不是 8 小时。
• 城市名不等于地区规则：把 FixedZone("New York", -5*60*60) 命名成城市，也不会获得纽约的历史或夏令时变化。
• 不要混淆同一时刻和同一墙上时间：In 的目标是保持 instant；如果业务要预约“当地 9 点”，应先明确预约发生在哪个 Location。
• 不要忽略加载错误：地区名称拼错、时区数据不可用时，继续格式化会把配置问题拖到业务结果里。

常见问题

FixedZone 的 offset 为什么要写成秒？

因为 API 接收的是 UTC 以东的秒数。常用写法是用 小时 * 60 * 60 表达，负号表示 UTC 以西。

已有 UTC 时间应该重新 time.Date 吗？

如果只是改变展示地区，不需要。直接调用 t.In(location)，它保留同一时刻，只切换显示所用的 Location。

LoadLocation 和 FixedZone 可以互换吗？

不能完全互换。固定偏移适合规则永远不变的协议或业务约定，地区 Location 适合需要 IANA 时区规则的真实地区时间。

Location 应该每次请求重新加载吗？

通常可以在配置加载或服务初始化阶段得到 Location，并在请求间复用；加载失败则在启动或配置更新时尽早暴露。