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

php_function_reference.htm

打印页面