开发工具【免费下载链接】spaceship-prompt✨ Minimalistic, powerful and extremely customizable Zsh prompt项目地址https://gitcode.com/gh_mirrors/sp/spaceship-prompt点击查看免费下载time是 Spaceship 提示符Zsh prompt中负责显示当前时间戳的内置 Section默认隐藏需要显式开启。本文以官方文档 docs/sections/time.md 为核心骨架结合 sections/time.zsh 与 lib/section.zsh 的源码实现完整讲解该 Section 的启用方式、时间格式定制、全部配置项以及它在整个 prompt 渲染流水线中的工作位置。读完本文你将能够独立配置出符合需求的 12 小时制、带毫秒或任意 strftime 格式的时间戳并理解其底层渲染原理。Section 概述与默认行为timeSection 的作用非常单一在 prompt 上显示命令提示符出现时的时间戳。它可以用于追踪命令执行的历史时刻便于复盘操作过程区分长时间终端会话中不同时段的操作配合exec_time命令执行时长Section精确掌握每条命令发生的时间点。需要注意该 Section 默认是隐藏的SPACESHIP_TIME_SHOW默认为false源码 sections/time.zsh 中明确声明SPACESHIP_TIME_SHOW${SPACESHIP_TIME_SHOWfalse}而函数体的第一行守卫逻辑也与此对应sections/time.zsh[[ $SPACESHIP_TIME_SHOW false ]] return也就是说只要SPACESHIP_TIME_SHOW不是true该 Section 直接返回不产生任何渲染开销。启用 time Section在~/.zshrc中加入如下配置即可显示时间戳SPACESHIP_TIME_SHOWtrue开启后提示符最左侧time位于默认 prompt 顺序的首位会出现类似at 21:14:33的内容其中at是该 Section 的默认前缀prefix21:14:33是默认的时间内容。关于配置文件的更多说明可参考 docs/config/intro.md 中创建配置文件的部分。时间格式定制12 小时制am/pm如果你习惯美式 12 小时制只需开启SPACESHIP_TIME_12HRSPACESHIP_TIME_12HRtrue开启后显示效果类似at 09:14:33 PM。源码中的实现逻辑非常直观sections/time.zshif [[ -n $SPACESHIP_TIME_FORMAT ]]; then time_str${SPACESHIP_TIME_FORMAT} elif [[ $SPACESHIP_TIME_12HR true ]]; then time_str%D{%r} else time_str%D{%T} fi可以看到12 小时制实际使用的是 Zsh 的%r格式符而默认 24 小时制使用的是%T。注意文档勘误docs/sections/time.md 正文中该变量写作SPACESHIP_TIME_12HOUR但代码示例与 sections/time.zsh 源码中实际的变量名均为SPACESHIP_TIME_12HR。使用时请以SPACESHIP_TIME_12HR为准。自定义任意格式SPACESHIP_TIME_FORMAT通过SPACESHIP_TIME_FORMAT可以使用 Zsh 支持的任何日期时间格式。它采用%D{...}语法包裹内部为 strftime 风格格式符。官方文档给出的示例为毫秒级时间戳SPACESHIP_TIME_FORMAT%D{%H:%M:%S.%.}常见格式符速查均为 Zsh prompt expansion 标准支持格式符含义示例%T24 小时制HH:MM:SS21:14:33%r12 小时制带 am/pm09:14:33 PM%H小时00–2321%M分钟00–5914%S秒00–5933%.毫秒123%F日期YYYY-MM-DD2026-09-20%y两位年份26%m月份01–1209%d日01–3120因此你可以组合出诸如%D{%F %T}2026-09-20 21:14:33这类带日期的完整时间戳。格式符的具体定义对应 Zsh 官方文档 Prompt Expansion 一章中的 Date and time 小节。优先级规则从源码if / elif / else分支可见SPACESHIP_TIME_FORMAT的优先级最高——只要非空即采用它其次才是SPACESHIP_TIME_12HR两者都未设置时退回默认的%D{%T}。选项总览变量默认值含义SPACESHIP_TIME_SHOWfalse是否显示该 Section设为true启用SPACESHIP_TIME_PREFIXat·实际值为at 末尾带空格Section 的前缀SPACESHIP_TIME_SUFFIX$SPACESHIP_PROMPT_DEFAULT_SUFFIXSection 的后缀SPACESHIP_TIME_COLORyellowSection 的颜色SPACESHIP_TIME_FORMAT-空自定义时间格式SPACESHIP_TIME_12HRfalse是否使用 12 小时制am/pm以上默认值均可在源码 sections/time.zsh 中得到验证。几个值得注意的细节文档表格中的at·是文档排版中用于可视化空格的写法源码中的真实默认值是at at加一个空格见 sections/time.zsh。SPACESHIP_TIME_SUFFIX默认继承 prompt 级全局变量SPACESHIP_PROMPT_DEFAULT_SUFFIX其默认值为单个空格 定义见 docs/config/prompt.md 的 Prompt-level options 表格。颜色支持 Zsh 基本颜色名如yellow、red、green或 256 色颜色码。源码级原理从配置到渲染1. 时间字符串的构造spaceship_time()函数sections/time.zsh只做两件事根据上文提到的优先级分支构造time_str然后调用统一的 Section 打包函数spaceship::section \ --color $SPACESHIP_TIME_COLOR \ --prefix $SPACESHIP_TIME_PREFIX \ --suffix $SPACESHIP_TIME_SUFFIX \ $time_str注意time不携带 symbol图标内容$time_str本身就是时间字符串。由于%D{...}属于 Zsh prompt 扩展语法实际的时间展开发生在 zsh 渲染 prompt 时而不是函数调用时——这也是该 Section 轻量、无需外部命令的原因。2. Section 的打包与渲染spaceship::sectionlib/section.zsh将color / prefix / suffix / symbol / content打包成一个用·|·分隔的元组字符串spaceship::section::renderlib/section.zsh再将其还原并拼装为带 ANSI 转义的真实渲染串颜色通过%F{$color}包裹lib/section.zsh前缀与后缀在渲染时以粗体输出并受全局开关SPACESHIP_PROMPT_PREFIXES_SHOW/SPACESHIP_PROMPT_SUFFIXES_SHOW控制lib/section.zsh若 content 与 symbol 均为空则整个 Section 不渲染lib/section.zsh。3. 在 prompt 顺序中的位置time位于默认SPACESHIP_PROMPT_ORDER的第一位见 docs/config/prompt.md 中的默认顺序列表因此它默认会显示在 prompt 的最左侧。渲染时lib/core.zsh 的spaceship::core::compose_order按顺序遍历 prompt order从缓存中取出每个 Section 的渲染结果并拼接成最终 prompt。两个与位置相关的全局行为值得留意SPACESHIP_PROMPT_FIRST_PREFIX_SHOW默认为false即第一个 Section 的前缀会被隐藏。因此开启time后如果它是 prompt 第一项at前缀可能不会显示。若希望显示可设置SPACESHIP_PROMPT_FIRST_PREFIX_SHOWtrue若希望时间显示在右侧 prompt可将time加入SPACESHIP_RPROMPT_ORDER默认空数组例如SPACESHIP_RPROMPT_ORDER(time)完整配置示例下面是一份可直接放入~/.zshrc的完整示例涵盖启用、12 小时制与自定义格式三种场景# 场景一最简启用24 小时制黄色 SPACESHIP_TIME_SHOWtrue # 场景二12 小时制 SPACESHIP_TIME_SHOWtrue SPACESHIP_TIME_12HRtrue # 场景三自定义格式带日期与毫秒并覆盖颜色与前缀 SPACESHIP_TIME_SHOWtrue SPACESHIP_TIME_FORMAT%D{%F %T.%.} SPACESHIP_TIME_COLORcyan SPACESHIP_TIME_PREFIXnow 将变量写入~/.zshrc后重新加载配置source ~/.zshrc或新开终端窗口即可看到效果。若你通过spaceship add time命令将time加入 prompt 顺序命令用法见 docs/config/loading-sections.md同样需要先设置SPACESHIP_TIME_SHOWtrue才会实际显示。常见问题Q设置了SPACESHIP_TIME_SHOWtrue但没有看到时间检查SPACESHIP_PROMPT_FIRST_PREFIX_SHOW与顺序因素外还需确认time确实存在于SPACESHIP_PROMPT_ORDER中默认存在。若时间显示在行首但没有前缀属于上文提到的“首个 Section 前缀默认隐藏”行为。QSPACESHIP_TIME_12HOUR设置无效正确变量名是SPACESHIP_TIME_12HR。文档正文中的SPACESHIP_TIME_12HOUR为笔误请以源码与本文为准。Q为什么没有毫秒默认格式%D{%T}不含毫秒需要毫秒需显式设置SPACESHIP_TIME_FORMAT%D{%H:%M:%S.%.}。Q能否只显示日期不显示时间可以。SPACESHIP_TIME_FORMAT%D{%F}即可输出2026-09-20格式的日期。如需了解 Section 机制更通用的设计prefix/suffix/color 的通用约定、自定义 Section 的开发方法可进一步阅读 docs/config/prompt.md 与 docs/advanced/creating-section.md。赞分享开发工具【免费下载链接】spaceship-prompt✨ Minimalistic, powerful and extremely customizable Zsh prompt项目地址https://gitcode.com/gh_mirrors/sp/spaceship-prompt点击查看免费下载相关推荐Spaceship Prompt 的 time 时间段隐藏时间戳段的配置、格式化与源码原理Spaceship Prompt 的 time 时间段隐藏时间戳段的配置、格式化与源码原理 导读 本文聚焦 Spaceship Prompt 内置的 time开发工具Spaceship Prompt 用户段user section完全指南显示逻辑、SPACESHIP_USER_SHOW 配置与源码级原理Spaceship Prompt 用户段user section完全指南显示逻辑、SPACESHIP_USER_SHOW 配置与源码级原理 导读 user开发工具Spaceship Prompt 的 Package 版本显示 Section配置指南与源码级原理解析Spaceship Prompt 的 Package 版本显示 Section配置指南与源码级原理解析 package 是 Spaceship Prompt开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Spaceship Prompt Time 时间戳 Section 完全指南：启用、格式化与源码级原理
开发工具【免费下载链接】spaceship-prompt✨ Minimalistic, powerful and extremely customizable Zsh prompt项目地址https://gitcode.com/gh_mirrors/sp/spaceship-prompt点击查看免费下载time是 Spaceship 提示符Zsh prompt中负责显示当前时间戳的内置 Section默认隐藏需要显式开启。本文以官方文档 docs/sections/time.md 为核心骨架结合 sections/time.zsh 与 lib/section.zsh 的源码实现完整讲解该 Section 的启用方式、时间格式定制、全部配置项以及它在整个 prompt 渲染流水线中的工作位置。读完本文你将能够独立配置出符合需求的 12 小时制、带毫秒或任意 strftime 格式的时间戳并理解其底层渲染原理。Section 概述与默认行为timeSection 的作用非常单一在 prompt 上显示命令提示符出现时的时间戳。它可以用于追踪命令执行的历史时刻便于复盘操作过程区分长时间终端会话中不同时段的操作配合exec_time命令执行时长Section精确掌握每条命令发生的时间点。需要注意该 Section 默认是隐藏的SPACESHIP_TIME_SHOW默认为false源码 sections/time.zsh 中明确声明SPACESHIP_TIME_SHOW${SPACESHIP_TIME_SHOWfalse}而函数体的第一行守卫逻辑也与此对应sections/time.zsh[[ $SPACESHIP_TIME_SHOW false ]] return也就是说只要SPACESHIP_TIME_SHOW不是true该 Section 直接返回不产生任何渲染开销。启用 time Section在~/.zshrc中加入如下配置即可显示时间戳SPACESHIP_TIME_SHOWtrue开启后提示符最左侧time位于默认 prompt 顺序的首位会出现类似at 21:14:33的内容其中at是该 Section 的默认前缀prefix21:14:33是默认的时间内容。关于配置文件的更多说明可参考 docs/config/intro.md 中创建配置文件的部分。时间格式定制12 小时制am/pm如果你习惯美式 12 小时制只需开启SPACESHIP_TIME_12HRSPACESHIP_TIME_12HRtrue开启后显示效果类似at 09:14:33 PM。源码中的实现逻辑非常直观sections/time.zshif [[ -n $SPACESHIP_TIME_FORMAT ]]; then time_str${SPACESHIP_TIME_FORMAT} elif [[ $SPACESHIP_TIME_12HR true ]]; then time_str%D{%r} else time_str%D{%T} fi可以看到12 小时制实际使用的是 Zsh 的%r格式符而默认 24 小时制使用的是%T。注意文档勘误docs/sections/time.md 正文中该变量写作SPACESHIP_TIME_12HOUR但代码示例与 sections/time.zsh 源码中实际的变量名均为SPACESHIP_TIME_12HR。使用时请以SPACESHIP_TIME_12HR为准。自定义任意格式SPACESHIP_TIME_FORMAT通过SPACESHIP_TIME_FORMAT可以使用 Zsh 支持的任何日期时间格式。它采用%D{...}语法包裹内部为 strftime 风格格式符。官方文档给出的示例为毫秒级时间戳SPACESHIP_TIME_FORMAT%D{%H:%M:%S.%.}常见格式符速查均为 Zsh prompt expansion 标准支持格式符含义示例%T24 小时制HH:MM:SS21:14:33%r12 小时制带 am/pm09:14:33 PM%H小时00–2321%M分钟00–5914%S秒00–5933%.毫秒123%F日期YYYY-MM-DD2026-09-20%y两位年份26%m月份01–1209%d日01–3120因此你可以组合出诸如%D{%F %T}2026-09-20 21:14:33这类带日期的完整时间戳。格式符的具体定义对应 Zsh 官方文档 Prompt Expansion 一章中的 Date and time 小节。优先级规则从源码if / elif / else分支可见SPACESHIP_TIME_FORMAT的优先级最高——只要非空即采用它其次才是SPACESHIP_TIME_12HR两者都未设置时退回默认的%D{%T}。选项总览变量默认值含义SPACESHIP_TIME_SHOWfalse是否显示该 Section设为true启用SPACESHIP_TIME_PREFIXat·实际值为at 末尾带空格Section 的前缀SPACESHIP_TIME_SUFFIX$SPACESHIP_PROMPT_DEFAULT_SUFFIXSection 的后缀SPACESHIP_TIME_COLORyellowSection 的颜色SPACESHIP_TIME_FORMAT-空自定义时间格式SPACESHIP_TIME_12HRfalse是否使用 12 小时制am/pm以上默认值均可在源码 sections/time.zsh 中得到验证。几个值得注意的细节文档表格中的at·是文档排版中用于可视化空格的写法源码中的真实默认值是at at加一个空格见 sections/time.zsh。SPACESHIP_TIME_SUFFIX默认继承 prompt 级全局变量SPACESHIP_PROMPT_DEFAULT_SUFFIX其默认值为单个空格 定义见 docs/config/prompt.md 的 Prompt-level options 表格。颜色支持 Zsh 基本颜色名如yellow、red、green或 256 色颜色码。源码级原理从配置到渲染1. 时间字符串的构造spaceship_time()函数sections/time.zsh只做两件事根据上文提到的优先级分支构造time_str然后调用统一的 Section 打包函数spaceship::section \ --color $SPACESHIP_TIME_COLOR \ --prefix $SPACESHIP_TIME_PREFIX \ --suffix $SPACESHIP_TIME_SUFFIX \ $time_str注意time不携带 symbol图标内容$time_str本身就是时间字符串。由于%D{...}属于 Zsh prompt 扩展语法实际的时间展开发生在 zsh 渲染 prompt 时而不是函数调用时——这也是该 Section 轻量、无需外部命令的原因。2. Section 的打包与渲染spaceship::sectionlib/section.zsh将color / prefix / suffix / symbol / content打包成一个用·|·分隔的元组字符串spaceship::section::renderlib/section.zsh再将其还原并拼装为带 ANSI 转义的真实渲染串颜色通过%F{$color}包裹lib/section.zsh前缀与后缀在渲染时以粗体输出并受全局开关SPACESHIP_PROMPT_PREFIXES_SHOW/SPACESHIP_PROMPT_SUFFIXES_SHOW控制lib/section.zsh若 content 与 symbol 均为空则整个 Section 不渲染lib/section.zsh。3. 在 prompt 顺序中的位置time位于默认SPACESHIP_PROMPT_ORDER的第一位见 docs/config/prompt.md 中的默认顺序列表因此它默认会显示在 prompt 的最左侧。渲染时lib/core.zsh 的spaceship::core::compose_order按顺序遍历 prompt order从缓存中取出每个 Section 的渲染结果并拼接成最终 prompt。两个与位置相关的全局行为值得留意SPACESHIP_PROMPT_FIRST_PREFIX_SHOW默认为false即第一个 Section 的前缀会被隐藏。因此开启time后如果它是 prompt 第一项at前缀可能不会显示。若希望显示可设置SPACESHIP_PROMPT_FIRST_PREFIX_SHOWtrue若希望时间显示在右侧 prompt可将time加入SPACESHIP_RPROMPT_ORDER默认空数组例如SPACESHIP_RPROMPT_ORDER(time)完整配置示例下面是一份可直接放入~/.zshrc的完整示例涵盖启用、12 小时制与自定义格式三种场景# 场景一最简启用24 小时制黄色 SPACESHIP_TIME_SHOWtrue # 场景二12 小时制 SPACESHIP_TIME_SHOWtrue SPACESHIP_TIME_12HRtrue # 场景三自定义格式带日期与毫秒并覆盖颜色与前缀 SPACESHIP_TIME_SHOWtrue SPACESHIP_TIME_FORMAT%D{%F %T.%.} SPACESHIP_TIME_COLORcyan SPACESHIP_TIME_PREFIXnow 将变量写入~/.zshrc后重新加载配置source ~/.zshrc或新开终端窗口即可看到效果。若你通过spaceship add time命令将time加入 prompt 顺序命令用法见 docs/config/loading-sections.md同样需要先设置SPACESHIP_TIME_SHOWtrue才会实际显示。常见问题Q设置了SPACESHIP_TIME_SHOWtrue但没有看到时间检查SPACESHIP_PROMPT_FIRST_PREFIX_SHOW与顺序因素外还需确认time确实存在于SPACESHIP_PROMPT_ORDER中默认存在。若时间显示在行首但没有前缀属于上文提到的“首个 Section 前缀默认隐藏”行为。QSPACESHIP_TIME_12HOUR设置无效正确变量名是SPACESHIP_TIME_12HR。文档正文中的SPACESHIP_TIME_12HOUR为笔误请以源码与本文为准。Q为什么没有毫秒默认格式%D{%T}不含毫秒需要毫秒需显式设置SPACESHIP_TIME_FORMAT%D{%H:%M:%S.%.}。Q能否只显示日期不显示时间可以。SPACESHIP_TIME_FORMAT%D{%F}即可输出2026-09-20格式的日期。如需了解 Section 机制更通用的设计prefix/suffix/color 的通用约定、自定义 Section 的开发方法可进一步阅读 docs/config/prompt.md 与 docs/advanced/creating-section.md。赞分享开发工具【免费下载链接】spaceship-prompt✨ Minimalistic, powerful and extremely customizable Zsh prompt项目地址https://gitcode.com/gh_mirrors/sp/spaceship-prompt点击查看免费下载相关推荐Spaceship Prompt 的 time 时间段隐藏时间戳段的配置、格式化与源码原理Spaceship Prompt 的 time 时间段隐藏时间戳段的配置、格式化与源码原理 导读 本文聚焦 Spaceship Prompt 内置的 time开发工具Spaceship Prompt 用户段user section完全指南显示逻辑、SPACESHIP_USER_SHOW 配置与源码级原理Spaceship Prompt 用户段user section完全指南显示逻辑、SPACESHIP_USER_SHOW 配置与源码级原理 导读 user开发工具Spaceship Prompt 的 Package 版本显示 Section配置指南与源码级原理解析Spaceship Prompt 的 Package 版本显示 Section配置指南与源码级原理解析 package 是 Spaceship Prompt开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考