A função genérica FwTimeUF tem por objetivo retornar a Data e a Hora do Protheus Server convertida para um Estado Brasileiro (Unidade Federativa), que possua GMT diferente do Estado onde o Protheus Server localiza-se. É útil nos casos onde o Protheus Server esteja disponível, como por exemplo, em um datacenter no estado de São Paulo e o SmarClient esteja em execução no estado do Acre, e se deseja obter o valor de Data + Hora do Estado do Acre, sem que esta informação seja coletada a partir da estação em uso. E também nos casos onde a mesma companhia possua diversas filiais espalhadas pelo território brasileiro, concentrando um único servidor de aplicação.
Atenção
Esta função está disponível para utilização em ambientes Microsiga Protheus® 10 e Microsiga Protheus® 11, em que o fonte FwTimeForUF.prw possua data igual ou superior à 25/07/12.
Nome: FwTimeUF
Parâmetros:
cUF - (String): Código da Unidade Federativa em que se deseja obter a hora.
cPar2 - Reservado.
lSrvSummer - (Logical): Indica se a aplicação Server encontra-se em execução em uma região brasileira em que o Horário de Verão esteja ATIVO. (No período De/Até que compreende o horário de verão brasileiro)
cServerDate - (String): Data a ser considerada. Formato AAAAMMDD.
Retorno:
aRet - Array contemplando a Data e a Hora convertidos para a UF desejada.