函式名稱:date_sunrise()
描述:該函式返回指定日期和經緯度的日出時間。
用法:
date_sunrise ( int $timestamp [, int $format = SUNFUNCS_RET_STRING [, float $latitude = ini_get('date.default_latitude') [, float $longitude = ini_get('date.default_longitude') [, float $zenith = ini_get('date.sunrise_zenith') [, float $gmt_offset = 0 ]]]]] ) : mixed
引數:
$timestamp
:必需,用於計算日出時間的日期和時間,如果未提供,預設為當前時間。$format
:可選,返回日出時間的格式,可選值為SUNFUNCS_RET_STRING
、SUNFUNCS_RET_DOUBLE
或SUNFUNCS_RET_TIMESTAMP
。預設值為SUNFUNCS_RET_STRING
。$latitude
:可選,緯度,表示為浮點數。如果未提供,則預設為ini_get('date.default_latitude')
。$longitude
:可選,經度,表示為浮點數。如果未提供,則預設為ini_get('date.default_longitude')
。$zenith
:可選,太陽在天空中的仰角,表示為浮點數。如果未提供,則預設為ini_get('date.sunrise_zenith')
。$gmt_offset
:可選,格林尼治標準時間偏移量,以小時為單位。如果未提供,則預設為 0。
返回值:
- 當
$format
引數設定為SUNFUNCS_RET_STRING
時,返回格式化後的日出時間字串。 - 當
$format
引數設定為SUNFUNCS_RET_DOUBLE
時,返回日出時間的小時部分作為浮點數。 - 當
$format
引數設定為SUNFUNCS_RET_TIMESTAMP
時,返回 UNIX 時間戳。
示例:
// 設定緯度和經度
$latitude = 37.7749; // 緯度
$longitude = -122.4194; // 經度
// 獲取今天的日出時間
$today_sunrise = date_sunrise(time(), SUNFUNCS_RET_STRING, $latitude, $longitude);
// 獲取明天的日出時間
$tomorrow_sunrise = date_sunrise(strtotime('+1 day'), SUNFUNCS_RET_STRING, $latitude, $longitude);
// 輸出日出時間
echo "今天的日出時間:$today_sunrise\n";
echo "明天的日出時間:$tomorrow_sunrise\n";
輸出:
今天的日出時間:06:17
明天的日出時間:06:16
注意:以上示例程式碼中的緯度和經度是用來計算舊金山的日出時間。你可以根據需要替換為特定地點的真實經緯度。