4D Doc Center : Date

4D v14.3

Date


Date ( dataCadeia ) -> Resultado

Parâmetro	Tipo	Descrição
dataCadeia	cadeia	Cadeia que contém a data a resolver
Resultado	Data	Data

Descrição

O comando Date avalia dataCadeia e retorna uma data.

O parâmetro dataCadeia deve respeitar o formato data ISO ou os parâmetros regionais do sistema.

Formato data ISO
A cadeia deve estar no formato: "AAAA-MM-DDTHH:MM:SS", por exemplo "2013-11-20T10:20:00". Neste caso, Date avalia o parâmetro dataCadeia corretamente, sem importar a configuração da linguagem atual. Os decimais de segundos, precedidos por um ponto, se suporta (exemplo: "2013-11-20T10:20:00.9854").
Se o formato dataCadeia não respeita este esquema ISO, logo a data se avalia como um formato data curto baseado nos parâmetros regionais do sistema.

Nota: a partir de 4D v14, se recomenda utilizar o formato "YYYY-MM-DDTHH:MM:SSZ", conforme a norma ISO e lhe permitindo expressar a zona horária.

Parâmetros regionais
Se dataCadeia não corresponde ao formato ISO, os parâmetros regionais definidos no sistema operativo para uma data curta são utilizados para a avaliação. Por exemplo, na versão em espanhol de 4D, por padrão a data deve estar na ordem MM/DD/AA (mês, dia, ano). O mês e o dia possam ter um ou dois dígitos. O ano pode ser de dois ou quatro dígitos. Se o ano é de dois dígitos, então Date considera se a data pertence ao século 20 ou 21 em função do valor introduzido. Por padrão o valor pivô é 30:

Se o valor introduzido é superior ou igual a 30, 4D considera que a data pertence ao século 20 e adiciona 19 a frente do valor.
Se o valor introduzido é inferior a 30, 4D considera que a data pertence ao século 21 e agrega 20 à frente do valor.

Este mecanismo pode ser configurado utilizando o comando SET DEFAULT CENTURY.
Os seguintes caracteres são separadores de datas válidas: barra oblíqua (/), espaço, ponto (.), vírgula (,) e hífen (-).

Se passar uma data inválida (tal como "13/35/94") o "aa/12/94"), em dataCadeia, Date devolverá uma data inválida (!00/00/00!). É sua responsabilidade verificar que dataCadeia seja uma data válida.

Exemplo 1

O exemplo a seguir utiliza uma caixa para que o usuário introduza uma data. A string introduzida pelo usuário é convertida em uma data e é guardada na variável reqData:

 vdReqData:=Date(Request("Por favor introduza uma data:";String(Current date)))

 If(OK=1)

  ` Fazer algo com a data guardada em vdReqData

 End if

Exemplo 2

O seguinte exemplo retorna a cadeia "12/12/94" como uma data:

vdData:=Date("12/12/94")

Exemplo 3

Data de avaliação baseada em uma data em formato ISO:

 $vtDateISO:="2013-06-05T20:00:00"

 $vDate:=Date($vtDateISO)

  //$vDate representa o 5 de junho de 2013 sem importar a linguagem do sistema