如何在patternfly-timeline的x轴使用Jalali日期替代Gregorian日期
patternfly-timeline 替换为 Jalali 日期的实现方法
实现核心思路
patternfly-timeline 的 x 轴刻度渲染是完全开放可配置的,不需要修改组件源码,只要覆盖原生公历刻度的生成、格式化两个核心环节,就能实现 x 轴的 Jalali 日期展示,且不会影响事件点的定位逻辑。
前置准备
- 引入经过校验的 Jalali 日期换算工具库,别自己写换算逻辑容易出边界 bug,可选用
jalaali-js、date-fns-jalali这类成熟库,安装命令示例:
npm install jalaali-js
分步实现
1. 自定义刻度生成逻辑
组件原生默认基于 d3-time 自动生成公历体系下的间隔刻度,可通过组件配置项替换成自定义生成的 Jalali 体系刻度:
- 保留组件底层基于公历时间戳的线性定位规则,不要改动这部分计算逻辑
- 自定义刻度生成函数接收当前时间轴的时间范围、缩放粒度两个入参,内部先把范围的起始、结束时间戳转成 Jalali 日期,按固定步长累加 Jalali 的时间单位(天/月/年),再把每个刻度节点转成公历时间戳,作为刻度列表返回给组件
- 代码示例:
// 自定义Jalali刻度生成函数 const getJalaliTicks = (timeDomain, granularity) => { const [startTime, endTime] = timeDomain const startJDate = jalaali.toJalaali(new Date(startTime)) const endJDate = jalaali.toJalaali(new Date(endTime)) const tickList = [] // 按粒度(天/月/年)循环累加Jalali单位生成刻度点 // 每个Jalali日期转成对应公历时间戳后存入tickList return tickList }
2. 替换x轴刻度格式化规则
这是实现 x 轴展示 Jalali 日期的核心环节,通过组件暴露的 tickFormatter 配置项,替换掉原生的公历格式化逻辑:
- 函数接收每个刻度点的时间戳,转成 Jalali 日期后按对应粒度拼接成展示文本即可
- 代码示例:
// Jalali格式刻度渲染函数 const formatJalaliTick = (timestamp) => { const date = new Date(timestamp) const jDate = jalaali.toJalaali(date) // 根据当前缩放粒度自动匹配展示格式,避免长文本挤压 // 年粒度返回年份文本、月粒度返回年/月格式、日粒度返回月/日格式 return `${jDate.jy}/${String(jDate.jm).padStart(2, '0')}/${String(jDate.jd).padStart(2, '0')}` }
3. 全粒度逻辑适配
组件支持多粒度的时间轴缩放(小时、天、周、月、年),要为每一种粒度补上对应的 Jalali 刻度生成规则和格式化规则,不然用户缩放时间轴到某个粒度时,会自动切回公历展示。
常见注意事项
- 不要改动组件内部的底层时间计算逻辑,所有事件点的定位依然以公历时间戳为基准,仅替换展示层的刻度文本和刻度点列表就行,不然很容易出现事件点和刻度错位的问题
- 统一日期换算的时区规则,固定用和业务侧一致的时区做 Jalali 换算,避免因不同环境的时区差异导致日期跳变
- 不建议直接改组件源码内置的 d3-time 模块,通过配置项覆盖的方式能大幅降低后续版本升级的维护成本
内容的提问来源于stack exchange,提问作者Melika Bahmanabadi
相关产品推荐
相关产品推荐

