|
|
|
|
|
|
|
|
|
|
version 6.5
SMTP_Date (smtp_ID; msgDate; msgTime; timeZone; offset{; deleteOption}) --> 整数
| 引数 | タイプ | 説明 | |
| smtp_ID | 倍長整数 | --> | メッセージ参照 |
| msgDate | 日付 | --> | このメッセージの作成日 |
| msgTime | 時間 | --> | このメッセージの作成時刻 |
| timeZone | 整数 | --> | ロケーションコード |
| offset | 整数 | --> | timeZone引数に依存します |
| deleteOption | 整数 | --> | 0 = 追加/置き換え, 1 = 削除 |
| 戻り値 | 整数 |  | エラーコード |
説明
メール作成者の日付、時間、地域を渡すと、SMTP_Date コマンドは smtp_ID で指定したメッセージのDateヘッダを構築します。コマンドに渡される日付は、メッセージを送信するマシンの現在日付と時刻であるべきです。日付は特別なフォーマットで記述されるため、メールを受信したサーバは記述された日付と時間、ゾーン、オフセットに基づき解釈することができ、結果送信者の日付と時刻をローカルの日付と時刻に変換できます。
Note: メールメッセージにDateヘッダが含まれない場合、SMTPサーバが日付と時刻を追加するでしょう。すべてのSMTPメールメッセージはクライアントアプリケーションまたはSMTPサーバ付加したDateヘッダを持っています。
smtp_ID はSMTP_New コマンドで作成された倍長整数のメッセージ参照です。
msgDate はこのメッセージが作成された4Dの日付です。
msgTime はこのメッセージが作成された時刻です。
timeZone は送信者のタイムゾーンを指定します。このフィールドには0から6の値が指定可能です。
・0を指定した場合、直接offset 引数に国際標準時からの時差を指定します。
・1を指定した場合、MacintoshのPRAMに基づく時差を自動で設定します。timeZone が1の場合、offset 引数は必要ありません。Macintoshのタイムゾーンは日付と時間システム環境設定で設定されます。メールの送信時刻がデータベースシステムで重要なファクタとなる場合、開発者はこのオプションの正確性について検討する必要があります。
・2から5は米国の4つのタイムゾーンに対応します。それぞれの値に対するoffset はタイムゾーンが夏時間か (offset = 1) そうでないか (offset = 0) を指定します。
・6を指定した場合、時間はミリタリータイムで指定されます。以下のミリタリータイムの表はoffset.を決定します。送信者のミリタリータイムコードに基づく対応するオフセット値 (-12 から 12) を使用してください。
offset - この引数に渡される値は timeZone 引数に設定されるコードにより異なります。先の説明および以下の説明を参照してください。
| コード | タイムゾーン | Offset 引数 |
| 0 | +/- offset from UT | +/- 時間で表記されるオフセット |
| 1 | +/- offset from UT | Offset引数を使用しない。MacのPRAM設定を使用 |
| 2 | EST - EDT | (0 = EST, 1 = EDT) |
| 3 | CST - CDT | (0 = CST, 1 = CDT) |
| 4 | MST - MDT | (0 = MST, 1 = MDT) |
| 5 | PST - PDT | (0 = PST, 1 = PDT) |
| 6 | ミリタリータイム | 以下の表を参照 |
| Offset 値 | ミリタリタイムコード |
| 0 | Z |
| -1 から -9 | A から I |
| -10 から -12 | K から M |
| 1 から 12 | N から Y |
略号の説明
| UT | Universal Time |
| EST | Eastern Standard Time |
| EDT | Eastern Daylight Time |
| CST | Central Standard Time |
| CDT | Central Daylight Time |
| MST | Mountain Standard Time |
| MDT | Mountain Daylight Time |
| PST | Pacific Standard Time |
| PDT | Pacific Daylight Time |
deleteOption - 0を渡した場合、与えられた引数を使用してDateヘッダが追加される、または事前に設定されていたDateヘッダを置き換えます。1を指定すると、Dateヘッダは取り除かれます。他の値は無視されます。deleteOption はオプションの引数であり、指定されない場合のデフォルト値は0です。
参照
|
|
|
|
|
|
|
|
|
|