node-red-contrib-knx-ultimate/nodes/locales/it/knxUltimateDateTime.html

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.

<script type="text/markdown" data-help-name="knxUltimateDateTime">
# KNX DATA/ORA

Usa questo nodo per **impostare data/ora sul bus KNX**.

Può inviare:
- **DPT 19.001** su una singola *GA Data/Ora* (consigliato).
- **DPT 11.001** su una *GA Data* (opzionale).
- **DPT 10.001** su una *GA Ora* (opzionale).

Puoi configurare uno o più indirizzi di gruppo: il nodo scrive su tutti quelli configurati.

Nota su **DPT 19.001**:
- il nodo parte da una `Date` JavaScript e la converte in telegramma KNX DateTime tramite l'engine KNX.

## Quando invia

- **Al deploy/avvio** (opzionale, con ritardo).
- **Invio periodico** (opzionale).
- **All'arrivo di un input** (sempre).
- **Pulsante in editor** (invio immediato).

## Payload in ingresso

Se `msg.payload` è assente/vuoto, il nodo invia l'ora corrente di sistema.

Payload supportati:
- `new Date()` (consigliato)
- numero timestamp (millisecondi dall'epoch)
- stringa accettata da `new Date("...")`
- `"now"`
- oggetto con uno di questi campi:
  - `msg.payload.dateTime`
  - `msg.payload.timestamp`
  - `msg.payload.epoch`

Esempio:

```js
msg.payload = new Date();
return msg;
```

## Gateway non connesso

Se il gateway KNX non è connesso, l'invio viene messo in coda e parte appena torna la connessione.
Il nodo mantiene **una sola richiesta pendente** (l'ultima ricevuta).

## Output

Il nodo emette un messaggio ad ogni invio:
- `msg.payload`: la `Date` inviata
- `msg.sent`: array di `{ ga, dpt, name }`
- `msg.reason`: `input`, `startup`, `periodic` o `button`
- `msg.knxUltimateDateTime.date`: data/ora in formato ISO (`toISOString()`)

</script>