Time series foundation models (TSFMs) increasingly offer covariate support, with calendar information being the most common type of categorical covariate in practice, as it is available for every point in time. However, how these features are encoded is largely treated as an implementation detail rather than as an object of study, despite encoding being one of the few design choices left for pretrained models at inference time. With the present study, we demonstrate that the way information is propagated into the model substantially affects forecast accuracy of TSFMs. Therefore, we systematically compare seven calendar encodings, including three conventional target-agnostic representations (ordinal, one-hot, and cyclic) and four target encodings, across four state-of-the-art TSFMs on nine datasets from multiple domains in a zero-shot rolling evaluation. The nine datasets are influenced by social activities, such as weekends and holidays, making calendar information particularly relevant for forecasting. We find that encoding choice affects forecast accuracy across all models, with MASE differences of up to 9.9 % on non-holidays and 83 % on holidays within a single model. Effectiveness and utilization vary substantially across models. Improvements are concentrated around holidays, where calendar information provides signals unavailable from target history, while some model encoding combinations also improve non-holiday forecasts. A SHAP-based attribution analysis locates the contribution of the covariates relative to the autoregressive component and explains why some model-encoding combinations degrade performance. Our findings suggest that current benchmarks for covariate-informed TSFMs can distort model comparisons by imposing fixed encoding strategies.
Figures & tables
Encoding
Holiday
Representation
Dim.
Assumption
ordinal h,W + bin H
binary flag
ordinal (0–23; 0–6) + flag
3
–
one-hot h,W + bin H
binary flag
one-hot (24+7)+ flag
32
–
cyclic h,W + bin H
binary flag
sin/cos + flag
5
Hour and week follow fixed periodicity.
Th,W(H=Sun)
→ Sunday
joint target encoding
1
Public holiday ≈ Sunday.
Th,W(H=7)
8th weekday
joint target encoding
1
Holidays are distinct from Sundays.
Th,W,H
binary flag
joint target encoding
1
Captures weekday-specific holiday effects.
Table 1: Calendar encodings. All variants use hour (h), weekday (W), and holiday (H) information, differing in their representation and combination.
All days
Holidays only
Non-holidays only
Model
Encoding
MASE
SQL
MASE
SQL
MASE
SQL
Baselines
seasonal-naive (168h)
1.0362
0.9984
2.9358
2.6207
0.9682
0.9404
Th,W(H=Sun)naive
1.1050
0.9468
1.5369
1.3182
1.0882
0.9322
Chronos-2
w/o covariates
0.6903
0.5534
2.2299
1.9242
0.6353
0.5044
ordinal h,W + bin H
0.6760
0.5381
1.5630
1.2854
0.6440
0.5111
one-hot h,W + bin H
0.7099
0.5690
2.0244
1.7294
0.6626
0.5272
Table 2: Overall results across all datasets, split by day type (mean over 9 datasets).
Figure 1: Pairwise win rate in MASE, as the share of the nine datasets won by the row encoding.
Figure 2: MASE change relative to the TSFM w/o covariates, averaged over nine datasets. Vertical lines indicate the mean, and horizontal lines the interquartile range (25th–75th percentile). Most models improve on holidays independently of the encoding, while results on non-holidays are mixed.
Figure 3: Share of the mean absolute SHAP value for the Th,W(H=7) and Th,W+Th,H encodings, averaged across datasets. Covariates contribute 20–34 % on holidays but at most 14 % on non-holidays. With Th,W+Th,H , most holiday contribution moves to Th,H , except for TiRex-2.
Figure 4: Hourly forecasts and SHAP values for a holiday and a non-holiday from m_dense with Th,W+Th,H . Upper panels: median forecast, target, and SHAP contributions relative to the base prediction f(∅) . Lower panels: Th,W and Th,H contributions on a separate scale. Units: vehicles per hour. On the holiday, Th,H lowers the forecast for all models except TiRex-2, which overpredicts.
Appendix figures & tables37 assets
Supplementary material from the paper’s appendix.
Appendix
Figure 5: The ordinal h,W + bin H encoding with its three resulting covariates.
Figure 6: The one-hot h,W + bin H encoding with its 32 resulting covariates.
Figure 7: The cyclic h,W + bin H encoding with its five resulting covariates.
Figure 8: The Th,W(H=Sun) target encoding using the categories hour and weekday, with holidays mapped to Sunday.
Figure 9: The Th,W(H=7) target encoding using the categories hour and weekday, with holidays treated as a separate weekday.
Figure 10: The Th,W,H target encoding using the categories hour, weekday and holiday.
Figure 11: The Th,W+Th,H encoding consisting of two separate target encodings.
Name
Category
Description
Test Period
Reference
m_dense
Traffic
Madrid traffic intensity aggregated over 30 sensors.
2019-01 – 2019-12
Jiang et al. (2024)
mta_subway
Transport
New York City subway ridership aggregated over all stations.