(PHP 5, PHP 7, PHP 8)
date_sunset — 返回給定的日期與地點(diǎn)的日落時(shí)間
$timestamp
,$format
= SUNFUNCS_RET_STRING,$latitude
= ini_get("date.default_latitude"),$longitude
= ini_get("date.default_longitude"),$zenith
= ini_get("date.sunset_zenith"),$gmt_offset
= 0
date_sunset() 返回給定的日期(以
timestamp
指定)與地點(diǎn)的日落時(shí)間。
timestamp
返回給定的日期(以
timestamp
指定)的日落時(shí)間。
format
常量 | 說明 | 取值舉例 |
---|---|---|
SUNFUNCS_RET_STRING | 以 string 格式返回結(jié)果 | 16:46 |
SUNFUNCS_RET_DOUBLE | 以 float 格式返回結(jié)果 | 16.78243132 |
SUNFUNCS_RET_TIMESTAMP | 以 integer 格式(時(shí)間戳)返回結(jié)果 | 1095034606 |
latitude
默認(rèn)是指北緯。因此如果要指定南緯,必須傳遞一個(gè)負(fù)值。參見: date.default_latitude
。
longitude
默認(rèn)是指東經(jīng)。因此如果要指定西經(jīng),必須傳遞一個(gè)負(fù)值。參見: date.default_longitude
zenith
默認(rèn): date.sunset_zenith
。
gmtoffset
單位是小時(shí)。
在每次調(diào)用日期/時(shí)間函數(shù)時(shí),如果時(shí)區(qū)無效則會(huì)引發(fā) E_NOTICE
錯(cuò)誤。參見
date_default_timezone_set()。
版本 | 說明 |
---|---|
5.1.0 |
現(xiàn)在發(fā)布 |
用指定的格式 format
返回日落時(shí)間, 或者在失敗時(shí)返回 false
。
示例 #1 date_sunset() 例子
<?php
/* calculate the sunset time for Lisbon, Portugal
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
offset: +1 GMT
*/
echo date("D M d Y"). ', sunset time : ' .date_sunset(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
以上例程的輸出類似于:
Mon Dec 20 2004, sunset time : 18:13