Epoch / ISO converter
POST /api/epoch-convertConvert between Unix epoch timestamps and ISO 8601 date strings in both directions. Provide either an epoch (seconds or milliseconds) or an ISO date string. Returns both representations plus UTC and date components.
Input
| Field | Type | Description |
|---|---|---|
epoch | number | Unix epoch timestamp (seconds or milliseconds) |
date | string | ISO 8601 date string (alternative to epoch) |
unit | string | "seconds" (default) or "milliseconds" - interpretation of the epoch value |
Example output
{
"epoch": {
"seconds": 1782000000,
"milliseconds": 1782000000000
},
"iso": "2026-06-21T00:00:00.000Z",
"utc": "Sun, 21 Jun 2026 00:00:00 GMT",
"components": {
"year": 2026,
"month": 6,
"day": 21,
"hour": 0,
"minute": 0,
"second": 0
}
}
Try it - see the 402 challenge (free)
curl -i -X POST https://agent402.tools/api/epoch-convert \
-H "Content-Type: application/json" \
-d '{"epoch":1782000000}'
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/epoch-convert", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"epoch": 1782000000
}),
});
No wallet? Pay with compute
This is a pure-CPU tool, so an agent without a wallet can pay with proof-of-work instead of USDC: fetch a challenge, solve the sha256 puzzle (16 leading zero bits - a fraction of a second of CPU, no money, no AI tokens), and resend with the X-Pow-Solution header.
import { createHash } from "node:crypto";
const lz = (b) => { let t = 0; for (const x of b) { if (!x) { t += 8; continue; } t += Math.clz32(x) - 24; break; } return t; };
const c = await (await fetch("https://agent402.tools/api/pow/challenge?slug=epoch-convert")).json();
let n = 0;
while (lz(createHash("sha256").update(c.challenge + ":" + n).digest()) < c.difficulty) n++;
await fetch("https://agent402.tools/api/epoch-convert", { method: "POST", headers: { "X-Pow-Solution": c.token + ":" + n, "Content-Type": "application/json" }, body: JSON.stringify({"epoch":1782000000}) });
Related tools
ISO week number
POST /api/iso-weekGet the ISO 8601 week number, ISO day-of-week, quarter, and day-of-year for any date. Useful for fiscal/reporting calend…
Leap year check
POST /api/leap-yearCheck whether a year is a leap year and get related info: days in that year, the next and previous leap years, and the G…
Easter date calculator
POST /api/easter-dateCompute the date of Easter Sunday for a given year using the Anonymous Gregorian algorithm (Meeus/Jones/Butcher). Also r…