Delphi Basics : EncodeDateTime command

DelphiBasics

EncodeDateTime
Function

Build a TDateTime value from day and time values

DateUtils unit

function EncodeDateTime(const Year, Month, Day, Hour, Min, Sec, MSec Word):TDateTime;

Description

The EncodeDateTime function generates a TDateTime return value from the passed Year, Month, Day, Hour, Min, Sec and MSec (millisecond) values.

The permitted parameter values are :

Year	= 0..9999
Month	= 1..12
Day	= 1..31 (depending on month/year)

Hour	= 0..23
Min	= 0..59
Sec	= 0..59
MSec	= 0..999

If you exceed these values, an EConvertError is raised.

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
EncodeTime		Build a TDateTime value from hour, min, sec and msec values

Download this web site as a Windows program.

Example code : Assign a full day and time value to a TDateTime variable

var
  myDate : TDateTime;

begin
  // Set my date variable using the EncodeDateTime function
  myDate := EncodeDateTime(2000, 02, 29, 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 29/02/2000
Time set to 12:34:56.789