timeutil

A Timedelta represents a duration between two dates, inspired by Python's timedelta. It allows you to define durations using human-readable units like Days, Weeks, or Minutes, which can then be converted into a standard time.Duration to be used with Go's native time.Time objects.

base := time.Date(2015, 2, 3, 0, 0, 0, 0, time.UTC)
td := timeutil.Timedelta{Days: 10, Minutes: 17, Seconds: 56}

result := base.Add(td.Duration())
// result is 2015-02-13 00:17:56 +0000 UTC

To use timeutil in your Go project, install it using the following command:

go get github.com/leekchan/timeutil

You can perform arithmetic on Timedelta objects using the following methods:

• Add(t2 *Timedelta): Returns the sum of t + t2.
• Subtract(t2 *Timedelta): Returns the difference t - t2.
• Abs(): Returns the absolute value of the Timedelta.

td1 := timeutil.Timedelta{Days: 1}
td2 := timeutil.Timedelta{Days: 2}

// Addition
sum := td1.Add(&td2)

// Subtraction
diff := td1.Subtract(&td2)

// Absolute value
abs := diff.Abs()

The Strftime function formats a *time.Time according to a format string containing directives starting with %. Unlike standard Go time formatting, Strftime supports Unicode characters within the format string.

date := time.Date(2015, 7, 2, 15, 24, 30, 35, time.UTC)
str := timeutil.Strftime(&date, "작성일 : %a %b %d %I:%M:%S %p %Y")
// str: "작성일 : Thu Jul 02 03:24:30 PM 2015"

The Timedelta struct is used to define a span of time. All fields are optional and default to 0. You can initialize it by specifying any combination of the following fields (all of type time.Duration):

• Days
• Seconds
• Microseconds
• Milliseconds
• Minutes
• Hours
• Weeks

Note: While the fields are named as units, they are technically time.Duration types.

td := timeutil.Timedelta{Days: 10, Minutes: 17, Seconds: 56}

Use the Duration() method on a Timedelta instance to get a standard time.Duration. This value can be passed directly into Go's time.Time.Add() method.

base := time.Date(2015, 2, 3, 0, 0, 0, 0, time.UTC)
td := timeutil.Timedelta{Days: 10}

result := base.Add(td.Duration())