Reference > TDBDateX Object > TDBDateX Object Properties > TimeSerial Property (TDBDateX) |
TimeSerial Property (TDBDateX)
This property returns or sets the underlying time serial value.
object.TimeSerial= variant
Read/Write at run time. Not available at design time.
00:00:00 - 23:59:59 (current system time is the default)
The default value will be the current system time.
The required time is normally a string expression representing a time from 00:00:00 through 23:59:59. All date expressions will be ignored.
If time is a string that includes only numbers separated by valid date separators, the TimeSerial property recognizes the order for hour, minute, and second according to the Time style you specified for your system. TimeSerial also recognizes times that contain AM/PM keywords. For example, in addition to recognizing 01:00:00 and 13:00:00, TimeSerial also recognizes 1:00:00 AM and 1:00:00 P.
The time value in the TimeSerial will be synchronized with the Value property. Whenever the TimeSerial is changed, the changes will be reflected in the Value. If the TimeSerial is set to Null, both the DateSerial and the Value will be also set to Null.
You can use this property with the TDBTime control provided in the package for passing in time values to retrieve date time information. By using this property, the date value will not be overridden.
If the time value includes invalid date time information such as "89:98", a trappable error occurs.
Null value is not a valid date that can be converted to a date, but can be used as a Variant subtype, indicating that a variable or a property contains no valid data.
See Also