mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
30 lines
1 KiB
Markdown
30 lines
1 KiB
Markdown
---
|
|
title: time.ParseDuration
|
|
description: Parses a given duration string into a `time.Duration` structure.
|
|
categories: [functions]
|
|
keywords: []
|
|
menu:
|
|
docs:
|
|
parent: functions
|
|
function:
|
|
aliases: []
|
|
returnType: time.Duration
|
|
signatures: [time.ParseDuration DURATION]
|
|
relatedFunctions:
|
|
- time.AsTime
|
|
- time.Duration
|
|
- time.Format
|
|
- time.Now
|
|
- time.ParseDuration
|
|
aliases: [/functions/time.parseduration]
|
|
---
|
|
|
|
`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:
|
|
|
|
```go-html-template
|
|
{{ printf "There are %.0f seconds in one day." (time.ParseDuration "24h").Seconds }}
|
|
<!-- Output: There are 86400 seconds in one day. -->
|
|
```
|