Mega Code Archive

 

Categories / Delphi / Functions

 

Encodetime - build a tdatetime value from hour, min, sec and msec values sysutils unit

function EncodeTime ( const Hour, Min, Sec, MSec : Word ) : TDateTime; Description The EncodeTime function generates a TDateTime return value from the passed Hour, Min, Sec and MSec (millisecond) values. The permitted parameter values are : Hour = 0..23 Min = 0..59 Sec = 0..59 MSec = 0..999 If you exceed these values, an EConvertError is raised. Notes The Date value for the TDateTime is always set to 30 Dec 1899. Quite why is not clear - it is 2 days before the start of the 20th century. Related commands DecodeDate Extracts the year, month, day values from a TDateTime var. DecodeDateTime Breaks a TDateTime variable into its date/time parts DecodeTime Break a TDateTime value into individual time values EncodeDate Build a TDateTime value from year, month and day values EncodeDateTime Build a TDateTime value from day and time values Example code : Assign a time to a TDateTime variable var myDate : TDateTime; begin // Set my date variable using the EncodeTime function myDate := EncodeTime(12, 34, 56, 789); LongTimeFormat := 'hh:mm:ss.z'; // Ensure that MSecs are shown ShowMessage('Date set to '+DateToStr(myDate)); ShowMessage('Time set to '+TimeToStr(myDate)); end; Show full unit code Date set to 30/12/1899 Time set to 12:34:56.789