date_sunset()函數(shù)返回給定日期/地點(diǎn)的日落時(shí)間。
date_sunset()函數(shù)接受表示給定一天的時(shí)間戳,并返回該特定日期的日落時(shí)間。
date_sunset($timestamp, [$format, $latitude, $longitude, $zenith, $gmtoffset])
序號 | 參數(shù)及說明 |
---|---|
1 | timestamp (必需) 這指定一個(gè)時(shí)間戳。 |
2 | format (可選) 這指定了您需要使用結(jié)果值的格式。您可以傳遞三個(gè)常量作為該參數(shù)的值; 即:SUNFUNCS_RET_STRING(字符串),SUNFUNCS_RET_DOUBLE(浮點(diǎn)數(shù))和SUNFUNCS_RET_TIMESTAMP 整數(shù)。 |
3 | latitude (可選) 默認(rèn)情況下,此選項(xiàng)指定位置的緯度,此選項(xiàng)指定北向。 要指定南部的緯度值,需要將其作為負(fù)值傳遞。 |
4 | longitude (可選) 默認(rèn)情況下,它指定一個(gè)位置的經(jīng)度,它指定東方向。要指定西面的緯度值,需要將其作為負(fù)值傳遞。 |
5 | zenith (可選) 這指定了天頂值。這指定了垂直于地球表面的線與太陽中心之間的角度。 |
6 | gmtoffset (可選) 這指定了GMT與當(dāng)?shù)貢r(shí)間之間的時(shí)差(以小時(shí)為單位)。 |
date_sunset()函數(shù)以所需格式返回日落時(shí)間。如果失敗,它將返回布爾值false。
此函數(shù)最初是在PHP 5.0版中引入的,并且可以在所有更高版本中使用。
以下示例演示了date_sunset()函數(shù)的用法-
<?php $sun_info = date_sunset("02-17-2012"); print_r($sun_info); ?>測試看看?/?
輸出結(jié)果
14:46
現(xiàn)在,通過傳遞緯度和經(jīng)度值來調(diào)用此函數(shù)。如果您想傳遞緯度和經(jīng)度值,則也必須傳遞所需格式的值-
<?php $sun_info = date_sunset("02-03-2020",SUNFUNCS_RET_STRING, 23.4, -25); print_r("Sunset Time: ".$sun_info); ?>測試看看?/?
輸出結(jié)果
Sunset Time: 19:05
以下示例驗(yàn)證了沒有日落的情況-
<?php $sun_info = date_sunset("25-12-2016",SUNFUNCS_RET_STRING, 69, 41); print("Sunset Time: ".$sun_info); print("\n"); var_dump($sun_info); ?>測試看看?/?
輸出結(jié)果
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)); ?>測試看看?/?
輸出結(jié)果
Date: Thu May 07 2020 Sunset time: 20:30