如何在Highcharts Python导出JS前设置X轴为datetime类型？

错误原因 #

• 配置位置错误：xAxis是Highcharts的顶层配置项，不属于系列（series_kwargs）或图表节点（chart_kwargs）的子属性：
  • series_kwargs仅用于配置数据系列的属性（比如系列名称、填充颜色等），将xAxis放在这里会被直接忽略；
  • chart_kwargs对应Highcharts配置中的chart节点（比如图表类型、背景色），xAxis和chart是同级的顶层配置，放在这里无法被正确解析。

解决方法 #

方法一：创建Chart对象后直接修改配置 #

先通过from_pandas生成基础图表，再手动添加xAxis的顶层配置：

import pandas as pd
from highcharts import Chart

# 假设你的数据已存入DataFrame df
chart = Chart.from_pandas(df, series_type='area')
# 添加xAxis的日期类型配置
chart.options['xAxis'] = {'type': 'datetime'}
# 导出为JS字面量文件
chart.to_js_literal('my_js_literal.js')

方法二：生成Chart时直接传入完整配置 #

利用from_pandas的options参数，直接传入包含xAxis的顶层配置：

import pandas as pd
from highcharts import Chart

# 定义完整的图表配置，包含xAxis
chart_options = {
    'xAxis': {'type': 'datetime'},
    # 可添加其他顶层配置，比如yAxis、title等
}

# 生成图表时传入配置
chart = Chart.from_pandas(df, series_type='area', options=chart_options)
chart.to_js_literal('my_js_literal.js')

额外优化：自定义日期格式（可选） #

如果需要更个性化的日期显示格式，可以在xAxis中添加labels.format配置：

chart.options['xAxis'] = {
    'type': 'datetime',
    'labels': {'format': '{value:%Y-%m-%d}'} # 自定义日期格式，比如年-月-日
}

内容的提问来源于stack exchange，提问作者Віктор Ніжурін