本文详解如何使用 PHP 的 date_sun_info() 函数获取并精确提取日出（sunrise）、日落（sunset）等天文时间戳，并安全转换为可读格式。
本文详解如何使用 php 的 `date_sun_info()` 函数获取并精确提取日出（sunrise）、日落（sunset）等天文时间戳，并安全转换为可读格式。
date_sun_info() 是 PHP 内置的日期/时间函数，用于根据指定日期和地理坐标（纬度 $lat、经度 $lon）计算当日的日出、日落、正午、晨昏蒙影等关键天文时间点。该函数返回一个关联数组，其键名固定（如 'sunrise'、'sunset'、'transit' 等），对应 UNIX 时间戳（秒级整数），而非字符串或对象，因此需通过数组下标直接访问所需值。
✅ 正确提取日出与日落时间
以下是最简、健壮的提取方式：
<?php $lat = 40.7128; // 示例：纽约纬度
$lon = -74.0060; // 示例：纽约经度
$date = strtotime(date('Y-m-d')); // 获取今日零点时间戳（避免时区歧义）
$sun_info = date_sun_info($date, $lat, $lon);
// ⚠️ 务必检查返回值，失败时返回 false
if ($sun_info === false) {
throw new RuntimeException('无法计算日出日落时间：地理坐标无效或日期超出支持范围');
}
// 直接通过键名提取时间戳
$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";
echo "日落时间：{$sunset_time}\n";
?>
? 可用键名一览（完整字段）
date_sun_info() 返回的数组包含以下 7 个标准键（全部为 UNIX 时间戳）：
| 键名 | 含义 |
|---|---|
| sunrise | 日出（上边缘初现） |
| sunset | 日落（上边缘隐没） |
| transit | 太阳中天（正午） |
| civil_twilight_begin | 民用晨光始（太阳中心在地平线下6°） |
| civil_twilight_end | 民用昏影终 |
| nautical_twilight_begin | 航海晨光始（-12°） |
| nautical_twilight_end | 航海昏影终 |
? 注意：所有时间均以 服务器当前时区 解释。若需 UTC 或目标时区时间，请配合 date_default_timezone_set() 或 DateTime 类处理。
⚠️ 关键注意事项
- 地理坐标必须有效：$lat ∈ [−90, 90]，$lon ∈ [−180, 180]；否则函数返回 false。
- 日期范围限制：仅支持公元 1970–2100 年间（取决于系统 time_t 实现）。
-
时区敏感：date() 格式化依赖运行时默认时区，建议显式设置：
date_default_timezone_set('America/New_York'); // 与坐标区域一致 - 避免重复调用：若需多个时间点，一次性获取整个数组后复用，而非多次调用 date_sun_info()。
掌握这一模式，即可在天气应用、光照控制、摄影计划等场景中精准集成天文时间逻辑。
