Altair时间轴标签重复问题：UTC年月格式条形图异常排查

问题描述 #

我用Altair创建X轴为时间类型的条形图，使用utcyearmonth格式化后，X轴标签出现重复值。尝试过将轴类型修改为nominal、ordinal、quantitative，也移除了scale配置，但问题仍未解决。

相关代码：

serie_temporal = alt.Chart(base_filtrada).mark_bar(size=60).encode(
    x=alt.X(
        'utcyearmonth(Data):T', 
        axis=alt.Axis(format="%Y %B"),
        scale = alt.Scale(nice={'interval': 'month', 'step': 1})
    ),
    y='sum(Valor):Q',
    color='Tipo de despesa'
).properties(
    height=400
)

异常效果：

解决方案 #

出现重复标签的核心原因是：utcyearmonth虽能将日期聚合到月份维度，但如果原始数据中同一月份存在多个日期条目，Altair默认可能为每个日期生成独立刻度，导致同一月份标签重复显示。以下是几种可行的解决方法：

1. 明确指定聚合方式
   在X轴编码中添加aggregate参数，确保每个月份只生成一个数据点，避免重复刻度：

serie_temporal = alt.Chart(base_filtrada).mark_bar(size=60).encode(
    x=alt.X(
        'utcyearmonth(Data):T', 
        axis=alt.Axis(format="%Y %B"),
        aggregate='mean'  # 按月份聚合，也可使用count等其他聚合方式
    ),
    y='sum(Valor):Q',
    color='Tipo de despesa'
).properties(
    height=400
)

2. 转换为名义型（Nominal）字段
   将日期聚合结果转为名义型字段，确保每个月份仅对应一个标签：

serie_temporal = alt.Chart(base_filtrada).mark_bar(size=60).encode(
    x=alt.X(
        'utcyearmonth(Data):N',  # 将时间聚合结果转为名义型
        axis=alt.Axis(format="%Y %B")
    ),
    y='sum(Valor):Q',
    color='Tipo de despesa'
).properties(
    height=400
)

也可以在数据预处理阶段直接生成格式化后的月份字符串，再传入Altair，逻辑更直观。

3. 强制控制刻度数量与标签角度
   若聚合后仍有重复，可通过tickCount强制设置刻度数量，同时调整labelAngle避免标签重叠：

serie_temporal = alt.Chart(base_filtrada).mark_bar(size=60).encode(
    x=alt.X(
        'utcyearmonth(Data):T', 
        axis=alt.Axis(format="%Y %B", tickCount='month', labelAngle=45),
        scale=alt.Scale(nice={'interval': 'month'})
    ),
    y='sum(Valor):Q',
    color='Tipo de despesa'
).properties(
    height=400
)

内容的提问来源于stack exchange，提问作者Lucas Alponti