PHP date_sunrise() 函数 - PHP 5 函数参考手册

PHP date_sunrise() 函数返回指定日期与地点的日出时间

( php 5+ )

你可以访问 date_sunset() 函数，返回指定日期与地点的日落时间

函数原型

date_sunrise(timestamp,format,latitude,longitude,
            zenith,gmtoffset);

参数说明

参数	描述
timestamp	必需。规定要计算日出时间的日期时间戳
format	可选。规定如何返回结果
latitude	可选。规定地点的纬度。默认是指北纬因此如果要指定南纬，必须传递一个负值
longitude	可选。规定地点的经度。默认是指东经因此如果要指定西经，必须传递一个负值
zenith	可选。默认为 date.sunrise_zenith
gmtoffset	可选。规定 GMT 与本地时间的差值。单位是小时

format 参数可能的值

常量	说明
SUNFUNCS_RET_STRING	默认，以 string 格式返回结果，比如 16:46
SUNFUNCS_RET_DOUBLE	以 float 格式返回结果，比如 16.78243132
SUNFUNCS_RET_TIMESTAMP	以 integer 格式（时间戳）返回结果比如 1095034606

返回值

如果成功，则以指定的 format 返回日出时间

如果失败则返回 FALSE

范例

下面的范例返回葡萄牙里斯本今天的日出时间

<?php
// Lisbon, Portugal:
// Latitude: 38.4 North, Longitude: 9 West
// Zenith ~= 90, offset: +1 GMT
echo "Lisbon, Portugal: Date: " , date("D M d Y") ;
echo "<br>Sunrise time: " ;
echo date_sunrise(time(),SUNFUNCS_RET_STRING,38.4,-9,90,1);

运行范例 »

更新日志

PHP 版本	更新说明
PHP 5.1.0	函数报 E_STRICT 和 E_NOTICE 时区错误