为什么 Go 中的时间类型别名在打印时会产生意外的输出？

带有时间的意外输出。时间类型别名

在 Go 中，自定义类型的 UnmarshalJSON 方法提供了自定义 JSON 值的机会未编组。一种流行的用例是修改时间值的表示。但是，当使用 time.Time 的类型别名时，必须注意确保预期的输出。

考虑以下代码片段：

<code class="go">package main

import (
    "encoding/json"
    "fmt"
    "strings"
    "time"
)

type Time time.Time // Custom type alias for `time.Time`

func (st *Time) UnmarshalJSON(b []byte) error {
    s := strings.Trim(string(b), "\"")
    t, err := time.Parse(time.RFC3339, fmt.Sprintf("%sZ", s))
    if err != nil {
        return fmt.Errorf("parse time: %w", err)
    }
    *st = Time(t)
    return nil
}

type User struct {
    Name string
    TS Time // Field of type `Time`
}</code>

在此示例中，自定义 UnmarshalJSON为 Time 类型定义了方法，用于将 JSON 字符串表示形式转换为 time.Time 值。解析 JSON 字符串时，该方法会在末尾附加字母“Z”，以确保时区设置为 UTC。

但是，如果您尝试使用 fmt.Printf 打印未编组的 User 值，您将可能会注意到意外的输出：

&{Name {958450000 63757163420 <nil>}}</nil>

此输出具有误导性，因为它没有清楚地表示时间值。

此行为的原因在于 Go 格式化自定义类型的方式。 fmt 包具有内置类型的默认格式化逻辑，但对于自定义类型，它会回退到打印基础类型的字段。在本例中，Time 是 time.Time 的类型别名，因此在格式化时，fmt 会打印 time.Time 的底层字段，导致输出混乱。

解决方案

要解决此问题，您可以采取以下两种方法之一：

1. 实现 fmt.Stringer 接口：

定义 String 方法对于委托给 time.Time 的 String 方法的 Time 类型：

<code class="go">func (t Time) String() string {
    return time.Time(t).String()
}</code>

使用此方法，fmt 将在打印 User 值时使用自定义格式化逻辑：

&{Name 2021-05-21 03:10:20.95845 +0000 UTC}

2. 嵌入 time.Time:

或者，您可以将 time.Time 直接嵌入到您的 Time 类型中：

<code class="go">type Time struct {
    time.Time
}</code>

这种方法继承了 time.Time 的所有方法，包括 String 方法，它确保格式化期间的预期输出。

处理时间值时的另一个重要考虑因素是使用encoding/json 包进行 JSON 编组和解组。手动解析 JSON 字符串可能会导致错误或不正确的数据处理。

以上是为什么 Go 中的时间类型别名在打印时会产生意外的输出？的详细内容。更多信息请关注PHP中文网其他相关文章！