hugo/docs/content/en/functions/time/Duration.md
2023-10-20 09:43:56 +02:00

1.4 KiB

title linkTitle description categories keywords menu function relatedFunctions aliases
time.Duration duration Returns a `time.Duration` structure, using the given time unit and duration number.
functions
docs
parent
functions
aliases returnType signatures
duration
time.Duration
time.Duration TIME_UNIT DURATION_NUMBER
time.AsTime
time.Duration
time.Format
time.Now
time.ParseDuration
/functions/duration

time.Duration converts a given number into a time.Duration structure so you can access its fields. E.g. you can perform time operations on the returned time.Duration value:

{{ printf "There are %.0f seconds in one day." (duration "hour" 24).Seconds }}
<!-- Output: There are 86400 seconds in one day. -->

Make your code simpler to understand by using a chained pipeline:

{{ mul 7.75 60 | duration "minute" }} → 7h45m0s
{{ mul 120 60 | mul 1000 | duration "millisecond" }} → 2h0m0s

You have to specify a time unit for the number given to the function. Valid time units are:

Duration Valid time units
hours hour, h
minutes minute, m
seconds second, s
milliseconds millisecond, ms
microseconds microsecond, us, µs
nanoseconds nanosecond, ns