Date and time API

Return the date or time string your UI needs.

Get a current value or format an input as text, JSON, YAML, XML or JavaScript. Choose the precision and UTC offset; the edge cache expires at the right boundary.

Live examples

Try the live demo workspace.

Same edge setup, same quota logic - just swap <your-id> for your workspace ID. Full parameter lists live in Docs.

  • Precision-aware caching: daily/hourly/minute ticks refresh right before the boundary.
  • Set a numeric UTC offset, or use the current offset from the edge request.
  • Structured responses include validated locale metadata from the query or Accept-Language header.
  • The SVG timer is a separate Unlimited endpoint with a fixed 640x200 canvas.
Live

Omit tz and locale to use the edge timezone offset and Accept-Language metadata detected for the request.

curl "/api/<your-id>/get/date.json"
{
  "entity": "date",
  "value": "2025-02-11",
  "locale": "uk-UA",
  "timezoneOffset": 2,
  "precision": "day"
}

Refreshes at local midnight Cache hits reuse the same quota entry, so most views feel instant and cheap.

Precision
day
Cache TTL
up to 24h
Locale
Detected
* Latency includes your network round-trip from this browser.

What happens on each request

The endpoint resolves access, formats one value and caches it only as long as that value remains current.

Cache until the next tick

A day response expires at local midnight. Hour and minute responses expire at their next boundary. Static conversions cache for seven days.

Browser and backend access

Allow browser origins or server IPs. Backend jobs can sign each request with the workspace signing key instead of placing a secret in a public URL.

Five response formats

Return text, JSON, YAML, XML or a JavaScript module. Use a custom pattern when the caller needs a short value such as YYYY-MM.

Use it without hiding the tradeoffs

The API uses numeric UTC offsets rather than named timezones. It is a fit when you need a display-ready value, not a timezone or geolocation database.

A free allowance that stays free

Each workspace includes 1,000 requests per month. Paid plans remove the monthly cap while keeping a clear per-minute limit. Taxes are calculated at checkout.

One URL per workspace

Create a workspace, set its allowed origins or IPs and call the documented URL. There is no SDK to install and no browser secret to ship.

Countdown SVG when you need one

Unlimited includes a fixed 640x200 SVG countdown with an optional label, colours and count-up mode after the target time.

GetNowDate runs on Cloudflare infrastructure for resilient global access and protection against abusive traffic.

Plans follow request volume

Keep demos on the free allowance. Essential removes the monthly cap with a 180 req/min limit. Unlimited raises the limit to 250 req/min and adds the fixed-size SVG countdown endpoint.

1k free requests

Every workspace keeps a standing 1k monthly allowance for demos, staging or low-volume embeds.

No monthly cap on paid plans

Essential is €147/year at 180 req/min. Unlimited is €347/year at 250 req/min and includes SVG timers.

Timer API coverage

Unlimited adds fixed-size SVG countdowns with labels, colour controls and optional count-up mode.

Pricing by request volume

Compare plans

Upgrade when you outgrow the free allowance.

Plan

Free tier

1k req/workspace

€0

per month

Annual Essential

€147

per year

Unlimited

€347

per year

Monthly quota1k per monthUnlimitedUnlimited
Rate limit60 req/min180 req/min250 req/min
SVG countdown endpointNot availableNot availableIncluded
Action

Questions before you integrate

Response formats, access rules, cache timing and plan limits in plain terms.

What can the API return?

The date endpoint returns current or converted date and time values as text, JSON, YAML, XML or JavaScript. Unlimited also includes a separate SVG countdown endpoint.

How do I get started quickly?

Create a workspace, approve your domains or server IPs and run one of the requests from the docs. Use request signing for backend jobs that cannot rely on a stable IP.

How fresh are cached responses?

Precision decides the TTL. Daily requests refresh at local midnight, hour responses at the next hour and minute or second responses at the next tick. Static conversions cache for seven days. SVG timers refresh every second.

How is access controlled?

Browser calls must match an allowed origin. Server calls can match an allowed IP or use an HMAC signature. The workspace ID identifies the account but is not treated as a secret.

How are payments, taxes and refunds handled?

Annual plans are charged through secure checkout. Displayed prices exclude VAT or duties; applicable taxes are calculated before payment. Refund terms are listed in our Refund policy section.

Which plan should I choose?

Use Free for demos and low-volume embeds. Essential removes the monthly cap with a 180 req/min limit. Unlimited raises that limit to 250 req/min and adds the SVG countdown endpoint.

How exact are the rate limits?

Treat the stated limit as a sustained allowance. Short bursts can vary; if a request returns 429, wait for the Retry-After period before sending more.

Test the exact response before you sign in.

Run the public demo from the docs. If the response shape and cache behaviour fit, create a workspace and add the origins, server IPs or signing key your integration will use.