Utile v1 / Timp

Detaliu fus orar

O zonă orară întreagă: ora de acum, ţara, decalajul, dacă e în oră de vară şi când e următoarea trecere.

GET

https://oneapi.ro/api/utile/v1/timp/{zona}

Parametri de cale

NumeTipDescriereExemplu

zonaobligatoriu string Numele fusului orar în baza IANA, codat URL (ex. Europe%2FBucharest).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Următoarea trecere se caută pe doi ani înainte. O fereastră mai scurtă ar întoarce null pentru zonele cu o singură schimbare pe an, deși ele au totuși una.
tara e null pentru zonele care nu aparțin unei țări (UTC, Etc/GMT+3).

La ce folosește

Afli, dintr-un singur apel, ora curentă a unui fus și când urmează să se schimbe.
Verifici cărei țări îi aparține un fus primit de la un sistem extern.
Anunți utilizatorii cu ce dată se schimbă ora la ei.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

zona.zona string Zona la care se referă valoarea.

zona.offset string De la a câta înregistrare începe răspunsul.

zona.offset_secunde integer

zona.ora_de_vara boolean Dacă la momentul cerut e în vigoare ora de vară.

zona.abreviere string

zona.acum string Ora locală în momentul cererii.

zona.acum_utc string

zona.tara string Codul țării, sau null la zonele fără țară.

zona.urmatoarea_tranzitie object Următoarea schimbare de oră, sau null dacă zona nu mai are.

zona.urmatoarea_tranzitie.moment_utc string

zona.urmatoarea_tranzitie.moment_local string Când se schimbă, în ora locală de după salt.

zona.urmatoarea_tranzitie.offset string De la a câta înregistrare începe răspunsul.

zona.urmatoarea_tranzitie.ora_de_vara boolean Dacă la momentul cerut e în vigoare ora de vară.

zona.urmatoarea_tranzitie.abreviere string

sursa.nume string Denumirea sursei oficiale.

sursa.versiune string Versiunea setului de date sau a artefactului din care vin valorile.

sursa.licenta string Licenţa sub care sursa permite reutilizarea.

sursa.observatie string Ce trebuie ştiut despre sursă înainte de a folosi datele.

Exemple de răspuns

GEThttps://oneapi.ro/api/utile/v1/timp/Europe%2FBucharest

{
    "data": {
        "zona": {
            "zona": "Europe/Bucharest",
            "offset": "+03: 00",
            "offset_secunde": 10800,
            "ora_de_vara": true,
            "abreviere": "EEST",
            "acum": "2026-10-06T23: 39: 54+03: 00",
            "acum_utc": "2026-10-06T20: 39: 54+00: 00",
            "tara": "RO",
            "urmatoarea_tranzitie": {
                "moment_utc": "2026-10-25T01: 00: 00+00: 00",
                "moment_local": "2026-10-25T03: 00: 00+02: 00",
                "offset": "+02: 00",
                "ora_de_vara": false,
                "abreviere": "EET"
            }
        },
        "sursa": {
            "nume": "IANA Time Zone Database (tzdata), prin runtime-ul PHP",
            "versiune": "2026.3",
            "licenta": "Domeniu public.",
            "observatie": "Se actualizează la un upgrade de imagine, nu printr-un import. Fusurile chiar se schimbă prin decizii politice, uneori cu săptămâni înainte — de aceea versiunea e în răspuns."
        }
    }
}

GEThttps://oneapi.ro/api/utile/v1/timp/Europe%2FLondon

{
    "data": {
        "zona": {
            "zona": "Europe/London",
            "offset": "+01: 00",
            "offset_secunde": 3600,
            "ora_de_vara": true,
            "abreviere": "BST",
            "acum": "2026-10-06T21: 39: 54+01: 00",
            "acum_utc": "2026-10-06T20: 39: 54+00: 00",
            "tara": "GB",
            "urmatoarea_tranzitie": {
                "moment_utc": "2026-10-25T01: 00: 00+00: 00",
                "moment_local": "2026-10-25T01: 00: 00+00: 00",
                "offset": "+00: 00",
                "ora_de_vara": false,
                "abreviere": "GMT"
            }
        },
        "sursa": {
            "nume": "IANA Time Zone Database (tzdata), prin runtime-ul PHP",
            "versiune": "2026.3",
            "licenta": "Domeniu public.",
            "observatie": "Se actualizează la un upgrade de imagine, nu printr-un import. Fusurile chiar se schimbă prin decizii politice, uneori cu săptămâni înainte — de aceea versiunea e în răspuns."
        }
    }
}

GEThttps://oneapi.ro/api/utile/v1/timp/Asia%2FTokyo

{
    "data": {
        "zona": {
            "zona": "Asia/Tokyo",
            "offset": "+09: 00",
            "offset_secunde": 32400,
            "ora_de_vara": false,
            "abreviere": "JST",
            "acum": "2026-10-07T05: 39: 54+09: 00",
            "acum_utc": "2026-10-06T20: 39: 54+00: 00",
            "tara": "JP",
            "urmatoarea_tranzitie": null
        },
        "sursa": {
            "nume": "IANA Time Zone Database (tzdata), prin runtime-ul PHP",
            "versiune": "2026.3",
            "licenta": "Domeniu public.",
            "observatie": "Se actualizează la un upgrade de imagine, nu printr-un import. Fusurile chiar se schimbă prin decizii politice, uneori cu săptămâni înainte — de aceea versiunea e în răspuns."
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	Fusul nu există.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "negasit",
        "mesaj": "Fusul nu există."
    }
}