Bull-Board 中的日期时间格式自定义指南

概述

Bull-Board 是一个流行的 Bull 任务队列可视化工具，它默认使用英文环境下的日期时间显示格式。在实际开发中，开发者可能需要根据项目需求或团队习惯调整日期时间的显示格式。本文将详细介绍如何在 Bull-Board 中自定义日期时间格式。

默认日期时间格式

Bull-Board 默认使用基于浏览器的本地化日期时间格式，对于英文环境通常显示为类似 "May 16, 2024, 3:45 PM" 这样的格式。这种格式虽然可读性好，但在某些技术场景下可能不够直观。

自定义日期时间格式

Bull-Board 提供了通过 boardOptions.uiConfig 配置对象来自定义日期时间格式的功能。开发者可以设置三种不同粒度的日期时间显示格式：

1. 短格式 (short): 仅显示时间部分
2. 常用格式 (common): 显示月份缩写和日期加时间
3. 完整格式 (full): 显示完整的年月日和时间

配置示例

dateFormats: {
  short: `hh:mm:ss`,          // 仅显示时间，如 15:45:30
  common: `MMM-dd hh:mm:ss`,  // 显示月份缩写-日期 时间，如 May-16 15:45:30
  full: `yyyy-MM-dd hh:mm:ss` // 显示完整年月日 时间，如 2024-05-16 15:45:30
}

格式说明符

配置中使用的是标准的日期时间格式符号，以下是常用符号的含义：

• yyyy: 四位数的年份 (如 2024)
• MM: 两位数的月份 (01-12)
• MMM: 月份的缩写 (如 Jan, Feb)
• dd: 两位数的日期 (01-31)
• hh: 24小时制的小时 (00-23)
• mm: 分钟 (00-59)
• ss: 秒 (00-59)

实际应用场景

1. 技术日志查看: 在查看任务队列日志时，使用 yyyy-MM-dd hh:mm:ss 格式可以更清晰地排序和比较时间戳。
2. 国际化支持: 虽然本文以英文环境为例，但同样的配置方法适用于其他语言环境。
3. 团队规范统一: 当团队有统一的日期时间显示规范时，可以通过此配置保持一致性。

注意事项

1. 配置更改后需要重启 Bull-Board 服务才能生效。
2. 格式字符串区分大小写，使用错误的符号可能导致显示异常。
3. 建议在开发环境和生产环境保持一致的日期时间格式配置。

通过以上配置，开发者可以轻松地将 Bull-Board 的日期时间显示调整为更适合技术场景的格式，提升任务队列管理的效率和体验。