Go で Time タイプのエイリアスを印刷すると予期しない出力が生成されるのはなぜですか?

time.Time Type Alias を含む予期しない出力

Go では、カスタム型の UnmarshalJSON メソッドを使用して、JSON 値をカスタマイズする機会を提供します。整理されていない。一般的な使用例の 1 つは、時間値の表現を変更することです。ただし、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 JSON 文字列表現を time.Time 値に変換するメソッドが Time 型に対して定義されています。 JSON 文字列を解析するとき、メソッドは文字「Z」を末尾に追加して、タイムゾーンが UTC に設定されていることを確認します。

ただし、fmt.Printf を使用してアンマーシャリングされた User 値を出力しようとすると、予期しない出力に気づく場合があります:

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

この出力は時間の値を明確に表していないため、誤解を招きます。

この動作の理由は、Go がカスタム型をフォーマットする方法にあります。 fmt パッケージには、組み込み型のデフォルトの書式設定ロジックがありますが、カスタム型の場合は、基になる型のフィールドの出力に戻ります。この場合、Time は time.Time の型エイリアスであるため、フォーマット時に fmt は time.Time の基になるフィールドを出力し、混乱を招く出力になります。

Solutions

この問題を解決するには、次の 2 つのアプローチのいずれかを実行できます。

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>

このアプローチString メソッドを含む、time.Time のすべてのメソッドを継承します。これにより、書式設定中に期待どおりの出力が保証されます。

時間値を扱う際のもう 1 つの重要な考慮事項は、JSON マーシャリングおよびアンマーシャリングにエンコーディング/json パッケージを使用することです。 JSON 文字列を手動で解析すると、エラーや不正なデータ処理が発生する可能性があります。

以上がGo で Time タイプのエイリアスを印刷すると予期しない出力が生成されるのはなぜですか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。