~~NOTOC~~
---json
{
    "title":"timediff()",
    "description":"２つの時刻の時間差を求めます"
}
---
\\
====== timediff() ======

<blockquote>
==== 説明 ====
２つの時刻の時間差を求めます。\\

==== 構文 ====
<code perl>
k = timediff( i, j );
</code>

==== 引数 ====
<code perl>
 i : 起点時刻（gettimeofday形式）
 j : 終点時刻（gettimeofday形式）
</code>

==== 返り値 ====
<code perl>
 k =
       時間差 : gettimeofdayの形式
        undef : 引数が未定義
    [ -1, 0 ] : 起点時刻が終点時刻を超えている
</code>

==== 備考 ====
<note type="info">
gettimeofday形式はTime::HiResの関数gettimeofday()の返り値と同じ形式で
<code perl>
[ sec, msec ]

 sec: 秒(整数)
msec: マイクロ秒(整数: 範囲: 0～999999 )
</code>
で表します。
</note>

<note type="warning">
起点時刻と終点時刻は引数の順序が決まっているため、入れ替わると正しい値を得ることができません。
</note>

</blockquote>

~~DISCUSSION~~