| Reference > TDBDateX Object > TDBDateX Object Properties > DateSerial Property (TDBDateX) |
DateSerial Property (TDBDateX)
This property returns or sets the underlying date serial value.
object.DateSerial= variant
Read-only at run time. Not available at design time.
100/01/01 - 9999/12/31 (current system date is the default)
The default value will be the current system date.
The required date is normally a string expression representing a date from January 1, 100 through December 31, 9999. All time expressions will be ignored.
If date is a string that includes only numbers separated by valid date separators, DateSerial recognizes the order for month, day, and year according to the Short Date format you specified for your system. DateSerial also recognizes unambiguous dates that contain month names, either in long or abbreviated form. For example, in addition to recognizing 12/30/1991 and 12/30/91, DateSerial also recognizes December 30, 1991 and Dec 30, 1991.
The date value in the DateSerial property will be synchronized with the Value property. Whenever the DateSerial is changed, the changes will be reflected in the Value. If DateSerial is set to Null, both the TimeSerial and the Value properties will be also set to Null.
You can use this property with the TDBDate control provided in the package for passing in date values to retrieve date time information. By using this property, the time value will not be overridden.
If a year part of the given date is omitted, DateSerial uses the current year from your system date.
If the date value includes invalid date time information, 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