`time.Duration` în Go

Tipul pentru o durată, păstrată în nanosecunde; se scrie ca 90*time.Minute și se afișează ca „1h30m0s”.

Sintaxă

type Duration int64   // nanosecunde

const (
    Nanosecond  Duration = 1
    Microsecond          = 1000 * Nanosecond
    Millisecond          = 1000 * Microsecond
    Second               = 1000 * Millisecond
    Minute               = 60 * Second
    Hour                 = 60 * Minute
)

func (d Duration) String() string
func ParseDuration(s string) (Duration, error)

Ce face `time.Duration`

time.Duration este un int64 care numără nanosecunde. Nu scrii numere de nanosecunde de mână: înmulțești constantele pachetului, de exemplu 2 * time.Hour, 500 * time.Millisecond, time.Hour + 30*time.Minute. Duratele se pot aduna, scădea, compara și împărți între ele.

d.String() (apelat automat de fmt) dă o formă ușor de citit: 1h30m0s, 1.5s, 250ms. Operația inversă este time.ParseDuration("1h30m"), utilă pentru setări citite din fișiere sau din linia de comandă.

Funcțiile care așteaptă, cum sunt time.Sleep, time.After sau context.WithTimeout, primesc toate un time.Duration.

Ce returnează

String(): textul duratei. ParseDuration: durata și o eroare dacă textul nu e valid.

Exemple

Exemplul 1: Construirea și afișarea duratelor

package main

import (
	"fmt"
	"time"
)

func main() {
	film := 2*time.Hour + 15*time.Minute
	pauza := 20 * time.Minute
	fmt.Println("Film:", film)
	fmt.Println("Cu pauză:", film+pauza)
	fmt.Println("Mai lung de 2h:", film > 2*time.Hour)
	fmt.Println("Jumătate:", film/2)
	fmt.Println("Câte pauze încap:", int(film/pauza)) // durată / durată = număr
	fmt.Println(1500*time.Millisecond, 250*time.Millisecond, 3*time.Microsecond)
	fmt.Println("În nanosecunde:", int64(time.Second))
}

Rezultat

Film: 2h15m0s
Cu pauză: 2h35m0s
Mai lung de 2h: true
Jumătate: 1h7m30s
Câte pauze încap: 6
1.5s 250ms 3µs
În nanosecunde: 1000000000

Exemplul 2: Din variabilă int și din text

O variabilă int trebuie convertită la time.Duration înainte de înmulțire. ParseDuration acceptă unitățile h, m, s, ms, us, ns.

package main

import (
	"fmt"
	"time"
)

func main() {
	minute := 45
	d := time.Duration(minute) * time.Minute
	fmt.Println("Ședința:", d)

	for _, text := range []string{"1h30m", "2.5s", "300ms", "90m", "zece"} {
		durata, err := time.ParseDuration(text)
		if err != nil {
			fmt.Println("eroare:", err)
			continue
		}
		fmt.Printf("%-6s -> %v\n", text, durata)
	}
}