# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-05-17
# Nächste Prüfung: 2026-11-17

CLOCK - Uhrzeit-Anzeige
=======================

Zeigt die aktuelle Uhrzeit bei CLI-Ausgaben an.

CLI-BEFEHLE
-----------

  bach clock on              Uhrzeit-Anzeige aktivieren
  bach clock off             Uhrzeit-Anzeige deaktivieren
  bach clock status          Aktuellen Status zeigen
  bach clock interval <sek>  Intervall in Sekunden setzen

INTERVALL
---------

  interval 0    Uhrzeit bei JEDER Ausgabe
  interval 60   Uhrzeit nur wenn >= 60 Sekunden seit letzter Anzeige
  interval 300  Uhrzeit alle 5 Minuten

AUSGABE-FORMAT
--------------

  [CLOCK] 14:35

PERSISTENZ
----------

  Datei: data/.clock_state

  Inhalt:
  {
    "enabled": true,
    "interval": 60,
    "last_shown": "2026-01-30T14:35:00"
  }

BEISPIELE
---------

  # Uhrzeit bei jeder Ausgabe
  bach clock on
  bach clock interval 0

  # Uhrzeit alle 5 Minuten
  bach clock interval 300

  # Status prüfen
  bach clock status
  -> Clock: AN | Intervall: 60s | Letzte: 14:35

ZUSAMMENSPIEL
-------------

Clock ist Teil des Zeit-Systems:
  --help timer      Stoppuhr
  --help countdown  Countdown mit Trigger
  --help between    Between-Checks
  --help beat       Unified Zeit-Anzeige

Alle Zeit-Funktionen werden via `bach beat` zusammengefasst.

---
Version: 1.0 | Status: Implementiert (v1.1.83)
Siehe: docs/CONCEPT_time_system.md
