Name: timezone-convert
Price: 0.001 USDC
Availability: InStock

$ man timezone-convert

agentutility / locale / timezone-convert

PRICE / CALL

$0.001

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

timezone-convert — timezone convert / iana tz conversion / dst-aware time arithmetic / wall-clock to utc / convert across cities

SYNOPSIS

POST https://x402.org/v1/timezone-convert
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Timezone convert / IANA tz conversion / DST-aware time arithmetic / wall-clock to UTC / convert across cities. Convert a datetime from one IANA timezone to another. ISO-8601 input — bare wall-time strings are interpreted in the from_tz, fully-qualified offsets are honored. DST is handled correctly (uses V8's built-in tzdata via Intl.DateTimeFormat). Returns both formatted strings, both UTC offsets, and the difference in hours.

INPUT — request schema

property	type	description	req?
datetime	string	ISO-8601 datetime. With offset (e.g. '2026-05-08T12:00:00-07:00') it's used as-is; without offset (e.g. '2026-05-08T12:00:00') it's interpreted in from_tz.	required
from_tz	string	IANA timezone for the input wall-time (e.g. 'America/Los_Angeles').	required
to_tz	string	IANA timezone for the output (e.g. 'Asia/Tokyo').	required

OUTPUT — response shape

field	type	description
from	string	Converted datetime formatted in the source IANA timezone with its UTC offset.
to	string	Converted datetime formatted in the target IANA timezone with its UTC offset.
utc_iso	string	Equivalent moment in UTC as an ISO-8601 timestamp with Z suffix.
utc_offset_diff_hours	string	Signed hour difference between the target and source UTC offsets at that instant.
source	string	Identifier of the tzdata source used for the conversion (V8 Intl.DateTimeFormat).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/timezone-convert \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the timezone-convert tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: localetimezonetz-convertiana-tzdstdatetimeutc-offsettimezone-conversion
methods: POST
cluster: locale
price: $0.001 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
timezone-lookup	Timezone lookup / IANA tz / UTC offset / DST status / local time at lat-lng / which timezone.	$0.001
astro-times	sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times.	$0.002
country-info	Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver.	$0.002
earthquakes-recent	Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts.	$0.002
holiday-lookup	Public holidays / bank holidays / national holidays / federal holidays / holiday calendar / per-country dates.	$0.002
sunrise-sunset	Sunrise sunset times.	$0.002
iata-airport-info	IATA / ICAO airport code lookup.	$0.005
satellite-tile	Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery.	$0.005

/timezone-convert(1)