Time remaining until one configured target date or a list of labelled targets, formatted as Nd Nh / Nh Nm / Nm. Past targets keep rendering as passed so the widget survives the event boundary. Ratio exposes a 30-day approach progress (override with window_days); Calendar highlights the target day within its month.
Timezone used when interpreting target / targets. Omit to follow the system clock.
target
RFC3339 datetime or YYYY-MM-DD
no
—
Single countdown target. Mutually exclusive with targets. Date-only values are treated as UTC midnight.
target_label
string
no
—
Optional label prefixed to the single-target line (e.g. "Ship:").
targets
array of { label, target }
no
—
Multiple labelled countdowns. Rendered as TextBlock by default or Entries when the renderer expects a key/value shape.
window_days
integer (1..=3650)
no
30
Approach window used by Ratio. Progress is (now - (target - window))/window, clamped to 0..=1, so a 30-day window starts filling 30 days out from the target.