duration

Documentation

Index

• Constants
• func Format(duration time.Duration) string
• func FormatQuick(duration time.Duration) string
• func FormatSeconds(duration time.Duration) string
• func ParseToDuration(durationString string) (time.Duration, error)

Constants

const (
	TimeDay   = 24 * time.Hour
	TimeMonth = 30 * TimeDay
	TimeYear  = 365 * TimeDay
)

time values for missing time values

Functions

func Format

func Format(duration time.Duration) string

Format returns a string representing the duration in the ISO 8601 format, but only with the hours being the highest time element, e.g. "PT44H7M3.15s". Leading zero units are omitted. The result counts as a valid ISO8601 duration. It supports negative durations, as detailed in the extension ISO 8601-2.

func FormatQuick

func FormatQuick(duration time.Duration) string

FormatQuick Deprecated: use FormatSeconds instead.

func FormatSeconds

func FormatSeconds(duration time.Duration) string

FormatSeconds returns a string representing the duration in the ISO8601 format, but only in seconds, e.g. "PT345.15s". Leading zero units are omitted. The result counts as a valid ISO8601 duration. It supports negative durations, as detailed in the extension ISO8601-2. Deprecated: it is not significantly faster than Format, so it will be replaced by it later.

func ParseToDuration

func ParseToDuration(durationString string) (time.Duration, error)

ParseToDuration parses an ISO 8601 duration string into a time.Duration. It accepts negative durations but only by prepending a '-' like: "[-]P<duration>".