Holiday Countdown

Holiday Countdown

Calculates the number of days until a holiday.

Overview

A holiday countdown sensor shows how many days until a specified holiday.

Configuration

1. Select "Holiday Countdown"
2. Configure:
   • Calculation Name: A friendly name
   • Holiday: Select from presets or custom holidays
   • Day Offset: Optional offset to adjust the countdown date
   • Icon: Optional custom icon

Preset Holidays

Pre-configured US holidays:

• New Year's Day
• MLK Jr. Day
• Presidents' Day
• Memorial Day
• Juneteenth
• Independence Day
• Labor Day
• Columbus Day
• Veterans Day
• Thanksgiving
• Christmas

Custom Holidays

Define your own holidays for countdowns. See Custom Holidays for details.

Examples

1. Christmas Countdown

{
  "type": "holiday",
  "name": "Days Until Christmas",
  "holiday": "christmas"
}

2. Birthday Countdown

{
  "type": "holiday",
  "name": "Days Until My Birthday",
  "holiday": "my_birthday"
}

First create "My Birthday" in Custom Holidays section.

3. Adjusted Countdown

{
  "type": "holiday",
  "name": "Days to Thanksgiving Prep",
  "holiday": "thanksgiving",
  "offset": "-7"
}

Offset of -7 means countdown reaches 0 seven days before Thanksgiving.

Automation Examples

automation:
  - alias: "Send holiday reminder"
    trigger:
      platform: numeric_state
      entity_id: sensor.days_until_christmas
      above: 0
      below: 24
      value_template: "{{ value }}"
    action:
      service: notify.mobile_app
      data:
        message: "Only {{ states('sensor.days_until_christmas') }} days until Christmas!"

  - alias: "Holiday is tomorrow"
    trigger:
      platform: numeric_state
      entity_id: sensor.days_until_birthday
      below: 1
    action:
      service: persistent_notification.create
      data:
        message: "Tomorrow is the holiday!"

Display in UI

Create a nice display in Lovelace:

type: custom:banner-card
image: /local/christmas.jpg
title: |
  Only {{ states('sensor.days_until_christmas') }} days!