StrToDate

Converte uma cadeia de caracteres num valor TDateTime.

Estrutura

StrToDate(string): TDateTime;

Parâmetros

Valor de retorno

Descrição

Chame StrToDate para analisar uma cadeia de caracteres que especifique uma data. Se S não contiver uma data válida, StrToDate lança uma exceção EConvertError.

S deve ser composto por dois ou três números, separados pelo caractere definido pela variável global DateSeparator. A ordem do mês, dia e ano é determinada pela variável global ShortDateFormat — as combinações possíveis são m/d/y, d/m/y e y/m/d.

Se S contiver apenas dois números, é interpretado como uma data (m/d ou d/m) do ano atual.

Os valores do ano entre 0 e 99 são convertidos utilizando a variável global TwoDigitYearCenturyWindow. Se TwoDigitYearCenturyWindow for 0, os valores de ano entre 0 e 99 são considerados como pertencentes ao século atual. Se TwoDigitYearCenturyWindow for maior que 0, o seu valor é subtraído do ano atual para determinar o «ponto de referência»; os anos a partir desse ponto de referência são mantidos no século atual, enquanto os anos anteriores a esse ponto de referência são transferidos para o século seguinte. Por exemplo:

Ano atual Ano de dois dígitos Janela de séculos Data de referência =mm/dd/03 data =mm/dd/50 data =mm/dd/68

1998 0 1900 1903 1950 1968

2002 0 2000 2003 2050 2068

1998 50 1948 2003 1950 1968

2000 50 1950 2003 1950 1968

2002 50 1952 2003 2050 1968

2020 50 1970 2003 2050 2068

2020 10 2010 2103 2050 2068

Nota

O formato da cadeia de caracteres da data varia quando os valores das variáveis de formatação de data e hora são alterados. |