极客教程PHP date_sunrise() 函数
定义和用法
该 date_sunrise() 函数接受一个表示指定日期的时间戳，并返回该特定日期的日出时间。
语法
date_sunrise(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_sunrise()函数返回所需格式的日出时间。如果失败，则返回布尔值false。
PHP版本
此函数首次引入于PHP 5.0版本，并且适用于所有后续版本。
示例
以下示例演示了date_sunrise()函数的用法。
<?php
sun_info = date_sunrise("02-17-2012");
print_r(sun_info);
?>
这将产生以下结果 −
04:39
示例
现在让我们通过传递纬度和经度值来调用这个函数。如果你想传递纬度和经度值，那么传递必需的格式值是必须的。
<?php
sun_info = date_sunrise("02-03-2020",SUNFUNCS_RET_STRING, 23.4, -25);
print_r("Sunrise Time: ".sun_info);
?>
这将产生以下结果−
Sunrise Time: 08:21
示例
下面是一个验证没有日出情况的示例 −
<?php
sun_info = date_sunrise("25-12-2016",SUNFUNCS_RET_STRING, 69, 41);
print("Sunrise Time: ".sun_info);
print("\n");
var_dump($sun_info);
?>
这将产生以下结果−
Sunrise Time:
bool(false)
示例
<?php
echo("Date: " . date("D M d Y"));
echo("\n");
echo("Sunrise time: ");
echo(date_sunrise(time(),SUNFUNCS_RET_STRING,38.4,-9,90,1));
?>
这将产生以下结果−
Date: Thu May 07 2020
Sunrise time: 06:34