time: missing unit in duration "30"
time.ParseDuration a primit un număr fără unitate ("30"). Durata are nevoie de unitate lipită de număr: "30s", "500ms", "5m", "1h30m". Unitățile valide sunt ns, us (µs), ms, s, m, h; zile ("2d") sau "sec" nu există.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
time.ParseDuration citește texte ca "1h30m", "250ms", "-1.5h". Fiecare număr trebuie urmat de o unitate: ns, us sau µs, ms, s, m, h. Un număr singur ("30") dă time: missing unit in duration "30", cu excepția lui "0", care e acceptat.
Unitățile necunoscute dau alt mesaj: time: unknown unit "sec" in duration "30sec", time: unknown unit "d" in duration "2d", time: unknown unit " " in duration "30 s" (spațiul nu e permis). Separatorul zecimal este punctul: "1,5h" dă unknown unit ",".
Eroarea apare de obicei la citirea configurării (variabile de mediu, YAML, flag-uri) unde cineva a scris TIMEOUT=30 gândindu-se la secunde.
De ce apare: cauzele frecvente
1Număr fără unitate în configurare
// TIMEOUT=30
t, err := time.ParseDuration(os.Getenv("TIMEOUT"))// TIMEOUT=30s
t, err := time.ParseDuration(os.Getenv("TIMEOUT"))Scrie unitatea în configurare; e și mai clar pentru cine citește („30s”, nu „30” de ce?).
2Număr de secunde ca întreg
secunde := "30"
t, err := time.ParseDuration(secunde)n, err := strconv.Atoi("30")
t := time.Duration(n) * time.SecondDacă formatul acceptat e un număr de secunde, convertește numărul și înmulțește cu time.Second.
3Zile sau unități în română
t, err := time.ParseDuration("2d")t := 2 * 24 * time.HourParseDuration nu are zile, pentru că o zi nu are mereu 24 de ore (schimbarea orei). Pentru durate fixe, calculează în ore.
Repară eroarea, direct în pagină
Programul citește din configurare intervalul de reîncercare, scris ca "30", și se oprește cu panic: time: missing unit in duration "30". Valoarea înseamnă secunde: transform-o într-o durată corectă ca programul să afișeze Reîncerc după 30s.
package main
import (
"fmt"
"time"
)
func main() {
config := map[string]string{"retry": "30"}
d, err := time.ParseDuration(config["retry"])
if err != nil {
panic(err)
}
fmt.Println("Reîncerc după", d)
}Reîncerc după 30s
Indiciu
Convertește textul în număr cu strconv.Atoi și înmulțește cu time.Second.
Reparația
package main
import (
"fmt"
"strconv"
"time"
)
func main() {
config := map[string]string{"retry": "30"}
n, err := strconv.Atoi(config["retry"])
if err != nil {
panic(err)
}
d := time.Duration(n) * time.Second
fmt.Println("Reîncerc după", d)
}De ce merge
ParseDuration cere o unitate după fiecare număr, iar "30" nu avea. Dacă formatul configurării este „număr de secunde”, citești numărul cu strconv.Atoi și îl transformi în durată: time.Duration(30) * time.Second. La afișare, Duration folosește formatul scurt 30s. O altă reparație ar fi fost scrierea valorii "30s" în configurare.
Alte forme ale mesajului
time: unknown unit "sec" in duration "30sec"time: unknown unit "d" in duration "2d"time: unknown unit " sec" in duration "5 sec"time: invalid duration "abc"time: unknown unit "," in duration "1,5h"
Cum o eviți pe viitor
În configurări păstrează duratele ca text cu unitate ("30s", "5m") și validează-le la pornire, nu la prima folosire. Dacă formatul e un număr, include unitatea în numele cheii (TIMEOUT_SECONDS=30) și convertește cu time.Duration(n) * time.Second. Afișează duratele cu d.String(), care produce exact formatul pe care ParseDuration îl citește înapoi.
Întrebări frecvente
De ce "0" merge fără unitate?
Pentru că zero înseamnă același lucru în orice unitate, așa că ParseDuration("0") îl acceptă ca excepție.
Cum transform o durată în secunde ca număr?
Cu d.Seconds() (un float64) sau int(d / time.Second) pentru secunde întregi.
Erori înrudite
parsing time "15.03.2025" as "2006-01-02": cannot parse "15.03.2025" as "2006" Textul datei nu are formatul dat lui time.Parse. În Go, formatul se scrie cu data de referință 2006-01-02 15:04:05 (nu cu YYYY-MM-DD). Pentru o dată românească 15.03.2025, layout-ul corect este "02.01.2006". strconv.Atoi: parsing "12a": invalid syntax Textul trimis la strconv.Atoi nu este un număr întreg valid: conține litere, spații, zecimale sau e gol. Curăță textul înainte (strings.TrimSpace), folosește ParseFloat pentru zecimale și tratează întotdeauna eroarea întoarsă. context deadline exceeded Operația a durat mai mult decât termenul (timeout) al contextului, iar contextul a fost anulat. Verifică dacă timeout-ul e realist pentru operație, dacă serviciul apelat răspunde lent și tratează eroarea (reîncercare, mesaj clar), în loc să oprești programul. Învață Go de la zero, cu exerciții la fiecare lecție
Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
