本文详解如何调用 date_sun_info() 获取指定日期和地理坐标的日出、日落等天文时间，并通过数组键名精准提取所需值，同时提供健壮性处理与实用示例。
本文详解如何调用 `date_sun_info()` 获取指定日期和地理坐标的日出、日落等天文时间，并通过数组键名精准提取所需值，同时提供健壮性处理与实用示例。
PHP 内置函数 date_sun_info() 是获取某地某日太阳运动关键时间点的高效工具。它接收 Unix 时间戳（代表日期）、纬度（$lat）和经度（$lon）作为参数，返回一个包含 8 个预定义键的关联数组，其中 'sunrise' 和 'sunset' 分别对应当日日出与日落的 Unix 时间戳（单位：秒），其他键还包括 'transit'（正午）、'civil_twilight_begin'（民用晨光始）、'nautical_twilight_begin' 等。
要安全、准确地提取日出与日落时间，不应依赖循环遍历（如 foreach 输出所有项），而应直接通过数组下标访问目标键。更重要的是，必须检查函数返回值——当传入无效坐标或无法计算时，date_sun_info() 会返回 false，忽略该检查可能导致运行时错误。
以下为推荐的完整实践代码：
<?php // 设置目标日期（当前日期）和地理坐标（示例：北京约 39.9°N, 116.4°E）
$date_str = date('Y-m-d');
$lat = 39.9042; // 纬度（北纬为正）
$lon = 116.4074; // 经度（东经为正）
$sun_info = date_sun_info(strtotime($date_str), $lat, $lon);
if ($sun_info === false) {
die("Error: Failed to compute sun information — check latitude/longitude or date validity.");
}
// 直接提取关键时间戳
$sunrise_timestamp = $sun_info['sunrise'];
$sunset_timestamp = $sun_info['sunset'];
// 格式化为易读的 'H:i:s' 时间（注意：结果基于服务器时区）
$sunrise_time = date('H:i:s', $sunrise_timestamp);
$sunset_time = date('H:i:s', $sunset_timestamp);
echo "? 日出时间: {$sunrise_time}\n<br>";
echo "? 日落时间: {$sunset_time}\n<br>";
// 可选：输出 UTC 时间（避免时区干扰）
echo "UTC 日出: " . gmdate('H:i:s', $sunrise_timestamp) . "\n<br>";
?>
⚠️ 注意事项：
- date_sun_info() 返回的时间戳默认以 UTC 为基准，但 date() 函数格式化时受 date_default_timezone_set() 影响；如需本地时间，请先设置正确时区（例如 date_default_timezone_set('Asia/Shanghai')）；
- 纬度范围为 -90 至 90，经度为 -180 至 180，超出将导致函数失败；
- 该函数不支持极昼/极夜地区的精确计算（如高纬度冬季无日出），此时对应键值可能为 FALSE，建议额外校验：if (!is_int($sun_info['sunrise'])) { /* 处理无日出情况 */ }；
- 完整键名列表与行为说明请参考 PHP 官方文档。
掌握这种“键名直取 + 错误防御”的方式，可确保你的天文时间逻辑简洁、可靠且易于维护。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
