SubtractDate関数（TKInfo.dll）（Ver7.33対応版）
SubtractDate関数は、Date:ヘッダ中にあるような日付文字列を２つパラメータとして受け取って、それの差が何日になるのかを計算します。
パラメータの指定によって、何日の差だけじゃなくて、何時間の差か、何分の差か、何秒の差かも計算出来ます。
- パラメータ１、パラメータ２（文字列型）
-
差を計算したい日付文字列をパラメータ１とパラメータ２に指定します。ここで指定出来る文字列の形式は、Date:ヘッダの中身に入っているような形式か、または「YYYY/MM/DD hh:mm」のような、GetMailTransmitDate関数の返す形式でもかまいません。
返される値は、パラメータ１からパラメータ２を引き算した値となります。パラメータ１の方が大きい場合は正の数、パラメータ２の方が大きい場合は負の数となります。言い換えると、パラメータ１の方がパラメータ２よりも未来の場合は正の数となります。
- パラメータ３（文字列型）
-
パラメータ３を省略するか、または数値の0を指定すると、日単位での計算がなされます。この場合の計算方式としては、パラメータ１／パラメータ２に指定された文字列の表す「時」、「分」の指定は完全に無視されて、日付だけでの比較となります。例えばパラメータ１には１月２日の午前０時を指定して、パラメータ２には１月１日午後２３時を指定したとすると、時間差的には１時間になりますが、日付の計算的には「１日」という結果になります。
パラメータ３に"hour"を指定すると、何時間ずれてるかの値を返します。ここでの時間の計算は、いわゆる「切り捨て」での計算になります。例えば２時０分と１時１分の差を計算すると、0が返ります。
パラメータ３に"minute"を指定すると、何分ずれてるかの値を返します。ここでの時間の計算も切り捨てでの計算になります。
パラメータ３に"second"を指定すると、何秒ずれてるかの値を返します。ここでの時間の計算も切り捨てでの計算になります。パラメータ１とパラメータ２の時間差（というか、日付差）が極端に大きい場合は値がオーバーフローする可能性があります。こちらで簡単に計算した所だと、６８年以上くらいずれた日付を比較するとオーバーフローするようです。
- 返り値（数値型）
-
差の値を数値で返します。
| 例 |
$today = dllfuncstr("CurrentDate");
$date = dllfuncstr("GetMailTransmitDate");
#day = dllfunc("SubtractDate", $today, $date);
message "このメールは" + str(#day) + "日前に受信したメールです。";
|