Utile v1 / Timp

Ora curentă

Cât e ora într-o zonă, acum: momentul local, cel UTC, timestampul, decalajul şi dacă e în oră de vară. Implicit, ora Bucureştiului.

GET

https://oneapi.ro/api/utile/v1/timp/acum

Parametri de interogare

NumeTipDescriereValori acceptate

zonaopțional string | null Identificatorul IANA. Implicit UTC. max 64 car.

Cum se comportă

Singura rută din modul care NU se pune în cache, nici măcar un minut: un ceas din cache e un ceas oprit.
saptamana_iso e numărul săptămânii după ISO 8601, unde săptămâna 1 e cea care conține primul joi al anului — nu neapărat cea care conține 1 ianuarie.

La ce folosește

Afișezi ora locală a unui birou dintr-un alt fus, într-un dashboard.
Verifici dacă e o oră rezonabilă pentru un apel automat către un client.
Iei un moment de referință în fusul potrivit, fără să depinzi de ceasul clientului.

Structura răspunsului

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

CâmpTipDescriere

zona string Zona de ofertare sau teritoriul la care se referă datele.

moment string Ora locală, ISO 8601 cu offset.

moment_utc string Același moment, în UTC.

timestamp integer Secunde de la epoca Unix.

offset string Decalajul față de UTC.

ora_de_vara boolean Dacă zona e acum pe ora de vară.

abreviere string Abrevierea fusului în momentul ăsta.

zi_saptamana integer Ziua săptămânii, ISO 8601.

saptamana_iso integer Numărul săptămânii, ISO 8601.

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/acum?zona=Asia/Tokyo

{
    "data": {
        "zona": "Asia/Tokyo",
        "moment": "2026-10-07T05: 39: 54+09: 00",
        "moment_utc": "2026-10-06T20: 39: 54+00: 00",
        "timestamp": 1791319194,
        "offset": "+09: 00",
        "ora_de_vara": false,
        "abreviere": "JST",
        "zi_saptamana": 3,
        "saptamana_iso": 41,
        "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/acum

{
    "data": {
        "zona": "UTC",
        "moment": "2026-10-06T20: 39: 54+00: 00",
        "moment_utc": "2026-10-06T20: 39: 54+00: 00",
        "timestamp": 1791319194,
        "offset": "+00: 00",
        "ora_de_vara": false,
        "abreviere": "UTC",
        "zi_saptamana": 2,
        "saptamana_iso": 41,
        "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/acum?zona=Europe%2FBucharest

{
    "data": {
        "zona": "Europe/Bucharest",
        "moment": "2026-10-06T23: 39: 54+03: 00",
        "moment_utc": "2026-10-06T20: 39: 54+00: 00",
        "timestamp": 1791319194,
        "offset": "+03: 00",
        "ora_de_vara": true,
        "abreviere": "EEST",
        "zi_saptamana": 2,
        "saptamana_iso": 41,
        "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.
422	validare	Fusul cerut 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": "validare",
        "mesaj": "Fusul cerut nu există.",
        "detalii": {
            "zona": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}