Goメモ-420 (time.ParseDuration)(同じ時間単位は合計される)

関連記事

GitHub - devlights/blog-summary: ブログ「いろいろ備忘録日記」のまとめ

概要

以下、自分用のメモです。

time.ParseDuration 関数、300msなどの記載でパース出来るのでコマンドラインツールなどを作成する際にとても重宝する関数です。

知らなかったのですが、同じ時間単位のものを複数指定すると合計してくれるのですね、この関数さん。

サンプル

package times

import (
    "time"

    "github.com/devlights/gomy/output"
)

// ParseDuration は、time.ParseDuration() のサンプルです.
//
// > ParseDuration parses a duration string.
// A duration string is a possibly signed sequence of decimal numbers,
// each with optional fraction and a unit suffix,
// such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
//
// > ParseDuration は継続時間文字列を解析する。
// 継続時間文字列は、符号付きの10進数列の可能性があり、
// それぞれオプションの分数と "300ms"、"-1.5h"、"2h45m" のような単位の接尾辞があります。
// 有効な時間単位は、"ns"、"us"（または "µs"）、"ms"、"s"、"m"、"h "である。
//
// # REFERENCES
//   - https://pkg.go.dev/time@go1.22.3#ParseDuration
func ParseDuration() error {
    var (
        items = []string{
            "500ms",
            "5s",
            "5m",
            "5h",
            "1h2m3s444ms",
            "1h2m3s444ms555us666ns", // ナノ秒まで指定
            "1h2m3s4d",              // 不正な接尾辞
            "1h2m3h4s5h",            // 同じ時間単位のものは合計される
            "1h2m3h4s5h500ms500ms",  // 同じ時間単位のものは合計される
            "-1h2m3h4s5h",           // 先頭に - を付与すると負の値に出来る
        }
    )

    for _, item := range items {
        var (
            d   time.Duration
            err error
        )

        d, err = time.ParseDuration(item)
        if err != nil {
            output.Stdoutl("[error]", err)
            continue
        }

        output.Stdoutl("[Duration]", d)
    }

    return nil
}

実行すると以下のようになります。

$ task
task: Task "build" is up to date
task: [run] ./try-golang -onetime

ENTER EXAMPLE NAME: time_parse_duration

[Name] "time_parse_duration"
[Duration]           500ms
[Duration]           5s
[Duration]           5m0s
[Duration]           5h0m0s
[Duration]           1h2m3.444s
[Duration]           1h2m3.444555666s
[error]              time: unknown unit "d" in duration "1h2m3s4d"
[Duration]           9h2m4s
[Duration]           9h2m5s
[Duration]           -9h2m4s


[Elapsed] 92.72µs

ちゃんと合計してくれてますね。

ファイルの各行ごとに 3s444ms とか書かれたファイルがあって、それの合計を出すなどの処理を書く場合に全部直列で繋いでしまえば良いってことか。これは便利。

参考情報

Goのおすすめ書籍

初めてのGo言語 ―他言語プログラマーのためのイディオマティックGo実践ガイド

実用 Go言語 ―システム開発の現場で知っておきたいアドバイス

Go言語による並行処理

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ

Goならわかるシステムプログラミング 第2版

効率的なGo ―データ指向によるGoアプリケーションの性能最適化

---

過去の記事については、以下のページからご参照下さい。

• ブログ 「いろいろ備忘録日記」の記事まとめ | ブログ「いろいろ備忘録日記」のまとめ

サンプルコードは、以下の場所で公開しています。

• GitHub - devlights/try-golang: This is my TUTORIAL project for golang.
• GitHub - devlights/try-python: This is my TUTORIAL project for Python.
• GitHub - devlights/try-csharp: This is my TUTORIAL project for C#.