(PHP 5, PHP 7, PHP 8)
date_sunrise — Belirtilen gün ve konum için şafak zamanını döndürür
PHP 8.1.0 ve sonrasında bu işlevin kullanımı ÖNERİLMEMEKTEDİR. Bu işleve asla güvenilmemelidir. Yerine date_sun_info() işlevi kullanılmalıdır.
$dönüş_biçimi = SUNFUNCS_RET_STRING,$enlem = null,$boylam = null,$başucu = null,$utc_farkı = null
date_sunrise() işlevi, verilen gün
(zamandamgası) ve konum için şafak zamanını
döndürür.
zamandamgası
Şafak zamanı öğrenilecek günün zamandamgası.
dönüş_biçimi
| sabit | açıklama | örnek |
|---|---|---|
| SUNFUNCS_RET_STRING | Sonucu dizge olarak döndürür. | 16:46 |
| SUNFUNCS_RET_DOUBLE | Sonucu gerçek sayı olarak döndürür. | 16.78243132 |
| SUNFUNCS_RET_TIMESTAMP | Sonucu tamsayı (zaman damgası) olarak döndürür. | 1095034606 |
enlemKuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer girilir. Ayrıca bakınız: date.default_latitude
boylamDoğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer girilir. Ayrıca bakınız: date.default_longitude
başucu
başucu, güneşin merkezi ile dünya yüzeyine dik
bir çizgi arasındaki açıdır. Öntanımlı değer:
date.sunrise_zenith
| Açı | Açıklama |
|---|---|
| 90°50' | Gündoğumu: Güneşin görünür hale geldiği nokta. |
| 96° | Sivil alacakaranlık: Geleneksel olarak şafağın başlangıcını belirtmek için kullanılır. |
| 102° | Deniz alacakaranlığı: Ufkun denizde görünmeye başladığı nokta. |
| 108° | Astronomik alacakaranlık: Güneşin herhangi bir aydınlatmanın kaynağı olmaya başladığı nokta. |
utc_farkı
Saat cinsinden belirtilir.
dönüş_biçimi değeri
SUNFUNCS_RET_TIMESTAMP ise
utc_farkı yoksayılır.
Başarılı olduğunda, dönüş_biçimi bağımsız değişkeniyle
belirlenen biçimde şafak zamanı, başarısızlık durumunda false döner. Başarısızlığın
olası nedeni, yılın bir bölümünde kutup dairesinin içinde güneşin hiç
doğmamasıdır.
Bir tarih/zaman işlevine
yapılan her çağrı eğer zaman dilimi ayarı geçerli değilse bir
E_WARNING üretir. Ayrıca bakınız:
date_default_timezone_set()
| Sürüm: | Açıklama |
|---|---|
| 8.1.0 | Bu işlevin kullanımı önerilmemekte olup yerine date_sun_info() işlevi önerilmektedir. |
| 8.0.0 |
enlem, botlam,
başucu ve utc_farkı
artık null olabiliyor.
|
Örnek 1 - date_sunrise() örneği
<?php
/* İstanbul, Türkiye için şafak hesabı
Enlem: 41.01 Kuzey
Boylam: 28.58 Doğu
Başucu ~= 90
saat farkı: +2 GMT
*/
echo date("D M d Y"). ', şafak: ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 41.01, 28.58, 90, 2);
?>Yukarıdaki örnek şuna benzer bir çıktı üretir:
Fri Dec 12 2008, şafak: 07:25
Örnek 2 - Güneşin doğmaması
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>Yukarıdaki örneğin çıktısı:
bool(false)