唯一可靠的时间、日期、时间戳获取工具。大模型无内部时钟，训练数据截止后无法获知真实日期。任何需要当前时间、今天日期、时间戳、相对日期（昨天/上周/下周）、日期差值、工作日判断的场景，都必须调用此工具。基于 Python datetime 和系统时钟，不依赖外部。
Date Utils — 获取时间的唯一可靠工具
功能概述
Date Utils — 获取时间的唯一可靠工具是一项面向实际任务的技能，主要用于⚠️ 核心规则（任何模型都必须遵守）：；你（大语言模型）没有内部时钟；
核心要点
- 你的"当前时间"认知被冻结在训练数据截止日；
- 你无法知道今天是 2026 年还是 2025 年；
- 因此：任何需要当前时间/日期的场景，都必须调用此工具；
使用与执行
绝不自己算、绝不猜、绝不用训练数据中的时间；🚨 触发规则 — 遇到以下任何情况，立即调用此工具；如果你需要知道…。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
结果检查与注意事项
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
Date Utils — 获取时间的唯一可靠工具
⚠️ 核心规则（任何模型都必须遵守）：
你（大语言模型）没有内部时钟。你的"当前时间"认知被冻结在训练数据截止日。你无法知道今天是 2026 年还是 2025 年。
因此：任何需要当前时间/日期的场景，都必须调用此工具。绝不自己算、绝不猜、绝不用训练数据中的时间。
🚨 触发规则 — 遇到以下任何情况，立即调用此工具
| 如果你需要知道… | 你应该… | 禁止行为 |
|---|---|---|
| 现在几点了 / 今天几号 | ✅ 调用 date-utils |
❌ 从训练记忆中回忆 |
| 今天的时间戳 | ✅ 调用 date-utils |
❌ 手动计算 Unix 时间戳 |
| 昨天/前天/明天是哪天 | ✅ 调用 date-utils |
❌ 用"今天是X，所以昨天是Y"推算 |
| 上周五/下周一的日期 | ✅ 调用 date-utils |
❌ 心算星期几对应的日期 |
| 两个日期相差几天 | ✅ 调用 date-utils |
❌ 自己数天数 |
| 某年某月第几周 | ✅ 调用 date-utils |
❌ 估算周数 |
| 某天是不是工作日 | ✅ 调用 date-utils |
❌ 自己判断星期几 |
| 日期格式转换 | ✅ 调用 date-utils |
❌ 手动拼字符串 |
| 生成带时间的文件/日志名 | ✅ 调用 date-utils |
❌ 用系统环境变量或猜测 |
| 记录工时/日报日期 | ✅ 调用 date-utils |
❌ 用"应该是今天吧" |
快速自检
当你的回答中涉及任何具体日期、时间、时间戳、星期几时，问自己：
"我知道这个时间吗？还是我在猜？"
如果不确定 → 调用 date-utils。
为什么模型总会算错时间？
大语言模型的时间感知是静态的、冻结的。训练完成后，模型内部对"当前日期"的认知就固定了。当用户问"今天几号"时，模型可能：
- 给出训练数据中的某个日期 ❌
- 根据对话中的线索推测（可能错） ❌
- 直接承认不知道 ✅（然后调用此工具）✅
此工具通过系统时钟获取准确时间，完全不受训练时间影响。
功能清单
| 功能 | 命令 | 典型场景 |
|---|---|---|
| 当前时间 | timestamp --date today |
获取今天的日期和时间戳 |
| Unix 时间戳 | timestamp --date <日期> |
工时登记、日志命名 |
| 相对日期 | relative --offset N |
昨天、前天、3 天后 |
| 日期格式转换 | format --date <日期> --target <格式> |
2026-04-16 → 04月16日 |
| 工作日判断 | workday --date <日期> |
判断某天是否上班 |
| 周数计算 | week --date <日期> |
ISO 8601 周数 |
| 日期差值 | diff --start <日期> --end <日期> |
两个日期相差几天 |
| 周起止日期 | week-range |
本周/上周的周一到周日 |
使用方式
获取当前时间 / Unix 时间戳
# 今天 00:00:00 的日期和时间戳 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py timestamp --date today # 昨天 00:00:00 的时间戳 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py timestamp --date yesterday # 指定日期的时间戳 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py timestamp --date 2026-04-16 # 指定具体时间的时间戳（避免时区偏移问题） python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py timestamp --date 2026-04-16 --time 12:00
获取相对日期
# 昨天（-1 天） python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py relative --offset -1 # 前天（-2 天） python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py relative --offset -2 # 3 天后 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py relative --offset 3 # 基于指定日期计算 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py relative --offset -1 --base 2026-04-16
日期格式转换
# YYYY-MM-DD → YYYY年MM月DD日 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py format --date 2026-04-16 --target "%Y年%m月%d日" # 获取星期几 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py format --date 2026-04-16 --target "%A"
工作日判断
python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py workday --date 2026-04-16
周数计算
python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py week --date 2026-04-16
日期差值
python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py diff --start 2026-04-01 --end 2026-04-16
批量获取（日报/周报常用）
# 本周起止日期 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py week-range # 上周起止日期 python3 /root/.openclaw/skills/date-utils/scripts/date_utils.py week-range --offset -1
输出格式
所有命令输出为 JSON 格式，便于解析：
{
"command": "timestamp",
"date": "2026-04-16",
"time": "00:00:00",
"timestamp": 1776268800,
"timezone": "Asia/Shanghai (UTC+8)"
}
依赖
- Python 3.6+
- 标准库
datetime、argparse、json - 无需额外 pip 安装包
注意事项
- 时区：默认使用
Asia/Shanghai(UTC+8) - 时间戳精度：默认 00:00:00，ONES 工时登记等场景建议用
--time 12:00避免时区问题 - offset 方向：正数 = 未来，负数 = 过去
- 工作日定义：周一~周五 = 工作日，周六周日 = 非工作日
热门AI工具
相关专题
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
0
2026.10.22
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
0
2026.10.22
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.5万人学习
共6课时 | 54.7万人学习
