# Time

> Answer questions about current time, timezone-aware time lookup, date arithmetic, and date differences.

- Skill: `zgiai/time` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zgiai/time`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zgiai/time/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: zgiai (https://skillmd.com/u/zgiai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zgiai/time

---


# Time Skill

Use this skill for current time and date calculation tasks.

## Workflow

1. For current time or today's date, call `call_skill_tool` with `tool_name` set to `current_time`.
2. For date addition, date subtraction, deadlines, or date differences, call `call_skill_tool` with `tool_name` set to `date_calculate`.
3. Always include the relevant timezone in the final answer when current time or today is involved.
4. Do not guess current time or today's date without calling the tool.

## Tool Usage

`current_time` accepts:

- `timezone`: IANA timezone such as `UTC`, `Asia/Shanghai`, or `America/New_York`.
- `format`: strftime-style output format such as `%Y-%m-%d %H:%M:%S`.

`date_calculate` accepts:

- `operation`: `add`, `subtract`, or `diff`.
- `base_date`: date in `YYYY-MM-DD` format, or omitted for today.
- `amount`: integer amount for add or subtract.
- `unit`: `day`, `week`, `month`, or `year`.
- `target_date`: required for `diff`.
- `timezone`: IANA timezone used when `base_date` is omitted.