diff options
Diffstat (limited to 'docs/content/en/functions/time.ParseDuration.md')
-rw-r--r-- | docs/content/en/functions/time.ParseDuration.md | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/content/en/functions/time.ParseDuration.md b/docs/content/en/functions/time.ParseDuration.md new file mode 100644 index 000000000..aabba601a --- /dev/null +++ b/docs/content/en/functions/time.ParseDuration.md @@ -0,0 +1,20 @@ +--- +title: time.ParseDuration +description: Parses a given duration string into a `time.Duration` structure. +categories: [functions] +menu: + docs: + parent: "functions" +keywords: [time parse duration] +signature: ["time.ParseDuration DURATION"] +hugoversion: +aliases: [] +--- + +`time.ParseDuration` parses a duration string into a [`time.Duration`](https://pkg.go.dev/time#Duration) structure so you can access its fields. +A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as `300ms`, `-1.5h` or `2h45m`. Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. + +You can perform [time operations](https://pkg.go.dev/time#Duration) on the returned `time.Duration` value: + + {{ printf "There are %.0f seconds in one day." (time.ParseDuration "24h").Seconds }} + <!-- Output: There are 86400 seconds in one day. --> |