# API Acre Timezone Converter

> API Acre Timezone Converter is a paid API for AI agents from apiacre.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-10).

Converts timestamps between IANA time zones with explicit DST gap/overlap handling, transition evidence, and a pinned IANA tzdata release.

## Facts

- Endpoint: POST https://apiacre.com/v1/data/timezone-convert?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-acre-timezone-converter-10f69e52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__WRZrgU6IfidH73LT7a5Q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-acre-timezone-converter-10f69e52 -d '<json body>'
```

Example prompt: Convert 2026-11-01T01:30:00 from America/New_York to Europe/London — it's a repeated hour so use the later interpretation, and include the nearby DST transition details.

## When to prefer this

Choose this endpoint when you need precise, DST-aware timezone conversion with explicit handling of ambiguous repeated hours and spring-forward gaps, especially when you need the IANA tzdata version pinned for auditability, nearby transition evidence, or when your use case requires offset-aware ISO 8601 inputs. Prefer it over generic date libraries when correctness around DST boundaries and traceable tzdata versions matter.

## Known failure modes

- Nonexistent local time during DST spring-forward gap returns an error if ambiguous_time is 'reject'
- Unknown or misspelled IANA timezone identifier causes a validation error
- Malformed ISO 8601 timestamp causes a parse error
- Future timezone rule changes not yet reflected in the pinned tzdata version may produce incorrect results
- Ambiguous repeated-hour times with no disambiguation strategy specified may be rejected

## How this service works

Convert an offset-aware ISO 8601 instant or a local wall time between IANA time zones with explicit DST gap and repeated-hour handling, nearby transition evidence, and a pinned local time-zone database.

## Output

Returns the converted local time in the target timezone with UTC offset, UTC instant, Unix seconds and milliseconds, IANA tzdata database version and release identifier, DST interpretation status (e.g. ambiguous_later), and optionally the previous and next DST transitions for both source and target timezones, plus a limitations disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "timestamp": {
   "type": "string"
  },
  "ambiguous_time": {
   "enum": [
    "reject",
    "earlier",
    "later"
   ],
   "type": "string"
  },
  "source_timezone": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "target_timezone": {
   "type": "string"
  },
  "include_transitions": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "input": {
    "timestamp": "2026-11-01T01:30:00",
    "inputOffset": null,
    "offsetAware": false,
    "sourceTimezone": "America/New_York"
   },
   "source": {
    "isIana": true,
    "timezone": "America/New_York",
    "localTime": "2026-11-01T01:30:00-05:00",
    "utcOffset": "-05:00"
   },
   "target": {
    "isIana": true,
    "timezone": "Europe/London",
    "localTime": "2026-11-01T06:30:00Z",
    "utcOffset": "+00:00"
   },
   "instant": {
    "utc": "2026-11-01T06:30:00Z",
    "unixSeconds": 1793514600,
    "unixMilliseconds": 1793514600000
   },
   "database": {
    "provider": "IANA Time Zone Database",
    "databaseUrl": "https://www.iana.org/time-zones",
    "ianaRelease": "2026c",
    "tzdataPackageVersion": "2026.3"
   },
   "limitations": [
    "IANA time zones represent civil-time rules for representa...",
    "Governments can change future offset and daylight-saving ...",
    "Leap seconds are not represented by Python datetime or th...",
    "Naive nonexistent local times are rejected, and repeated ..."
   ],
   "transitions": {
    "source": {
     "next": {
      "atUtc": "2027-03-14T07:00:00Z",
      "localAfter": "2027-03-14T03:00:00-04:00",
      "localBefore": "2027-03-14T01:59:59-05:00",
      "offsetBeforeSeconds": -18000
     },
     "previous": {
      "atUtc": "2026-11-01T06:00:00Z",
      "localAfter": "2026-11-01T01:00:00-05:00",
      "localBefore": "2026-11-01T01:59:59-04:00",
      "offsetBeforeSeconds": -14400
     }
    },
    "target": {
     "next": {
      "atUtc": "2027-03-28T01:00:00Z",
      "localAfter": "2027-03-28T02:00:00+01:00",
      "localBefore": "2027-03-28T00:59:59Z",
      "offsetBeforeSeconds": 0
     },
     "previous": {
      "atUtc": "2026-10-25T01:00:00Z",
      "localAfter": "2026-10-25T01:00:00Z",
      "localBefore": "2026-10-25T01:59:59+01:00",
      "offsetBeforeSeconds": 3600
     }
    }
   },
   "interpretation": {
    "status": "ambiguous_later",
    "disambiguationApplied": "later"
   },
   "offsetDifferenceSeconds": 18000
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": []
  },
  "service": "data.timezone-convert",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-acre-timezone-converter-10f69e52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)