Countdown

Animated countdown timers with days, hours, minutes, and seconds.

This component requires softui.js for interactive behavior.

Default

00
Years
:
00
Days
:
00
Hours
:
00
Minutes
:
00
Seconds
<!-- Relative date: +2y, +30d, +6h, +45m, +30s (combine: +2y5d or +6h 30m) -->
<!-- or an absolute date: data-date="2028-12-31T00:00:00" -->
<div class="sui-countdown" data-date="+2y5d">
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-years>00</div>
    <span class="sui-countdown-label">Years</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-days>00</div>
    <span class="sui-countdown-label">Days</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-hours>00</div>
    <span class="sui-countdown-label">Hours</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-minutes>00</div>
    <span class="sui-countdown-label">Minutes</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-seconds>00</div>
    <span class="sui-countdown-label">Seconds</span>
  </div>
</div>

<!-- Listen for timer completion (bubbles; the legacy countdown:end also fires) -->
<script>
  document.querySelector('.sui-countdown')
    .addEventListener('sui-countdown-end', function() {
      alert('Timer finished!');
    });
</script>

Primary

00
Days
:
00
Hours
:
00
Minutes
:
00
Seconds
<div class="sui-countdown sui-countdown-primary" data-date="+30d">
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-days>00</div>
    <span class="sui-countdown-label">Days</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-hours>00</div>
    <span class="sui-countdown-label">Hours</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-minutes>00</div>
    <span class="sui-countdown-label">Minutes</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-seconds>00</div>
    <span class="sui-countdown-label">Seconds</span>
  </div>
</div>

Inset

00
Days
:
00
Hours
:
00
Minutes
:
00
Seconds
<div class="sui-countdown sui-countdown-inset" data-date="+30d">
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-days>00</div>
    <span class="sui-countdown-label">Days</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-hours>00</div>
    <span class="sui-countdown-label">Hours</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-minutes>00</div>
    <span class="sui-countdown-label">Minutes</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-seconds>00</div>
    <span class="sui-countdown-label">Seconds</span>
  </div>
</div>

Bordered

00
Days
:
00
Hours
:
00
Minutes
:
00
Seconds
<div class="sui-countdown sui-countdown-bordered" data-date="+30d">
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-days>00</div>
    <span class="sui-countdown-label">Days</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-hours>00</div>
    <span class="sui-countdown-label">Hours</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-minutes>00</div>
    <span class="sui-countdown-label">Minutes</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-seconds>00</div>
    <span class="sui-countdown-label">Seconds</span>
  </div>
</div>

Small

00
Days
:
00
Hours
:
00
Min
:
00
Sec
<div class="sui-countdown sui-countdown-sm" data-date="+30d">
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-days>00</div>
    <span class="sui-countdown-label">Days</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-hours>00</div>
    <span class="sui-countdown-label">Hours</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-minutes>00</div>
    <span class="sui-countdown-label">Min</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-seconds>00</div>
    <span class="sui-countdown-label">Sec</span>
  </div>
</div>

Large

00
Days
:
00
Hours
:
00
Minutes
:
00
Seconds
<div class="sui-countdown sui-countdown-lg sui-countdown-primary" data-date="+30d">
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-days>00</div>
    <span class="sui-countdown-label">Days</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-hours>00</div>
    <span class="sui-countdown-label">Hours</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-minutes>00</div>
    <span class="sui-countdown-label">Minutes</span>
  </div>
  <span class="sui-countdown-separator">:</span>
  <div class="sui-countdown-unit">
    <div class="sui-countdown-value" data-seconds>00</div>
    <span class="sui-countdown-label">Seconds</span>
  </div>
</div>

Reference

Attribute / EventDescription
data-dateISO 8601 date/time (2028-12-31T00:00:00) or relative +<n><y|d|h|m|s>, e.g. +2y5d, +6h 30m.
data-years, data-days, data-hours, data-minutes, data-secondsValue elements the timer fills. Each is optional, but an omitted larger unit is dropped, not carried into the next one.
data-countdown-invalidAdded for an invalid date: units show -- and a console warning is logged.
sui-countdown-endFires (and bubbles) when the timer reaches zero; never for an invalid date. countdown:end also fires.

Delete this item?

This action cannot be undone. This will permanently delete the item and remove all associated data.