Epoch / ISO converter

Convert 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