Páginas filhas
  • FwDateTimeToLocal

Sintaxe
FwDateTimeToLocal(cDateTime,nVerao)-> aDateTime

Descrição

Recebe uma string no formato DateTime reconhecido pelo W3C (ISO 8601 e RFC 3339) e converte para uma data e hora local.

Os formatos são apresentados abaixo. 
Observe que o "T" aparece literalmente na string, para indicar o início do elemento de tempo, conforme especificado na ISO 8601.
   Ano:
      AAAA (por exemplo, 1997)
   Ano e mês:
      AAAA-MM (por exemplo, 1997-07)
   Data completa:
      AAAA-MM-DD (por exemplo, 1997-07-16)
   Data completa mais horas e minutos:
      AAAA-MM-DDThh:mmTZD (por exemplo, 1997-07-16T19:20+01:00)
   Data completa mais horas, minutos e segundos:
      AAAA-MM-DDThh:mm:ssTZD (por exemplo, 1997-07-16T19:20:30+01:00)
   Data completa mais horas, minutos, segundos e uma fração decimal de um segundo
      AAAA-MM-DDThh:mm:ss.sTZD (por exemplo, 1997-07-16T19:20:30.45+01:00)
Onde:

     AAAA = ano de quatro dígitos
     MM = mês de dois dígitos (01 = janeiro, etc.)
     DD = dia do mês com dois dígitos (01 a 31)
     hh = dois dígitos da hora (00 a 23) (am / pm NÃO permitido)
     mm = dois dígitos do minuto (00 a 59)
     ss = dois dígitos do segundo (00 a 59)
     s = um ou mais dígitos representando uma fração decimal de um segundo
     TZD = designador de fuso horário (Z ou + hh:mm ou -hh:mm)

1994-11-05T08:15:30-05:00 corresponde a 5 de novembro de 1994, 8:15:30, horário padrão do leste dos EUA.
1994-11-05T13:15:30Z corresponde ao mesmo instante.

Nem a ISO, nem a RFC limitam o máximo de digitos para a fração de segundos. 


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência

cDateTime

CaracterString em um dos formatos aceitos

       Sim


nVeraoNumérico

 Se está em horário de verão (1) ou não (0)

Se o ambiente estiver aberto, o valor do parâmetro MV_HVERAO. Caso contrário, 0       Não


Retorno

aDateTime → Array 

aDateTime[1] - Tipo data - Data local

aDateTime[2] - Tipo caracter - Hora local


Com o fim do horário de verão, é importante desativar o parâmetro MV_HVERAO para evitar divergências de datas ao utilizar a função FwTimeStamp e outros possíveis problemas decorrentes da ativação deste parâmetro.