如何在 Chart.js 中正确显示两个不同步的时间序列数据集

本文详解如何使用 chart.js 的时间轴（time axis）和对应的时间适配器，将两个采样时间不一致的传感器数据（如 co₂ 测量值）在同一折线图中清晰、准确地并行展示。

在 Chart.js 中绘制多个异步时间序列（即各数据点的时间戳不完全对齐）时，常见误区是直接使用默认的 category 或 linear X 轴类型——这会导致时间解析失败、X 轴不渲染或数据点堆叠在原点（如你遇到的 “X value appeared to be undefined”）。根本解法是显式启用时间轴（type: 'time'）并确保引入并注册对应的时间适配器（如 Chart.js/chartjs-adapter-date-fns 或 chartjs-adapter-moment）。

✅ 正确配置步骤

1. 引入时间适配器（以现代推荐的 date-fns 为例）：

   npm install chart.js chartjs-adapter-date-fns

   并在代码顶部导入（确保自动注册）：

   import { Chart } from 'chart.js';
   import 'chartjs-adapter-date-fns'; // 自动注册适配器

2. 设置 X 轴为 time 类型，并指定时间格式：
   在 options.scales.x 中明确配置：

   options: {
     scales: {
       x: {
         type: 'time',
         time: {
           unit: 'second', // 可选：'millisecond', 'minute', 'hour', 'day', 'month', 'year'
           tooltipFormat: 'HH:mm:ss', // 悬停提示格式
         },
         title: {
           display: true,
           text: 'Time'
         }
       },
       y: {
         title: {
           display: true,
           text: 'CO₂ (ppm)'
         }
       }
     }
   }

3. 保持数据结构为 {x, y} 对象数组（你已做对）：

   data: {
     datasets: [
       {
         label: 'Sensor A',
         data: sensorModulesDict[sensorIDs[0]].map(item => ({
           x: new Date(item.time), // ✅ 强烈建议传入 Date 实例（更可靠）
           y: item.co2
         })),
         borderColor: '#81D929',
         tension: 0.3
       },
       {
         label: 'Sensor B',
         data: sensorModulesDict[sensorIDs[1]].map(item => ({
           x: new Date(item.time),
           y: item.co2
         })),
         borderColor: '#E67417',
         tension: 0.3
       }
     ]
   }

⚠️ 注意事项： 若 item.time 是 Unix 时间戳（毫秒），直接 new Date(item.time) 即可；若是秒级时间戳，请乘以 1000； 避免传入字符串时间（如 "2025-05-20T10:30:00"）而不指定 parser，否则可能因浏览器解析差异导致偏移； 不需手动对齐时间点——Chart.js 时间轴会自动按真实时间位置渲染每个点，即使两组数据时间戳完全不重合（如图中所示的理想效果）； 确保页面中未重复注册适配器，否则可能报错 Adapter already registered。

? 验证与调试技巧

• 在控制台打印任意一个数据点：console.log(data.datasets[0].data[0])，确认 x 是有效 Date 对象（而非 Invalid Date）；
• 检查浏览器控制台是否有 chart.js: time scale needs adapter 类警告——若有，说明适配器未正确加载；
• 使用 scales.x.ticks.maxRotation = 0 防止时间标签倾斜，提升可读性。

通过以上配置，两个独立采样的时间序列将自然分布在统一的时间轴上，各自按真实时间戳定位，实现专业、精准的多源时序对比可视化——这正是你示意图（VUDWP.png）所呈现的效果。