whilst

func Parse ¶

func Parse(input string) (Whilst, error)

Parses a string representation of the duration.

A duration string consists of several decimal numbers supplemented with an unit of measurement. There may be spaces between a numbers supplemented with an unit, but there must not be spaces between a number and an unit. One of a signs - or + can be specified at a beginning of a string.

A value of days, months and years can only be an integer and cannot be greater than 65535 for each.

Remaining values ​​must not be greater than 9223372036854775807 for positive duration and 9223372036854775808 for negative duration and may have a fractional part.

List of valid units:

• y - year
• mo - month
• d - day
• h - hour
• m - minute
• s - second
• ms - millisecond
• µs | μs | us - microsecond
• ns - nanosecond

Example of strings:

• 2y3mo10d 24h30m28.02006002s
• - 2y3mo10d24h30m28.02006002s
• + 2y 3mo 10d 24h 30m 28.02006002s

package main

import (
	"fmt"
	"time"

	"github.com/akramarenkov/whilst"
)

func main() {
	from := time.Date(2023, time.April, 1, 0, 0, 0, 0, time.UTC)

	whl, err := whilst.Parse("2y")
	if err != nil {
		panic(err)
	}

	fmt.Println(whl)
	fmt.Println(whl.When(from))
	fmt.Println(whl.Duration(from))
}

Output:
2y
2025-04-01 00:00:00 +0000 UTC
17544h0m0s

package main

import (
	"fmt"

	"github.com/akramarenkov/whilst"
)

func main() {
	whl, err := whilst.Parse("2y 3mo 10d 23.5h 59.5m 58.01003001s 10ms 30µs 10ns")
	if err != nil {
		panic(err)
	}

	fmt.Println(whl)
}

Output:
2y3mo10d24h30m28.02006002s