萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP gettimeofday() 函數詳解:獲取微秒級時間戳與時區資訊

函數簡介

gettimeofday() 返回當前時間的高精度資訊,包含秒、微秒、時區偏移與夏令時標誌。返回關聯陣列,適合需要微秒精度的效能分析、日誌時間戳、唯一 ID 生成等場景。

語法與返回值

gettimeofday(bool $return_float = false): array|float
模式返回類型說明
預設 falsearray關聯陣列含 sec, usec, minuteswest, dsttime
truefloat直接返回浮點數秒數(含微秒),等同 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 進行時間運算,但在需要同時獲取「時間戳+時區偏移+夏令時標誌」的結構化場景(如舊系統日誌格式兼容、嵌入式設備時間同步),它依然是最直接的選擇。

copyright © 萬盛學電腦網 all rights reserved