4D v14.3

Date

Página Inicial

 
4D v14.3
Date

Date 


 

Date ( dataCadeia ) -> Resultado 
Parâmetro Tipo   Descrição
dataCadeia  cadeia in Cadeia que contém a data a resolver
Resultado  Data in Data

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.

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

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

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

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

 
PROPRIEDADES 

Produto: 4D
Tema: Datas e Horas
Número 102

 
HISTÓRIA 

Criado por: < 4D v6

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Inherited from : Date ( 4D v12.4)