blob: f9c26d294e34762dbff4fb9a48cfd31a86ddbb2f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
---
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
|
