极客教程PHP 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和本地时间之间的小时差。 |
返回值
PHP 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