LocalDate Property (PITime Object)


See Also     Example         

 

LocalDate is a Read/Write Property that exposes the time stored in the PITime object as a local time expressed in VB DATE format. Because the PITime is “server independent”, the conversion to local time from the internal storage as UTC is done using the time zone settings of the system where the object is executing.

Syntax

object.LocalDate

The object placeholder is an object expression that evaluates to a PITime object

Remarks

The PITime object allows a minimum value for the DATE that would produce a UTC time of 0 seconds. For example, in the GMT time zone the minimum LocalDate would be 1970/01/01 and in the US/Pacific time zone the minimum LocalDate would be 1969/12/31 16:00

The DynamicTime and PITimeFormat objects inherit the PITime interface. The LocalDate available from those objects is calculated by referencing the TimeZoneInfo property. If the TimeZoneInfo is not the same as the client's current time zone setting, it is not recommended to use CDate() in Visual Basic or VariantChangeType() in C++ to convert between DATE and string types. These conversion routines will not match the TimeZoneInfo setting of PITimeFormat or DynamicTime.

Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:

Error Description
tseTIMESTAMPTODATE Unable to convert a PItimestamp to a DATE.
tseTIMEINVALID The time is invalid.
tseDATETOTIMESTAMP Unable to transform a DATE into a PItimestamp.

Enabling Operational Intelligence