date_sunset()函数返回给定日期/地点的日落时间。
定义和用法
date_sunset()函数接受表示给定一天的时间戳，并返回该特定日期的日落时间。
语法
date_sunset($timestamp, [$format, $latitude, $longitude, $zenith, $gmtoffset])
参数
| 序号 | 参数及说明 |
|---|---|
| 1 | timestamp (必需) 这指定一个时间戳。 |
| 2 | format (可选) 这指定了您需要使用结果值的格式。您可以传递三个常量作为该参数的值； 即：SUNFUNCS_RET_STRING（字符串），SUNFUNCS_RET_DOUBLE（浮点数）和SUNFUNCS_RET_TIMESTAMP 整数。 |
| 3 | latitude (可选) 默认情况下，此选项指定位置的纬度，此选项指定北向。 要指定南部的纬度值，需要将其作为负值传递。 |
| 4 | longitude (可选) 默认情况下，它指定一个位置的经度，它指定东方向。要指定西面的纬度值，需要将其作为负值传递。 |
| 5 | zenith (可选) 这指定了天顶值。这指定了垂直于地球表面的线与太阳中心之间的角度。 |
| 6 | gmtoffset (可选) 这指定了GMT与当地时间之间的时差（以小时为单位）。 |
返回值
date_sunset()函数以所需格式返回日落时间。如果失败，它将返回布尔值false。
PHP版本
此函数最初是在PHP 5.0版中引入的，并且可以在所有更高版本中使用。
在线示例
以下示例演示了date_sunset()函数的用法-
<?php
$sun_info = date_sunset("02-17-2012");
print_r($sun_info);
?>测试看看‹/›输出结果
14:46
在线示例
现在，通过传递纬度和经度值来调用此函数。如果您想传递纬度和经度值，则也必须传递所需格式的值-
<?php
$sun_info = date_sunset("02-03-2020",SUNFUNCS_RET_STRING, 23.4, -25);
print_r("Sunset Time: ".$sun_info);
?>测试看看‹/›输出结果
Sunset Time: 19:05
在线示例
以下示例验证了没有日落的情况-
<?php
$sun_info = date_sunset("25-12-2016",SUNFUNCS_RET_STRING, 69, 41);
print("Sunset Time: ".$sun_info);
print("\n");
var_dump($sun_info);
?>测试看看‹/›输出结果
Sunset Time: bool(false)
在线示例
<?php
echo("Date: " . date("D M d Y"));
echo("\n");
echo("Sunset time: ");
echo(date_sunset(time(),SUNFUNCS_RET_STRING,38.4,-9,90,1));
?>测试看看‹/›输出结果
Date: Thu May 07 2020 Sunset time: 20:30