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

php_function_reference.htm

打印页面