Time Tracker для Home Assistant

Пользовательская интеграция для Home Assistant, которая отслеживает прошедшее или оставшееся время от указанной даты.

Особенности

• ✅ Автоматическое определение направления отсчета (прошлое/будущее)
• ✅ Точные расчеты с учетом високосных годов и разного количества дней в месяцах
• ✅ Поддержка русского языка с правильным склонением
• ✅ Подробная информация в атрибутах (годы, месяцы, дни)
• ✅ Регулярное автоматическое обновление

Установка

Через HACS (рекомендуется)

1. Откройте HACS в панели Home Assistant
2. Перейдите в "Интеграции"
3. Нажмите на три точки в правом верхнем углу → "Пользовательские репозитории"
4. Добавьте репозиторий: https://github.com/dungeon77/time_tracker
5. Выберите категорию "Integration"
6. Нажмите "Добавить"
7. Найдите "Time Tracker" в HACS и установите
8. Перезагрузите Home Assistant

Вручную

1. Скачайте последнюю версию из Releases
2. Скопируйте папку custom_components/time_tracker/ в вашу папку конфигурации Home Assistant
3. Перезагрузите Home Assistant

Настройка

1. Перейдите в Настройки → Устройства и службы → Добавить интеграцию
2. Найдите "Time Tracker"
3. Введите:
   • Название: Имя для вашего счетчика
   • Дата: Выберите дату в формате ДД.ММ.ГГГГ
4. Нажмите "Отправить"

Интеграция автоматически определит, нужно ли считать время до даты (будущее) или от даты (прошлое).

Примеры использования

Отсчет до события

• Название: "До Нового Года"
• Дата: 31.12.2024
• Результат: "осталось 45 дней"

Отсчет от события

• Название: "С дня рождения"
• Дата: 15.05.1990
• Результат: "прошло 12345 дней"

Атрибуты сенсора

Каждый сенсор предоставляет подробную информацию:

• Состояние: Основная информация (например, "осталось 45 дней")
• years: Количество полных лет
• months: Количество полных месяцев
• days: Количество оставшихся дней
• target_date: Целевая дата
• направление: "будущее" или "прошлое"
• всего_дней: Общее количество дней
• использует_dateutil: Используется ли точный расчет

Поддержка

Если у вас возникли проблемы:

1. Проверьте логи Home Assistant на наличие ошибок
2. Убедитесь, что дата введена в правильном формате
3. Создайте Issue на GitHub с описанием проблемы

Разработка

Хотите помочь с развитием интеграции? Форки и PR приветствуются!

Лицензия

Этот проект распространяется под лицензией MIT. См. файл LICENSE для подробностей.