> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/iot-logic/how-to-implement-event-driven-scheduling-using-unix-time-in-iot-logic.md).

# Como implementar Agendamento orientado a eventos usando tempo Unix no IoT Logic

Nesta seção, configure um temporizador no IoT Logic para controlar a ativação das saídas nos dispositivos. Isso funciona como um agendador, usando o tempo Unix para controle baseado em tempo.

<figure><img src="/files/454c406aed6fc1e45054f27bb5a9034708baf2cb" alt=""><figcaption></figcaption></figure>

Primeiro, a lógica de agendamento foi construída com base no tempo Unix, já que ele é o único parâmetro confiável e consistente em que podemos sempre confiar. O segundo elemento-chave é o carimbo de data e hora dos pacotes válidos recebidos pela plataforma Navixy.\
É importante observar que essa lógica exige que o dispositivo envie continuamente pacotes de dados válidos para a plataforma. A frequência em si não é crítica; no entanto, se nenhuma mensagem de entrada for recebida, torna-se impossível avaliar o tempo ou acionar quaisquer ações agendadas.

\
Agora, passando para o nó de cálculo do atributo de lógica implementado.\
Este nó recupera:

* O horário atual do evento (current\_time) do pacote mais recente
* O horário anterior do evento (prev\_time) do pacote anterior

Ambos os valores são convertidos de milissegundos para segundos.<br>

É importante observar que **genTime** é fornecido em tempo Unix (milissegundos) e deve ser dividido por 1000 para obter o tempo Unix em segundos, que é o formato usado em todos os cálculos.

\
A partir disso, o sistema calcula:

* current\_sod (segundos do dia)
* prev\_sod (segundos do dia do pacote anterior)

Isso é feito usando a operação de módulo, que extrai a quantidade de segundos decorridos desde a meia-noite, convertendo efetivamente o tempo Unix em uma referência de hora do dia.

<pre><code><strong>time % 86400
</strong></code></pre>

Pode-se observar um deslocamento de horário nessas fórmulas. Esse deslocamento é determinado pelo fuso horário UTC em que os cálculos são realizados.

No cenário de teste, os cálculos foram realizados em UTC -6, resultando em uma diferença de 6 horas. Quando convertido em segundos, isso equivale a:\
6 horas × 60 min × 60 s = 21.600 segundos.

{% code overflow="wrap" %}

```
current_sod = (current_time - offset_time) % 86400
prev_sod = (prev_time - offset_time) % 86400
```

{% endcode %}

\
Usando esses valores, o sistema detecta transições de tempo, não estados contínuos.

\
Por exemplo:

* Condição de ativação (por exemplo, 20h):O sistema verifica quando o horário cruza o limite:

  <pre data-overflow="wrap"><code>prev_sod &#x3C; 72000 AND current_sod >= 72000
  </code></pre>
* Condição de desligamento (por exemplo, 5h):

  <pre data-overflow="wrap"><code>prev_sod &#x3C; 18000 AND current_sod >= 18000
  </code></pre>

Isso garante que a ação seja acionada apenas uma vez no momento da transição, em vez de continuamente durante toda a janela de tempo.

\
Quando a lógica é atendida, o nó de ação acionará o comando de saída para alterar o estado da saída.\
Algumas limitações podem surgir ao longo desse fluxo, e é importante destacá-las para que possam ser levadas em consideração:<br>

* **Dependente de dados de entrada:**

Se o dispositivo parar de enviar dados, nenhuma ação é acionada. É por isso que é necessário monitoramento contínuo da unidade. Se o dispositivo estiver desconectado, travado ou em modo de repouso sem enviar dados válidos, a mudança de estado nunca é detectada.<br>

* **Sem garantia de horário exato de execução:**

As ações são executadas quando o próximo pacote de dados chega após o limite ser atingido, não exatamente no horário agendado. Por exemplo, se o dispositivo reporta a cada 5 minutos e o último pacote foi recebido às 20:58, a próxima mensagem chegará às 21:03. Nesse momento, a lógica será atendida e a ação (por exemplo, ativação da saída) será acionada.<br>

* **Tratamento de fuso horário necessário:**

Como o tempo Unix está em UTC, um deslocamento deve ser aplicado para alinhá-lo ao horário local desejado.<br>

* **Sem estado persistente de agendamento:**

O sistema não armazena horários futuros de disparo; ele depende inteiramente de comparações em tempo real entre pacotes de entrada consecutivos.

Esta solução simula um agendador em um sistema orientado a eventos usando carimbos de data e hora Unix e detectando transições de tempo entre pacotes de dados consecutivos. Embora não seja um agendador de verdade, ela oferece uma maneira confiável e escalável de implementar automação baseada em tempo sem exigir suporte nativo a agendamento.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/iot-logic/how-to-implement-event-driven-scheduling-using-unix-time-in-iot-logic.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
