大网数据广告活动
PHP 语言与运行手册

time_nanosleep · 延缓执行若干秒和纳秒

· 52CE 我爱测

sleep() - 延缓执行 usleep() - 以指定的微秒数延迟执行 time_sleep_until() - 使脚本睡眠到指定的时间为止 set_time_limit() - 设置脚本最大执行时间

time_nanosleep

(PHP 5, PHP 7, PHP 8)

time_nanosleep — 延缓执行若干秒和纳秒

说明

function time_nanosleep(int $seconds, int $nanoseconds): array|bool

程序延缓执行指定数量的 seconds 和 nanoseconds。

参数

seconds

必须是一个非负整数。

nanoseconds

必须是一个小于1亿的非负整数。

注意:

在 Windows 上,系统的睡眠时间可能会超过指定的纳秒数,具体取决于硬件。

返回值

成功时返回 true, 或者在失败时返回 false。

如果延迟被中断,一个关联数组会返回,内容为:

  • seconds——延迟剩余未执行的秒数

  • nanoseconds——延迟剩余未执行的纳秒数

示例

示例 #1 time_nanosleep() 示例

<?php
// 小心!如果返回数组,将无法按照预期工作
if (time_nanosleep(0, 500000000)) {
    echo "Slept for half a second.\n";
}

// 这个更好:
if (time_nanosleep(0, 500000000) === true) {
    echo "Slept for half a second.\n";
}

// 这个最好:
$nano = time_nanosleep(2, 100000);

if ($nano === true) {
    echo "Slept for 2 seconds, 100 microseconds.\n";
} elseif ($nano === false) {
    echo "Sleeping failed.\n";
} elseif (is_array($nano)) {
    $seconds = $nano['seconds'];
    $nanoseconds = $nano['nanoseconds'];
    echo "Interrupted by a signal.\n";
    echo "Time remaining: $seconds seconds, $nanoseconds nanoseconds.";
}
?>

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。