[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'sysutils' (#rtl)

# StrToDateTime

Convert a date/time string to a TDateTime value.

## Declaration

Source position: datih.inc line 129

`function StrToDateTime(`
`const S: String`
`):TDateTime;`

## Description

StrToDateTime converts the string S to a TDateTime date and time value. The Date must consist of 1 to three digits, separated by the DateSeparator character. If two numbers are given, they are supposed to form the day and month of the current year. If only one number is given, it is supposed to represent the day of the current month. (This is not supported in Delphi)

The order of the digits (y/m/d, m/d/y, d/m/y) is determined from the ShortDateFormat variable.

## Errors

On error (e.g. an invalid date or invalid character), an EConvertError exception is raised.

## See also

StrToDate |  | Convert a date string to a TDateTime value.
StrToTime |  | Convert a time string to a TDateTime value.
DateTimeToStr |  | Converts a TDateTime value to a string using a predefined format.

## Example

    Program Example20;

    { This program demonstrates the StrToDateTime function }

    Uses sysutils;

    Procedure TestStr (S : String);

    begin
      Writeln (S,' : ',DateTimeToStr(StrToDateTime(S)));
    end;

    Begin

      Writeln ('ShortDateFormat ',ShortDateFormat);
      TestStr(DateTimeToStr(Now));
      TestStr('05-05-1999 15:50');
      TestStr('5-5 13:30');
      TestStr('5 1:30PM');
    End.

The latest version of this document can be found at lazarus-ccr.sourceforge.net.