READ_RTC

Obtém o valor corrente do relógio/calendário do equipamento associado.

A data e a hora do controlador são retornadas em variáveis do tipo “INT”.

Bloco

   READ_RTC
+-------------+
|          SEC|---- INT
|             |
|          MIN|---- INT
|             |
|         HOUR|---- INT
|             |
|          DAY|---- INT
|             |
|        MONTH|---- INT
|             |
|         YEAR|---- INT
+-------------+

Dica

Para conhecer melhor o recurso e suas funcionalidades acesse o vídeo tutorial: Função READ_RTC.

Nome	Classe	Tipo	Dim.	V. Ini.	Descrição
SEC	Saída	INT			Segundos do RTC [0..59]
MIN	Saída	INT			Minutos do RTC [0..59]
HOUR	Saída	INT			Horas do RTC [0..23]
DAY	Saída	INT			Dia do ano RTC [1..31]
MONTH	Saída	INT			Mês do ano RTC [1..12]
YEAR	Saída	INT			Ano RTC [2000 .. ] a partir do ano 2000

Nota

Se desejar obter a data e hora em uma variável do tipo “DATE_AND_TIME” utilize a função “GET_SYSTIME” da biblioteca HI_STD.

Se desejar obter informação sobre o dia da semana, a mesma pode ser obtida através do recurso de Variáveis de sistema. Através da função GET_SYSVAR é possível obter todas as informações do relógio do controlador além do dia da semana corrente.

Retorno

Tipo Dado	Descrição
INT	Código de retorno da função. Se retornado o valor zero indica que a função foi executada com sucesso e os valores do RTC serão retornados nas variáveis fornecidas. Caso contrário indica falha no processo de leitura do RTC. Neste caso, todas os parâmetros fornecidos retornam com o valor zero.

Exemplo

Declaração de Variáveis

Nome	Tipo	Descrição
cur_seg	INT	Segundos do RTC [0..59]
cur_min	INT	Minutos do RTC [0..59]
cur_hor	INT	Horas do RTC [0..23]
cur_dia	INT	Dia do ano RTC [1..31]
cur_mes	INT	Mês do ano RTC [1..12]
cur_ano	INT	Ano RTC [2000 .. ]
ret_code	INT	Código de retorno da execução da função

Clique aqui para baixar a tabela de variáveis

Código ST

(* ... *)
(* Exemplo de utilização da função READ_RTC na POU *)
ret_code := HILS.READ_RTC(cur_seg, cur_min, cur_hor, cur_dia, cur_mes, cur_ano);
if (ret_code = HILS.SUCCESS) then
  (* Valor do RTC obtido corretamente do controlador *)
  (* ... *)

else
  (* Trata condição de erro no acesso ao RTC do controlador *)
  (* ... *)

end_if
(* ... *)