本文介绍在 Go 中通过实现 xml.Marshaler 接口，将 time.Time 类型的单一字段拆分为 <Date> 和 <Time> 两个 XML 子标签的完整实践方案。
本文介绍在 go 中通过实现 `xml.marshaler` 接口，将 `time.time` 类型的单一字段拆分为 `
在 Go 的标准库中，encoding/xml 包不支持直接用一个结构体字段映射到多个 XML 标签（如将 DateTime 同时导出为 <Date> 和 <Time>）。xml struct tag 仅能指定单个标签名、属性或忽略字段，无法表达“一域两标”的语义。因此，必须借助自定义序列化逻辑——即实现 xml.Marshaler 接口。
核心思路是：定义一个私有导出结构体（如 appointmentExport），其字段与目标 XML 结构严格对应；在 MarshalXML() 方法中，将原始字段（如 DateTime）格式化为所需字符串，并封装进该临时结构体，再交由 xml.Encoder 编码。
以下为可直接运行的完整示例：
package main
import (
"encoding/xml"
"fmt"
"time"
)
type Appointment struct {
DateTime time.Time
}
// 私有导出结构体，匹配目标 XML 结构（首字母大写 + xml tag）
type appointmentExport struct {
XMLName xml.Name `xml:"Appointment"` // 注意：与原始 XML 标签名一致，首字母大写
Date string `xml:"Date"`
Time string `xml:"Time"`
}
// 实现 xml.Marshaler 接口
func (a *Appointment) MarshalXML(e *xml.Encoder, start xml.StartElement) error {
// 格式化时间：日期使用 ISO 标准格式，时间使用 24 小时制
export := &appointmentExport{
Date: a.DateTime.Format("2006-01-02"),
Time: a.DateTime.Format("15:04"),
}
return e.Encode(export)
}
func main() {
a := &Appointment{
DateTime: time.Date(2004, 12, 22, 14, 0, 0, 0, time.UTC),
}
output, err := xml.MarshalIndent(a, "", " ")
if err != nil {
panic(err)
}
fmt.Println(string(output))
}输出结果为：
<Appointment>
<Date>2004-12-22</Date>
<Time>14:00</Time>
</Appointment>⚠️ 注意事项：
- appointmentExport 必须是导出类型（首字母大写），否则 xml 包无法访问其字段；
- XMLName 字段用于显式指定根元素名称，需与期望的 XML 根标签完全一致（包括大小写）；
- Date 和 Time 字段的 xml tag 值也需与目标 XML 标签名严格匹配（如原例为 Date/Time，非 date/time）；
- 若还需支持反序列化（UnmarshalXML），则必须同时实现 xml.Unmarshaler 接口，解析 <Date> 和 <Time> 并组合为 time.Time（推荐使用 time.Parse，注意时区处理）；
- 时间格式字符串必须遵循 Go 的固定参考时间 Mon Jan 2 15:04:05 MST 2006（即 2006-01-02 和 15:04），切勿误用常见 ISO 格式如 YYYY-MM-DD。
此方案清晰分离了数据模型（Appointment）与序列化契约（appointmentExport），兼顾类型安全与 XML 结构灵活性，是处理复杂 XML 映射场景的标准实践。
