指定した日付と場所についての日の出時刻を返す

# date_sunrise

(PHP 5, PHP 7)

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

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

### 参考

- date_sunset() - 指定した日付と場所についての日の入り時刻を返す