microtime

(PHP 4, PHP 5)

microtime — 現在の Unix タイムスタンプをマイクロ秒まで返す

説明

mixed microtime ([ bool $get_as_float ] )

microtime() は、現在の Unix タイムスタンプをマイクロ秒単位で返します。この関数は、gettimeofday() システムコールをサポートするオペレーティングシステムでのみ使用できます。

パラメータ

get_as_float: TRUE を指定すると、microtime() は文字列ではなく float を返すようになります。詳細は、返り値の説明を参照ください。

返り値

デフォルトでは、microtime() は "msec sec" 形式の文字列を返します。ただし、sec は Unix エポック (1970 年 1 月 1 日 0:00:00 GMT) から計算した秒数、msec は sec から経過したマイクロ秒数です。

get_as_float を TRUE に設定すると、microtime() は結果を float で返します。これは、Unix エポックからの経過秒数をマイクロ秒単位で表したものです。

変更履歴

バージョン	説明
5.0.0	`get_as_float` パラメータが追加されました。

例

例1 microtime() でタイマスクリプト実行


<?php
/**
 * PHP 5の動作を模擬する簡単な関数
 */
function microtime_float()
{
    list($usec, $sec) = explode(" ", microtime());
    return ((float)$usec + (float)$sec);
}

$time_start = microtime_float();

// しばらくスリープ
usleep(100);

$time_end = microtime_float();
$time = $time_end - $time_start;

echo "Did nothing in $time seconds\n";
?>

例2 PHP 5 におけるタイマスクリプト実行


<?php
$time_start = microtime(true);

// しばらくスリープ
usleep(100);

$time_end = microtime(true);
$time = $time_end - $time_start;

echo "Did nothing in $time seconds\n";
?>

参考

time() - 現在の Unix タイムスタンプを返す