:FormatDate()
Class
Syntax
:FormatDate( [nSeconds], [nTimezone] ) -> cDateTime
Parameters
|
|
nSeconds |
Optional. Number of seconds since Epoch ( 01/01/1970 ) |
|
|
nTimezone |
Optional. Timezone differential in seconds |
Return
Formatted Date/Time string for inclusion in messages.
Description
The :FormatDate() method converts the specified date, expressed as the number of seconds since 1 January 1970, into a string compatible with the RFC 822 standard format for Internet e-mail messages
The date string is returned in a standard format as outlined in RFC 822, the document which descibes the basic structure of Internet e-mail messages.
This format is as follows:
www, dd mmm yyyy hh:mm:ss [-]zzzz
Each part of the date string is defined as follows:
|
|
www |
Weekday |
|
|
dd |
Day |
|
|
mmm |
Month |
|
|
yyyy |
Year |
|
|
hh |
Hour (24-hour clock) |
|
|
mm |
Minutes |
|
|
ss |
Seconds |
|
|
zzzz |
Timezone |
The weekday and month are displayed using standard three-character English abbreviations. The timezone is displayed as the difference (in hours and minutes) between the specified timezone and coordinated universal time. For example, if the timezone is eight hours west of coordinated universal time, the nTimezone value would be 28800. This would be displayed as -0800 in the formatted date string.
Note that the format of the date string is defined by the RFC 822 standard, and is not affected by localization settings on the host system.
See Also
:SetMessageDate(), :GetMessageDate(), :ParseDate()