Delphi in a Nutshell

Name

VarFromDateTime Function

Syntax

function VarFromDateTime(DateTime: TDateTime): Variant;

Description

VarFromDateTime creates a varDate Variant for the given TDateTime value. VarFromDateTime is a real function.

Tips and Tricks

• You must call VarFromDateTime to convert a TDateTime value to a Variant. If you try to assign a TDateTime to a Variant, Delphi creates a varDouble Variant because TDateTime is really a floating-point type.

• Delphi’s format for TDateTime values is the OLE standard, so if you create a varDate Variant by directly assigning the member of a TVarData record, you can assign a TDateTime value to the VDate member.

• If you want extra control over the string formatting of a TDateTime, you can call VarToDateTime and then use the functions in SysUtils to format the string. Casting the varDate to a varString value always uses a short date and time format.

Example

// The following two examples do the same thing.
V := VarFromDateTime(Now);

VarClear(V);
TVarData(V).VType := varDate;
TVarData(V).VDate := Now;

See Also

TDateTime Type, VarClear Procedure, Variant Type, VarToDateTime Function