获取当前日期 / 业务日期 skill

调用 CLI / SDK 前，继承父技能 §7 初始化的 session-id 与套件 references/manifest.json 中的 version；直接加载时先完成父层初始化。API 命令统一附带 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-dataphin-skills/{session-id} skill-version/{version}"，使用父技能名称与同一会话、版本。

背景知识（必读）

会话上下文中的 system time 不可信：Qoder 等 IDE 在系统提示里给的 "current system time" 是会话创建时刻的快照，与"现在"可能差几小时甚至几天，在跨日 / 跨小时取数场景下产生错位。
Dataphin bizdate 默认 = T-1：Dataphin 调度日 cyctime 凌晨执行，产出业务归属日期 = 调度日 - 1 的数据。命令 / API 中所有 bizdate 入参都按此惯例，除非业务明确"业务日 = 调度日"。
bizdate 是无时区日期串：调度系统按各租户配置时区计算"昨天"，编排时使用 yyyymmdd（无分隔符）或 yyyy-MM-dd（API 文档示例）。

适用场景

补数据：ops create-node-supplement --start-biz-date / --end-biz-date
即席查询 / 手动触发：填 bizdate 入参
任务参数模板替换：${bizdate} / ${yyyymmdd} / ${yyyy-MM-dd}
任何需要"今天 / 昨天 / N 天前"的脚本逻辑

标准取值命令

# 今天（YYYYMMDD）
TODAY=$(date "+%Y%m%d")

# 业务日期 bizdate（T-1）
# macOS / BSD:
BIZDATE=$(date -v-1d "+%Y%m%d")
# Linux / GNU:
BIZDATE=$(date -d "-1 day" "+%Y%m%d")

echo "今天=$TODAY 业务日期(T-1)=$BIZDATE"
# => 今天=20260520 业务日期(T-1)=20260519

跨平台兼容写法（推荐）

# 自动适配 macOS / Linux
if date -v-1d "+%Y%m%d" >/dev/null 2>&1; then
  BIZDATE=$(date -v-1d "+%Y%m%d")          # macOS
else
  BIZDATE=$(date -d "-1 day" "+%Y%m%d")    # Linux
fi

常见格式速查

用途	命令	示例输出
`yyyymmdd`（CLI bizdate）	`date "+%Y%m%d"`	`20260520`
`yyyy-MM-dd`（API 文档示例）	`date "+%Y-%m-%d"`	`2026-05-20`
`yyyy-MM-dd HH:mm:ss`（如 `effective-end`）	`date "+%Y-%m-%d %H:%M:%S"`	`2026-05-20 16:43:19`
完整 ISO + 时区（落地排查）	`date "+%Y-%m-%d %H:%M:%S %Z"`	`2026-05-20 16:43:19 CST`
毫秒时间戳	macOS: `echo $(($(date +%s) * 1000))`；Linux: `date "+%s%3N"`	`1747728199000`
任意 N 天前	macOS: `date -v-Nd "+%Y%m%d"`；Linux: `date -d "-N day" "+%Y%m%d"`	—

✗ 禁止做法

反模式	为什么不行
直接用上下文中的 `current system time: 2026-05-20 ...` 当成"现在"	那是会话创建时刻；如已聊了几小时跨午夜，bizdate 会早 1 天
Agent 凭"训练知识"猜今天日期	训练截止 ≠ 当前；时间观念严重失真
用 `git log -1 --format=%cd` 取最新提交时间	与"现在"无关，且依赖仓库状态

与上下游 skill 衔接

补数据前必跑：见 create-node-supplement.md 章节"完整命令链"步骤 1
授权时填长期有效：--effective-end "3025-12-31 23:59:59"，见 grant-data-source-permission.md
即席查询用 bizdate 过滤：见 execute-ad-hoc-task.md

get-bizdate