函數簡介
gettimeofday() 返回當前時間的高精度資訊,包含秒、微秒、時區偏移與夏令時標誌。返回關聯陣列,適合需要微秒精度的效能分析、日誌時間戳、唯一 ID 生成等場景。
語法與返回值
gettimeofday(bool $return_float = false): array|float
| 模式 | 返回類型 | 說明 |
預設 false | array | 關聯陣列含 sec, usec, minuteswest, dsttime |
true | float | 直接返回浮點數秒數(含微秒),等同 microtime(true) |
陣列鍵值說明
| 鍵名 | 含義 | 範例值 |
| sec | 自 Unix 紀元 (1970-01-01 00:00:00 UTC) 至今的秒數 | 1705330259 |
| usec | 微秒部分 (0-999999) | 123456 |
| minuteswest | 本地時區比 UTC 西偏多少分鐘(東區為負) | -480 (UTC+8) |
| dsttime | 夏令時修正類型 (0=無, 1=有) | 0 |
代碼範例
基本用法
<?php
$time = gettimeofday();
echo "=== 關聯陣列模式 ===\n";
foreach ($time as $key => $value) {
echo "{$key} => {$value}\n";
}
/* 輸出範例:
sec => 1705330259
usec => 123456
minuteswest => -480
dsttime => 0
*/
// 浮點數模式(等同 microtime(true))
$floatTime = gettimeofday(true);
echo "\n浮點數時間戳: {$floatTime}\n";
// 1705330259.123456
?>
實戰應用:高精度效能計時
<?php
function microtimeFloat(): float {
return gettimeofday(true);
}
// 開始計時
$start = microtimeFloat();
// 模擬耗時操作
usleep(1500); // 1.5ms
// 結束計時
$end = microtimeFloat();
$elapsedMs = ($end - $start) * 1000;
echo "耗時: {$elapsedMs} 毫秒\n"; // 約 1.5ms
?>
實戰應用:生成帶微秒的唯一 ID
<?php
function generateUniqueId(string $prefix = ''): string {
$time = gettimeofday();
// 秒(10位) + 微秒(6位,補零) + 隨機3位
return sprintf(
'%s%010d%06d%03d',
$prefix,
$time['sec'],
$time['usec'],
random_int(0, 999)
);
}
echo generateUniqueId('ORD_') . "\n"; // ORD_1705330259123456789
?>
實戰應用:格式化含微秒的日誌時間戳
<?php
function logTimestamp(): string {
$t = gettimeofday();
// 格式: 2024-01-15 14:30:59.123456
return gmdate('Y-m-d H:i:s', $t['sec']) . '.' . str_pad($t['usec'], 6, '0', STR_PAD_LEFT);
}
echo logTimestamp() . "\n"; // 2024-01-15 14:30:59.123456
?>
gettimeofday() vs 替代方案
| 函數/方法 | 精度 | 返回類型 | 時區資訊 | 適用場景 |
gettimeofday() | 微秒 | array/float | 含 minuteswest, dsttime | 需時區資訊、結構化訪問 |
microtime(true) | 微秒 | float | 無 | 單純需浮點數時間戳 |
hrtime(true) (PHP 7.3+) | 奈秒 | int (奈秒) | 無 | 極高精度計時、基準測試 |
DateTime::createFromFormat('U.u') | 微秒 | DateTime | 物件層面可設定 | 需日期運算/格式化/時區轉換 |
time() | 秒 | int | 無 | 僅需秒級時間戳 |
注意事項
minuteswest 為正表示時區在 UTC 西側(美洲),負表示東側(亞洲)。UTC+8 為 -480。
dsttime 僅指示系統時區規則中是否「曾有」夏令時,不代表當前生效。判斷當前是否夏令時需用 `date('I')`。
- Windows 系統歷史上微秒精度較低(約 10-15ms 粒度),PHP 7.1+ 已改善,但 Linux/Unix 仍更精準。
- 若僅需浮點數時間戳,
microtime(true) 語義更清晰且效能略優。
總結
gettimeofday() 提供了微秒級時間戳與系統時區元數據的便捷訪問。雖然現代 PHP 更推薦使用 hrtime() 進行高精度計時、DateTime 進行時間運算,但在需要同時獲取「時間戳+時區偏移+夏令時標誌」的結構化場景(如舊系統日誌格式兼容、嵌入式設備時間同步),它依然是最直接的選擇。