> 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

Agende ações de saída baseadas em temporizador no IoT Logic usando timestamps Unix. Acione comandos de dispositivos em horários exatos com o envio contínuo de dados do dispositivo ativado.

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 o controle baseado em tempo.

<figure><img src="https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-43ae91462add262dec5bc06a902e2ecea27630c2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Primeiro, a lógica do agendador foi construída com base no tempo Unix, pois ele é o único parâmetro confiável e consistente em que podemos sempre depender. O segundo elemento-chave é o timestamp 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 recebida 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 da lógica implementada.\
Este nó recupera:

* O tempo do evento atual (current\_time) do pacote mais recente
* O tempo do evento anterior (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 para todos os cálculos.

\
A partir deles, o sistema calcula:

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

Isso é feito usando a operação de módulo, que extrai o número 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>

Um deslocamento de tempo pode ser observado 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. Convertido em segundos, isso equivale a:\
6 horas × 60 min × 60 seg = 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 ligar (por exemplo, 20h): O sistema verifica quando o tempo cruza o limite:

  <pre data-overflow="wrap"><code>prev_sod &#x3C; 72000 AND current_sod >= 72000
  </code></pre>
* Condição de desligar (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.

\
Assim que a lógica for 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>

* **Nenhuma 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, e 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á satisfeita 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>

* **Nenhum estado persistente de agendamento:**

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

Esta solução simula um agendador em um sistema orientado a eventos usando timestamps Unix e detectando transições de tempo entre pacotes de dados consecutivos. Embora não seja um verdadeiro agendador, ela oferece uma forma 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.
