indicator-timeline.js 3.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. /**
  2. * 指标时间轴工具函数
  3. * 职责:X 轴抽稀、缺失期合并、日期格式化
  4. * 约束:日期一律走 parseDate,禁止 new Date(string)
  5. */
  6. import { parseDate, formatDate } from './format.js'
  7. import { axisLabelIndices } from './indicator-change.js'
  8. /**
  9. * 合并 points 与 missingPeriods,得到完整的 X 轴日期序列(去重、升序)
  10. * 用于 TrendChart 的 allPeriodDates prop。
  11. *
  12. * @param {Array} points [{ reportDate, ... }]
  13. * @param {Array} missingPeriods [{ reportDate, ... }]
  14. * @returns {string[]} yyyy-MM-dd 字符串数组,升序、去重
  15. */
  16. export function mergePeriodDates(points, missingPeriods) {
  17. var set = {}
  18. ;(points || []).forEach(function(p) {
  19. if (p && p.reportDate) set[p.reportDate] = true
  20. })
  21. ;(missingPeriods || []).forEach(function(m) {
  22. if (m && m.reportDate) set[m.reportDate] = true
  23. })
  24. return Object.keys(set).sort()
  25. }
  26. /**
  27. * 按 allPeriodDates.length 返回要显示标签的下标(复用 indicator-change.js)
  28. * @param {string[]} allPeriodDates 完整日期序列(升序)
  29. * @returns {number[]}
  30. */
  31. export function computeAxisLabelIndices(allPeriodDates) {
  32. var n = (allPeriodDates && allPeriodDates.length) || 0
  33. return axisLabelIndices(n)
  34. }
  35. /**
  36. * 把点集按时间升序排列,返回排序结果与首/末点索引
  37. * @param {Array} points [{ reportDate, numericValue, unit, dateSource, ... }]
  38. * @returns {{firstIdx:number, lastIdx:number, sorted:Array}}
  39. */
  40. export function sortByDate(points) {
  41. if (!points || points.length === 0) return { firstIdx: 0, lastIdx: 0, sorted: [] }
  42. var sorted = points.slice().sort(function(a, b) {
  43. return String(a.reportDate || '').localeCompare(String(b.reportDate || ''))
  44. })
  45. return { firstIdx: 0, lastIdx: sorted.length - 1, sorted: sorted }
  46. }
  47. /**
  48. * 把日期字符串格式化为展示用文案(MM-DD 或 yyyy-MM-dd)
  49. * 走 parseDate 解析,返回格式化后字符串。
  50. *
  51. * @param {string} dateStr 'yyyy-MM-dd' 或 ISO 格式
  52. * @param {boolean} short true → 'MM-DD',false → 'yyyy-MM-dd'
  53. * @returns {string}
  54. */
  55. export function formatAxisDate(dateStr, short) {
  56. if (!dateStr) return ''
  57. var d = parseDate(dateStr)
  58. if (!d) return String(dateStr)
  59. if (short) {
  60. var m = ('0' + (d.getMonth() + 1)).slice(-2)
  61. var day = ('0' + d.getDate()).slice(-2)
  62. return m + '-' + day
  63. }
  64. return formatDate(dateStr)
  65. }
  66. /**
  67. * 判断 points 中是否存在与 latest.unit 不一致的 unit(供 * 标记)
  68. * @param {Array} points
  69. * @param {string} latestUnit
  70. * @returns {boolean}
  71. */
  72. export function hasUnitMismatch(points, latestUnit) {
  73. if (!points || !latestUnit) return false
  74. return points.some(function(p) { return p && p.unit && p.unit !== latestUnit })
  75. }
  76. /**
  77. * 判断是否存在 dateSource 非 real 的观测(用于上传日 * 标记)
  78. * @param {Array} points
  79. * @returns {boolean}
  80. */
  81. export function hasUploadDate(points) {
  82. if (!points) return false
  83. return points.some(function(p) {
  84. return p && p.dateSource && p.dateSource !== 'real' && p.dateSource !== 'unknown'
  85. })
  86. }