Add/subtract a duration
API · /datetime-api
DateTime API
A fast, fully-local date and time toolkit (UTC): parse any date string or unix timestamp into ISO, unix and components with the ISO week number, day-of-year and leap-year flag; format dates with custom tokens (YYYY-MM-DD, weekday and month names, and more); add or subtract month-aware durations; compute the difference between two dates in every unit plus a human-readable summary; and convert between unix timestamps and ISO. Every endpoint accepts input via the query string or the request body. Pure server-side compute, no third-party upstream, so responses are instant and always available. Ideal for scheduling, billing periods, reminders, analytics and any date arithmetic. (For the current time in a specific timezone, see the oanor Time API.)
API health
healthy- Uptime
- 100.00%
- Server probes · 24h
- Avg latency
- 77 ms
- Server probes · 24h
- Subscribers
- 3,231
- active
- Total calls
- 95
- last 7 days
Pricing
Pick a tier — billed monthly, cancel anytime.
Free
Free
- 18,000 calls / month
- 5 requests / second
- Hard cap (429 above quota, no overage)
- 18,000 requests/month, 5 req/s
- All endpoints: parse, format, add/subtract, diff, convert
- No credit card
Basic
€4.00 /month
- 260,000 calls / month
- 15 requests / second
- Hard cap (429 above quota, no overage)
- 260,000 requests/month, 15 req/s
- Full date-maths suite incl. ISO-week, day-of-year, leap-year
- Commercial use allowed
- Email support
Pro
€13.00 /month
- 1,700,000 calls / month
- 40 requests / second
- Hard cap (429 above quota, no overage)
- 1,700,000 requests/month, 40 req/s
- Month-aware add/subtract and full-unit diff
- Priority email support
- Commercial use allowed
Mega
€35.00 /month
- 9,000,000 calls / month
- 120 requests / second
- Hard cap (429 above quota, no overage)
- 9,000,000 requests/month, 120 req/s
- Highest throughput for bulk batch date processing
- Deterministic UTC compute
- Priority support
Built by
Related APIs
Other APIs with overlapping tags.
Duration API
Work with ISO-8601 durations — the PnYnMnDTnHnMnS strings (P3Y6M4DT12H30M5S, PT1H30M) used across calendars, scheduling, video metadata, billing periods and APIs. Parse a duration into its components and a total in seconds and milliseconds; format a number of seconds (or individual year/month/week/day/hour/minute/second fields) back into a canonical ISO-8601 string; humanise any duration into readable text ("1 hour and 30 minutes"); and measure the exact duration between two instants (ISO timestamps or unix epochs) as both an ISO-8601 string and a precise second count. Years and months use documented calendar averages and are clearly flagged as approximate. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 5 endpoints. Distinct from date/time parsing and relative-time ("3 hours ago") formatting.
api.oanor.com/duration-api
Business Days API
Working-day date math. Count the business days between two dates, add or subtract a number of working days from a date (negative goes backwards), and check whether a given date is a business day — all skipping weekends and any holidays you supply. Configure which days count as the weekend (Saturday/Sunday by default, or e.g. Friday/Saturday) and pass a list of custom holiday dates to exclude. Perfect for SLA and support deadlines, delivery and lead-time estimates, payroll and invoicing periods, and financial settlement dates. Pure local UTC date math — no key, no third-party service, deterministic and instant. Live. 4 endpoints. Distinct from a calendar date toolkit (which counts calendar days) and a holidays directory (which lists holidays).
api.oanor.com/businessdays-api
Block Time API
Convert a timestamp or date into the block number that was live at that moment on any of 100+ blockchains, keyless. On-chain analysts, indexers and dashboards constantly need "what block was chain X at time T" to query historical state, and "which blocks cover this time window" to scan a period. This API answers both — for a single moment and for a date range (returning the start and end block plus the block count and average block time). Live, nothing stored. The timestamp-to-block layer for EVM and non-EVM chains alike. Backed by the open DeFiLlama coins API.
api.oanor.com/blocktime-api
Snowflake ID API
Decode and build snowflake IDs — the 64-bit, time-sortable identifiers used by Twitter/X, Discord, Instagram and many distributed systems. Pass an ID and a platform and the service extracts the embedded creation timestamp (turn any Discord, Twitter/X or Instagram ID into the exact moment it was created) along with the machine and sequence components for that platform's epoch and bit layout. Supported platforms: twitter (X), discord, instagram, sony, and custom (supply your own epoch). The encode endpoint does the reverse: build the lower-bound snowflake for a given timestamp, so you can query "all IDs created at or after this moment" — the standard trick for time-based pagination on snowflake APIs. Everything is computed locally with exact 64-bit BigInt math and no network calls. Ideal for analytics, data forensics, API pagination and debugging distributed-ID systems. A snowflake-ID toolkit — distinct from UUID/ULID generation (uuid) and date/time math (datetime). No upstream key, no cache.
api.oanor.com/snowflake-api
Frequently asked questions
Quick answers about pricing, quotas, and integration.
How do I get an API key for DateTime API?
What's the rate limit for DateTime API?
How much does DateTime API cost?
Can I cancel my subscription anytime?
Is DateTime API GDPR-compliant?
Pick an endpoint from the list on the left to see its details and try it.
Code snippets
Sign up to get an API key, then call any path under your slug.
curl https://api.oanor.com/datetime-api/SOME_PATH \
-H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/datetime-api/SOME_PATH", {
headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/datetime-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);
import requests
r = requests.get(
"https://api.oanor.com/datetime-api/SOME_PATH",
headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())
Ratings
Sign in to rate.
No reviews yet.
Discussion
Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.
Sign in to start a thread or reply.
Sign inNew thread
·
-
Provider answer
🔒 This thread is locked — no new replies.
-
·
- No threads yet — start the discussion.
Support
Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.
Sign in to open a support ticket.
Sign inOpen new ticket
Describe what you need help with. The provider team gets an email and replies on the ticket page.
-
·
Urgent - No tickets yet for this API.