mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-18 17:46:45 -05:00
5fd1e74903
``` git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash ``` Closes #11925
46 lines
1 KiB
Markdown
46 lines
1 KiB
Markdown
---
|
|
title: time.Duration
|
|
description: Returns a time.Duration value using the given time unit and number.
|
|
categories: []
|
|
keywords: []
|
|
action:
|
|
aliases: [duration]
|
|
related:
|
|
- functions/time/AsTime
|
|
- functions/time/Format
|
|
- functions/time/Now
|
|
- functions/time/ParseDuration
|
|
returnType: time.Duration
|
|
signatures: [time.Duration TIME_UNIT NUMBER]
|
|
aliases: [/functions/duration]
|
|
---
|
|
|
|
The `time.Duration` function returns a [`time.Duration`] value that you can use with any of the `Duration` [methods].
|
|
|
|
This template:
|
|
|
|
```go-html-template
|
|
{{ $duration := time.Duration "hour" 24 }}
|
|
{{ printf "There are %.0f seconds in one day." $duration.Seconds }}
|
|
```
|
|
|
|
Is rendered to:
|
|
|
|
```text
|
|
There are 86400 seconds in one day.
|
|
```
|
|
|
|
The time unit must be one of the following:
|
|
|
|
|
|
Duration|Valid time units
|
|
:--|:--
|
|
hours|`hour`, `h`
|
|
minutes|`minute`, `m`
|
|
seconds|`second`, `s`
|
|
milliseconds|`millisecond`, `ms`
|
|
microseconds|`microsecond`, `us`, `µs`
|
|
nanoseconds|`nanosecond`, `ns`
|
|
|
|
[`time.Duration`]: https://pkg.go.dev/time#Duration
|
|
[methods]: /methods/duration
|