Utile v1 / Timp

Current time

What time it is in a zone, right now: the local moment, the UTC one, the timestamp, the offset and whether daylight saving is in force. Bucharest time by default.

GET

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

Query parameters

NameTypeDescriptionAccepted values

zonaoptional string | null The IANA identifier. Defaults to UTC. max 64 car.

How it behaves

The only route in the module that is NOT cached, not even for a minute: a cached clock is a stopped clock.
saptamana_iso is the ISO 8601 week number, where week 1 is the one containing the year's first Thursday — not necessarily the one containing 1 January.

What it is for

Show the local time of an office in another zone, on a dashboard.
Check whether it is a reasonable hour for an automated call to a customer.
Take a reference moment in the right zone, without depending on the client's clock.

Response structure

All fields below live inside data.

FieldTypeDescription

zona string The bidding zone or territory the data refers to.

moment string Local time, ISO 8601 with offset.

moment_utc string The same moment in UTC.

timestamp integer Seconds since the Unix epoch.

offset string The offset from UTC.

ora_de_vara boolean Whether the zone is currently on daylight saving time.

abreviere string The zone abbreviation at this moment.

zi_saptamana integer Day of the week, ISO 8601.

saptamana_iso integer Week number, ISO 8601.

sursa.nume string Name of the official source.

sursa.versiune string Version of the dataset or artefact the values come from.

sursa.licenta string The licence under which the source allows reuse.

sursa.observatie string What to know about the source before using the data.

Response examples

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."
        }
    }
}

Error codes

Code	Slug	When it occurs
401	neautentificat	Token missing, invalid, expired or revoked.
403	feature_indisponibil	The current plan does not include the feature the route depends on.
422	validare	The requested zone does not exist.
429	cota_depasita	The plan's monthly quota has been exceeded (see `Retry-After`).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "The requested zone does not exist.",
        "detalii": {
            "zona": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}