LCDatetime class overview

The LCDatetime class represents a specific date and time, including time zone and daylight savings time information. A datetime value may have either its date or time component unavailable, indicated by special constant values for date (LCDTNULL_DATE) or time (LCDTNULL_TIME) components. Flags control the behavior for the existence/absence of the date or time portion. During any datetime overflow, the maximum or minimum valid datetime value is assigned in addition to the error return.

The time portion of the datetime is precise to hundredths. Some data sources do not support this precision, or support greater precision. For these systems it may be necessary to set the field flags for all datetime data type fields to LCFIELDF_TRUNC_PREC, to avoid a precision loss error.

Exercise care in converting LCDatetime values to and from LotusScript® datetime variants. LotusScript® does not represent time zone and DST, nor does it distinguish between a "null time" and midnight. So, you lose information when you use the Value property to copy a date/time value into a LotusScript® datetime variant. If you need to do math with these values, it is generally better to use the GetDiff, Adjust and Compare methods as opposed to using the LotusScript® operators +, -, < or > on the Value property.