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

列印頁面