PHP date_sunset() 函数用法及示例
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