../../_images/serie.png

Definições acerca do Timestamp

Um timestamp é um conceito amplamente utilizado em computação e tecnologia da informação que se refere a um registro digital indicando uma data e hora específicas. Ele serve como um meio de rastreamento de tempo, marcando exatamente quando um evento ocorre. Isso é particularmente útil em diversas aplicações de software e sistemas, onde é necessário manter um registro preciso de eventos para fins de auditoria, controle de ordem de eventos ou simplesmente para registro histórico.

O formato mais comum de um timestamp é “AAAA-MM-DD HH:MM:SS”, onde ‘AAAA’ representa o ano, ‘MM’ o mês, ‘DD’ o dia, ‘HH’ as horas, ‘MM’ os minutos, e ‘SS’ os segundos. Contudo, este formato pode variar para atender às necessidades específicas de um sistema. A precisão de um timestamp também pode variar, com alguns sistemas registrando até milissegundos ou microssegundos.

Uma consideração importante no uso de timestamps é o fuso horário. Eles podem ser armazenados em horário UTC (Tempo Universal Coordenado) ou considerando fusos horários locais. Essa escolha depende da aplicação e do contexto no qual o timestamp está sendo usado.

Ao utilizar timestamps, é crucial considerar aspectos como o fuso horário, formato e a precisão necessária. Isso assegura que os registros temporais sejam consistentes e úteis para o propósito do sistema.

Por exemplo, no caso de sistemas de potência modelados no Anarede/Anatem, o timestamp pode ser utilizado para indicar ao usuário sobre qual o momento no tempo que aquele caso se refere. Se é um caso oriundo da operação (real), então o timestamp esperado possui a informação completa, do ano aos segundos. Por outro lado, se o caso é referente a um cenário de planejamento, ano e mês deve bastar para todos os propósitos.

Nota

A prática dos usuários de Anarede no Brasil tem sido de informar uma espécie de timestamp informal no título do caso. Desta forma, um segundo usuário era capaz de indentificar, temporalmente, aquele caso. A utilização formal de timestamp padroniza a informação, além de ser um dado útil para o programa em si (informação que pode ser processada de alguma forma).

Utilização de Timestamp no Anatem

A definição do valor do timestamp no Anatem pode ser dada de duas formas. A primeira, é a partir da utilização do código TIME no Anarede. A informação da estampa de tempo é salva no caso do arquivo histórico e é lido pelo Anatem durante o reestabelecimento do caso do fluxo de potência.

A segunda forma de definição desse valor é por meio do próprio código TIME, mas no contexto do Anatem e após o reestabelecimento do caso do fluxo de potência (no código DARQ ou no comando ARQV REST quando utilizada com ULOG). A utilização do código TIME no Anatem pode ser feita independentemente de haver informação de estampa de tempo no caso do fluxo de potência; o Anatem substituirá qualquer que seja o valor previamente definido pelo novo valor informado.

Na ausência de qualquer estampa de tempo, o programa considera como default o valor de EPOCH=0, ou seja, 01/01/1970 00:00:00 UTC +00:00.

Ao contrário dos outros códigos de execução, o código TIME possui um único dado a ser informado, com múltiplas configurações de dado de entrada.

A tabela a seguir apresenta as diferentes configurações de entrada de dados permitida para o código TIME. As barras podem ser substituídas por hífens e a sigla UTC pode ser trocada por GMT.

Formato

Descrição

EPOCH

Número inteiro no formato EPOCH (número de segundos passados desde 1/1/1970 00:00, GMT +00:00)

YYYY/MM/DD hh:mm:ss UTC shh:mm

Formato completo. UTC pode ser substituído por GMT.

YYYY/MM/DD hh:mm UTC shh:mm

Formato sem informação de segundos. Nesse caso, ss é presumido como 00.

YYYY/MM/DD

Formato sem informação de horas e minutos. Nesse caso, hh é presumido como 12 e mm é presumido como 00. GMT é presumido como sendo o do relógio local do usuário.

YYYY/MM

Formato sem informação de dias. Nesse caso, DD é presumido como 1.

Exemplo

Listagem 162 Exemplo da aplicação do código TIME
1TIME
2( Formato EPOCH
31630587807
4(
5TIME
6(YYY/MM/DD hh:mm UTC -HH:MM.
72021/09/16 12:00 UTC -03:00