Bloco de Função TIMESWITCH_GET

O bloco de função TIMESWITCH_GET retorna todas as informações de um evento de um relógio programável.

Aviso: O relógio programável deve estar armazenado no mesmo elemento.

Entrada TIMESWITCH

Aqui, o banco de dados do relógio é armazenado como uma string. Este deve existir como um bloco de função TIMESWITCH. Observe também a ordem do programa para que este bloco de função seja inicializado corretamente.

Entrada ID

Define o ID como uma string do evento.

Saída ERR

Em caso de erro, a saída é definida como verdadeira. Isso pode ocorrer se o calendário não existir ou se o ID não estiver definido ou for inválido.

Saída TITLE

Retorna o título do evento.

Saída DT_START

O momento de início do evento no formato DT# é retornado.

Saída DT_END

O momento de término do evento no formato DT# é retornado.

Saída DIS

Se a saída for verdadeira, o evento está desativado e será ignorado pelo programa de tempo.

Saída REPEAT

A saída retorna as repetições como uma string. Estas correspondem às funções auxiliares REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY e REPEAT_HOURLY.

A string pode ser separada por dois pontos ou construída da seguinte forma:

w:2:4:135

O primeiro dígito (minúsculo) define o intervalo de tempo da repetição:

Abreviação	Intervalo De Tempo
h	Horário
d	Diário
w	Semanal
m	Mensal
y	Anual

O segundo dígito define o intervalo como um inteiro da repetição. O valor mínimo é 1.

O terceiro dígito define o fim da repetição. Aqui, três formatos diferentes podem ser definidos:

• Sem valor: A repetição é infinita.
• Como um inteiro simples: A repetição termina após o número definido de repetições.
• Como uma data AAAA-MM-DD: A repetição é encerrada antes da data.

O quarto dígito define os dias da semana em que a repetição ocorre. Este dígito é usado apenas na definição de repetições semanais ou mensais.

Repetições Semanais

Verifica se o dia da semana atual está presente no número. Vários dias podem ser especificados um após o outro. Por exemplo, 135 para segunda-feira, quarta-feira e sexta-feira. Se nenhum valor for especificado (0 ou uma string vazia), a repetição não ocorrerá em nenhum dia.

Número	Dia Da Semana
1	Segunda-Feira
2	Terça-Feira
3	Quarta-Feira
4	Quinta-Feira
5	Sexta-Feira
6	Sábado
7	Domingo

Repetições Mensais

Define em qual dia da semana o evento deve ser repetido. São suportados números de -1 a 4. 0 ou nenhuma declaração repete mensalmente no mesmo dia, independentemente do dia da semana. O dia da semana é assumido a partir da primeira data.

Valor	Descrição
-1	Repete no último dia da semana.
0	Repete no mesmo dia. (Padrão)
1	Repete no primeiro dia da semana.
2	Repete no segundo dia da semana.
3	Repete no terceiro dia da semana.
4	Repete no quarto dia da semana.

Saída DT_MODIFY

A saída define a última alteração no formato DT#. Esta entrada também pode ser indefinida se o evento foi criado antes da versão 5.0.