# Locale and Formatting Tools – Format Date/Time

> Locale and Formatting Tools – Format Date/Time is a paid API for AI agents from locale-tools.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Formats a date/time instant into a localized, DST-aware string for a given IANA timezone, BCP47 locale, and date/time style.

## Facts

- Endpoint: GET https://locale-tools.x402tookit.com/format-date?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locale-and-formatting-tools-format-date-time-66782e48
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1sv0MMrVzBxw6BlLyQnek

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 locale-and-formatting-tools-format-date-time-66782e48
```

Example prompt: Format the timestamp 2024-06-15T14:30:00Z as a full-style date and long-style time in the America/Chicago timezone using the fr-FR locale.

## When to prefer this

Use this endpoint when you need a fully localized, DST-aware date/time string for a specific IANA timezone and BCP47 locale — especially when you need the UTC offset, calendar system metadata, or CLDR version alongside the formatted output. Prefer this over manual string formatting when serving international users who require culturally correct date presentation.

## Known failure modes

- Invalid or unrecognized IANA timezone returns an error or falls back to UTC with degraded=true
- Malformed ISO 8601 or out-of-range epoch value returns a parsing error
- Unknown BCP47 locale tag may fall back to en-US with degraded=true
- Date string longer than 40 characters is rejected
- Timezone string longer than 60 characters is rejected

## How this service works

Show an instant in an IANA timezone and locale with full/long/medium/short styles; DST-aware, with UTC offset.

## Output

Returns a formatted date/time string for the requested locale and timezone, along with the resolved locale, IANA timezone, UTC offset, epoch milliseconds, calendar system, numbering system, CLDR/ICU/Unicode versions, and a degraded flag if fallback formatting was used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "ISO 8601 (2024-01-15T12:00:00Z; no zone means UTC) or epoch milliseconds, up to 40 characters"
      },
      "locale": {
       "type": "string",
       "description": "BCP47 tag such as en-US, de-DE, ja-JP (default en-US)"
      },
      "timeZone": {
       "type": "string",
       "description": "IANA zone such as America/New_York or Asia/Kolkata (default UTC, up to 60 characters)"
      },
      "dateStyle": {
       "type": "string",
       "description": "full, long, medium (default) or short"
      },
      "timeStyle": {
       "type": "string",
       "description": "Optional full, long, medium or short to include the time"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "parts": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "type": {
          "type": [
           "null",
           "string"
          ]
         },
         "value": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "locale": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "epochMs": {
       "type": [
        "null",
        "number"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ]
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "calendar": {
       "type": [
        "null",
        "string"
       ]
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locale-and-formatting-tools-format-date-time-66782e48/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from locale-tools.x402tookit.com](https://www.zero.xyz/host/locale-tools.x402tookit.com/llms.txt)