4D Doc Center : Date

4D v13.4

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 ter 13 caracteres e 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.
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.

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 os separadores de data válidos: barra oblíqua (/), espaço, ponto (.), e vírgula (,).
Date não verifica a validez da data em dataCadeia. Se passar uma data inválida (tal como "13/35/94"), Date devolverá a data inválida. No entanto, dataCadeia não pode ser interpretada como uma data (por exemplo, "aa/12/94"), se devolve uma data nula (!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