# Time Convert

> Timezone conversion, current time, date arithmetic, and epoch conversion.

- Skill: `dvcrn/time-convert` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/time-convert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/time-convert/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/time-convert

---


# time-convert

Current time in any timezone, convert between timezones, date math (add/subtract), and ISO 8601 to unix epoch conversion.

## Endpoints

### Current Time

```bash
curl -X POST https://time.agentutil.net/v1/now \
  -H "Content-Type: application/json" \
  -d '{"timezone": "Pacific/Auckland"}'
```

### Timezone Conversion

```bash
curl -X POST https://time.agentutil.net/v1/convert \
  -H "Content-Type: application/json" \
  -d '{"time": "2026-03-04T09:00:00", "from_timezone": "America/New_York", "to_timezone": "Pacific/Auckland"}'
```

### Date Math

```bash
curl -X POST https://time.agentutil.net/v1/math \
  -H "Content-Type: application/json" \
  -d '{"date": "2026-03-04T00:00:00Z", "operation": "add", "value": 7, "unit": "days"}'
```

Units: seconds, minutes, hours, days, weeks, months, years.

### Epoch Conversion

```bash
curl -X POST https://time.agentutil.net/v1/epoch \
  -H "Content-Type: application/json" \
  -d '{"value": 1741046400, "direction": "from_epoch"}'
```

## Response Format

```json
{
  "iso": "2026-03-04T14:30:00.000+13:00",
  "unix": 1741050600,
  "timezone": "Pacific/Auckland",
  "day_of_week": "Wednesday",
  "is_dst": true,
  "request_id": "abc-123",
  "service": "https://time.agentutil.net"
}
```

## Pricing

- Free tier: 10 queries/day, no authentication required
- Paid tier: $0.001/query via x402 protocol (USDC on Base)

## Privacy

No authentication required for free tier. No personal data collected. Rate limiting uses IP hashing only.