Time Parser

timep(Time P) is a Go package for parsing and working with extended time durations. It supports common time units like years (Y), months (M), weeks (W), days (D), hours (h), and so on. Additionally, it allows defining custom time units for more flexible duration parsing.

Installation

To install the timep package, run:

go get github.com/go-shafaq/timep

Usage

Parsing Common Durations

Here's how to parse a duration string with common units:

package main

import (
	"fmt"
	"github.com/go-shafaq/timep"
)

func main() {
	dur, _ := timep.ParseDuration("1Y2M3W4D5h6m")
	fmt.Println(dur)
}

Input: "1Y2M3W4D5h6m"
Output: 8975h5m0s

Defining Custom Units

You can define custom time units to suit your needs. For example, to define a "season" as 90 days:

package main

import (
	"fmt"
	"time"
	"github.com/go-shafaq/timep"
)

func main() {
	const day = uint64(24 * time.Hour)

	um := timep.BaseUnitMap() // Clone a base unit map
	um["season"] = 90 * day   // Define custom unit "season" as 90 days

	dp, _ := timep.DurationParser(um) // Create a duration parser with the custom units

	dur, _ := dp.ParseDuration("3season")
	fmt.Println("Parsed Custom Duration:", dur)
}

Input: "3season"
Output: 6480h0m0s

Time Unit Definitions

The supported standard time units are:

• Y/y = Year (365 days)
• M = Month (30 days)
• W/w = Week (7 days)
• D/d = Day (24 hours)
• h = Hour
• m = Minute
• s = Second

If you have any issues or need further assistance, just let me know!