READ_RTC

Obtém o valor corrente do relógio/calendário (RTC) do equipamento associado, retornando data e hora em variáveis separadas do tipo INT; é uma função.

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

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

A função entrega segundos, minutos, horas, dia, mês e ano em seis variáveis INT distintas. O valor retornado pela função é o código de resultado da leitura (ver Retorno / Saídas).

Dica

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

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.

Parâmetros

Nome	Direção	Tipo	Faixa / Unidade	Descrição
SEC	OUT	INT	`0 .. 59`	Segundos do RTC.
MIN	OUT	INT	`0 .. 59`	Minutos do RTC.
HOUR	OUT	INT	`0 .. 23`	Horas do RTC.
DAY	OUT	INT	`1 .. 31`	Dia do mês do RTC.
MONTH	OUT	INT	`1 .. 12`	Mês do ano do RTC.
YEAR	OUT	INT	`>= 2000`	Ano do RTC (a partir do ano 2000).

Retorno / Saídas

A função retorna um INT com o código de resultado da leitura: 0 (HILS.SUCCESS) indica que a leitura foi bem-sucedida e os seis parâmetros carregam os valores válidos do RTC. Qualquer valor diferente de zero indica falha no processo de leitura; nesse caso todos os parâmetros de saída retornam com o valor zero. Lista completa: RET_CODE - Códigos de retorno do firmware G5.

Pré-condições

O equipamento deve possuir relógio/calendário (RTC) operacional.

Observações

Em caso de falha, os seis parâmetros de saída são zerados; sempre teste o código de retorno antes de usá-los.

Ver também

GET_SYSTIME, GET_SYSVAR

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    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 mês do RTC [1..31] *)
    cur_mes  : INT; (* Mês do ano do RTC [1..12] *)
    cur_ano  : INT; (* Ano do RTC [2000 .. ] *)
    ret_code : INT; (* Código de retorno da execução da função *)
END_VAR

(* 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;