The Date property returns the value of the Date header
field in the current message. Setting this property causes the Date
field to be updated with the specified value. When setting the
date, any one of the following formats may be used:
| Format |
Example |
| mm/dd/yy[yy]
hh:mm[:ss] |
03/01/98 12:00 |
| yy[yy]/mm/dd
hh:mm[:ss] |
98/03/01 12:00 |
| dd mmm yy[yy]
hh:mm[:ss] |
01 Mar 1998 12:00:00 |
| mmm dd yy[yy]
hh:mm[:ss] |
Mar 01 1998 12:00:00 |
Any extraneous information that may be included in the date
string, such as the day of the week, is ignored. In addition to the
date and time, the string may also include a time zone
specification at the end. If no time zone is specified, the current
time zone is used.
When specifying a time zone, the value should either be prefixed
by a plus sign (+) to indicate that the time zone is to the east of
GMT, or a minus sign (-) to indicates that it's to the west. Four
digits follow, with the first two indicating the number of hours
east or west of GMT, and the last two digits indicating the number
of minutes. Therefore, a value of -0800 means that the time zone is
eight hours to the west of GMT, or in other words, the Pacific time
zone. Regardless of the format of the string assigned to the
property, it always returns the date in the same standard
format.
Note that the Localize property affects how dates are
processed by the control. If enabled, dates are automatically
adjusted for the local time zone. By default, localization is
disabled.