Popularity
6.0
Growing
Activity
2.8
Declining
295
4
37

Programming language: Go
Tags: Date & Time    
Latest version: v1.0.0

durafmt alternatives and similar packages

Based on the "Date & Time" category

Do you think we are missing an alternative of durafmt or a related project?

Add another 'Date & Time' Package

README

durafmt

Build Status Go Report Card codecov GoDoc Open Source Helpers

durafmt is a tiny Go library that formats time.Duration strings (and types) into a human readable format.

go get github.com/hako/durafmt

Why

If you've worked with time.Duration in Go, you most likely have come across this:

53m28.587093086s // :)

The above seems very easy to read, unless your duration looks like this:

354h22m3.24s // :S

Usage

durafmt.ParseString()

package main

import (
    "fmt"

    "github.com/hako/durafmt"
)

func main() {
    duration, err := durafmt.ParseString("354h22m3.24s")
    if err != nil {
        fmt.Println(err)
    }
    fmt.Println(duration) // 2 weeks 18 hours 22 minutes 3 seconds
    // duration.String() // String representation. "2 weeks 18 hours 22 minutes 3 seconds"
}

durafmt.ParseStringShort()

Version of durafmt.ParseString() that only returns the first part of the duration string.

package main

import (
    "fmt"

    "github.com/hako/durafmt"
)

func main() {
    duration, err := durafmt.ParseStringShort("354h22m3.24s")
    if err != nil {
        fmt.Println(err)
    }
    fmt.Println(duration) // 2 weeks
    // duration.String() // String short representation. "2 weeks"
}

durafmt.Parse()

package main

import (
    "fmt"
    "time"

    "github.com/hako/durafmt"
)

func main() {
    timeduration := (354 * time.Hour) + (22 * time.Minute) + (3 * time.Second)
    duration := durafmt.Parse(timeduration).String()
    fmt.Println(duration) // 2 weeks 18 hours 22 minutes 3 seconds
}

LimitFirstN()

Like durafmt.ParseStringShort() but for limiting the first N parts of the duration string.

package main

import (
    "fmt"
    "time"

    "github.com/hako/durafmt"
)

func main() {
    timeduration := (354 * time.Hour) + (22 * time.Minute) + (3 * time.Second)
    duration := durafmt.Parse(timeduration).LimitFirstN(2) // // limit first two parts.
    fmt.Println(duration) // 2 weeks 18 hours
}

Contributing

Contributions are welcome! Fork this repo, add your changes and submit a PR.

If you would like to fix a bug, add a feature or provide feedback you can do so in the issues section.

durafmt is tested against golangci-lint and you can run tests with go test.

When contributing, running go test; go vet; golint or golangci-lint is recommended.

License

MIT


*Note that all licence references and agreements mentioned in the durafmt README section above are relevant to that project's source code only.