# Time

> 时间工具 — 获取当前 UTC/本地时间、可控延时。当 Agent 需要知道当前时间或等待时使用。

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

---


# 时间工具 (Time)

基础时间查询和延时功能。

## 插件路径

`plugins/time/`

## 注册工具

| 工具 | 用途 |
|------|------|
| `get_time` | 获取当前 UTC 和本地时间（含时区偏移） |
| `sleep` | 休眠指定秒数（上限 30 分钟 / 1800 秒） |

## 参数

### sleep

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `seconds` | number | 是 | 休眠秒数，范围 1-1800 |

## 结果说明

- `get_time`：返回当前 UTC 时间和本地时间（含时区偏移信息）
- `sleep`：休眠结束后返回（无特殊输出）
- 参数越界：返回 `ERROR:` 前缀的错误信息

## 常见规范

- `sleep` 不受全局 `tool.tool_timeout` 截断，但自身保留 1800 秒硬上限
- 用于用户明确要求"等一会儿"、"稍后继续"、"延迟执行"的场景
- `get_time` 用于需要知道当前时间、计算时间差、判断时区的场景

## 常见处理办法

- **seconds 超出范围**：范围 1-1800，超出会报错
- **sleep 阻塞时间过长**：最大 30 分钟，如需更长等待建议用定时任务

## 常见教训

- `sleep` 会阻塞当前工具调用线程，不要用于不需要实际等待的场景
- `get_time` 返回的是服务器时间，不是用户本地时间（尽管通常含本地时区偏移）