Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

Variables · supported

{countdown:2026-12-31 23:59}

Time remaining until a target date/time (YYYY-MM-DD or YYYY-MM-DD HH:MM)

variable.global.countdown · 2.8.0

Browse all entries

Requirements and availability

Values depend on the invocation context; timers and buttons do not have an incoming viewer.

Picker contexts: automation, timer, command, pad.

Variable providers: twitch, youtube, kick, tiktok.

Behavior

Rejoin colon arguments as a date/time. Invalid date returns [invalid date]; elapsed returns Event has passed!; timezone-less input follows host Date parsing.

Contract details

Key: countdown
Syntax: {countdown:2026-12-31 23:59}
Category: Time
Description: Time remaining until a target date/time (YYYY-MM-DD or YYYY-MM-DD HH:MM)
Canonical Key: countdown
Aliases: []
Producer: Global command variable engine, resolved on demand.
Fallback: Unavailable
Fallback Note: This fallback applies on null/error/timeout; a resolver may return its own 0, empty string or descriptive value instead.
Lifetime: Resolved for this template; data may be live, cached or persisted according to its provider.

Examples

A single variable expression; context and data prerequisites still apply.

{countdown:2026-12-31 23:59}

Related entries

Variable resolution

Source and verification

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

server.js — COMMAND_VARIABLE_DEFINITIONS.countdown
src/features/command-variables.js — createCommandVariableEngine

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1