date_sunrise
(PHP 5)
date_sunrise — 指定した日付と場所についての日の出時刻を返す
説明
mixed 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
]]]]] )
date_sunrise() は、与えられた日付 (timestamp で指定する) と場所についての日の出の時刻を返します。
パラメータ
- timestamp
-
日の出時刻を取得する日の timestamp。
- format
-
format 定数 定数 説明 例 SUNFUNCS_RET_STRING 結果を string で返します。 16:46 SUNFUNCS_RET_DOUBLE 結果を float で返します。 16.78243132 SUNFUNCS_RET_TIMESTAMP 結果を integer (タイムスタンプ) で返します。 1095034606 - latitude
-
デフォルトは北緯で、南緯は負の値で表します。 date.default_latitude も参照ください。
- longitude
-
デフォルトは東経で、西経は負の値で表します。 date.default_longitude も参照ください。
- zenith
-
デフォルトは date.sunrise_zenith です。
- gmtoffset
-
時間単位で指定します。
返り値
日の出時刻を、指定した format で返します。 失敗した場合に FALSE を返します。
エラー / 例外
すべての日付/時刻関数は、 有効なタイムゾーンが設定されていない場合に E_NOTICE を発生させます。また、システム設定のタイムゾーンあるいは環境変数 TZ を使用した場合には E_STRICT あるいは E_WARNING を発生させます。 date_default_timezone_set() も参照ください。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.1.0 | タイムゾーンがおかしい場合に E_STRICT や E_NOTICE が発生するようになりました。 |
例
例1 date_sunrise() の例
<?php
/* ポルトガル リスボンの日の出時刻を計算する
緯度: 北緯 38.4
経度: 西経 9
天頂 ~= 90
時差: +1 GMT
*/
echo date("D M d Y"). ', sunrise time : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
上の例の出力は、 たとえば以下のようになります。
Mon Dec 20 2004, sunrise time : 08:54
