Docker 原生命令不直接支持“显示容器已运行多久”（如 up 12 minutes），但可通过 docker inspect 提取启动时间戳，并结合系统时间计算精确运行时长。本文提供可直接执行的 Shell 方案及健壮性处理建议。
如何精准获取 docker 容器的运行时长（秒级/分钟级）？docker 原生命令不直接支持“显示容器已运行多久”（如 `up 12 minutes`），但可通过 `docker inspect` 提取启动时间戳，并结合系统时间计算精确运行时长。本文提供可直接执行的 shell 方案及健壮性处理建议。
Docker CLI 并未内置类似 docker ps --format "{{.UpTime}}" 的原生字段，但其 inspect 命令完整暴露了容器状态数据，其中 .State.StartedAt 即为 ISO 8601 格式的 UTC 启动时间戳。我们可借助 Shell 工具链（如 date、awk）完成时间差计算，实现类似 up 2 hours 17 minutes 的人类可读输出。
✅ 推荐一键式 Shell 函数（支持单容器 ID 或名称）：
docker_uptime() {
local cid="$1"
if [ -z "$cid" ]; then
echo "Usage: docker_uptime <container_id_or_name>" >&2
return 1
fi
# 检查容器是否正在运行（避免解析已停止容器的 StartedAt）
local status=$(docker container inspect --format='{{.State.Status}}' "$cid" 2>/dev/null)
if [ "$status" != "running" ]; then
echo "Error: Container '$cid' is not running (status: $status)" >&2
return 1
fi
# 获取启动时间戳（UTC）
local started_at=$(docker container inspect --format='{{.State.StartedAt}}' "$cid" 2>/dev/null | cut -d'.' -f1) # 移除纳秒部分以兼容 GNU date
if [ -z "$started_at" ]; then
echo "Error: Failed to retrieve StartedAt for '$cid'" >&2
return 1
fi
# 转换为 Unix 时间戳（秒），并计算差值
local start_sec=$(date -d "$started_at" +%s 2>/dev/null)
local now_sec=$(date +%s)
local elapsed=$((now_sec - start_sec))
# 格式化输出（支持天/小时/分钟/秒）
local days=$((elapsed / 86400))
local hours=$(((elapsed % 86400) / 3600))
local mins=$(((elapsed % 3600) / 60))
local secs=$((elapsed % 60))
if [ $days -gt 0 ]; then
echo "up ${days}d ${hours}h ${mins}m"
elif [ $hours -gt 0 ]; then
echo "up ${hours}h ${mins}m ${secs}s"
elif [ $mins -gt 0 ]; then
echo "up ${mins}m ${secs}s"
else
echo "up ${secs}s"
fi
}</container_id_or_name>
? 使用示例：
# 添加到 ~/.bashrc 或 ~/.zshrc 后重载 shell source ~/.bashrc docker_uptime my-web-app # 输出：up 3h 22m 15s docker_uptime 9f8a2c1e # 输出：up 1d 4h 8m
⚠️ 注意事项与最佳实践：
-
时区安全：
.State.StartedAt始终为 UTC，而date默认使用本地时区；上述脚本通过date -d自动解析 ISO 时间，无需手动时区转换； -
健壮性校验：函数首先检查容器状态是否为
running，避免对已退出或创建未启动的容器错误计算（其StartedAt可能为空或为零值）； -
精度权衡：Docker 启动时间精度为纳秒级，但实际业务中秒级足够；脚本截断纳秒部分以确保
date -d兼容性（尤其在 macOS 上需用gdate替代）； -
批量查询扩展：如需批量统计，可结合
docker ps -q与循环调用，或改用 Python/Go 等语言实现更复杂逻辑（例如自动排序、阈值告警）。
总结：虽然 Docker 没有开箱即用的 --uptime 参数，但通过组合 inspect + 时间计算，即可构建轻量、可靠、可复用的运行时监控能力——这正是容器运维自动化中“小工具解决大问题”的典型实践。
