Skip to content

StrToTime

Convert a time string to a TDateTime value.

Declaration

Source position: datih.inc line 146

  function StrToTime(const S: Shortstring) : TDateTime;
  function StrToTime(const S: Ansistring) : TDateTime;
  function StrToTime(const S: ShortString; separator: Char) : TDateTime;
  function StrToTime(const S: AnsiString; separator: Char) : TDateTime;
  function StrToTime(const S: string; FormatSettings: TFormatSettings)
                     : TDateTime;
  function StrToTime(const S: PChar; Len: Integer; separator: Char)
                     : TDateTime;

Description

StrToTime converts the string S to a TDateTime time value. The time must consist of 1 to 4 digits, separated by the TimeSeparator character. If two numbers are given, they are supposed to form the hour and minutes.

Errors

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

See also

Name Description
EConvertError Conversion error.
StrToDate Convert a date string to a TDateTime value.
StrToDateTime Convert a date/time string to a TDateTime value.
TimeToStr Convert a TDateTime time to a string using a predefined format.

Example

Program Example21;
{ This program demonstrates the StrToTime function }
Uses sysutils;
Procedure TestStr (S : String);
begin
  Writeln (S,' : ',TimeToStr(StrToTime(S)));
end;
Begin
  teststr (TimeToStr(Time));
  teststr ('12:00');
  teststr ('15:30');
  teststr ('3:30PM');
End.