(PHP 5, PHP 7)
date_sunset — Возвращает время захода солнца для заданных дня и местоположения
$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.sunset_zenith")
[, float $gmt_offset = 0
]]]]] ) : mixed
date_sunset() возвращает время захода солнца для
определенных дня (заданного аргументом timestamp)
и местоположения.
timestamp
Временная метка (timestamp) дня, для которого
определяется время захода солнца.
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
zenith - это угол между центром Солнца и линией,
перпендикулярной поверхности Земли. По умолчанию
date.sunset_zenith
| Угол | Опиание |
|---|---|
| 90°50' | Восход солнца: точка, где Солнце становится невидимым. |
| 96° | Гражданские сумерки: обычно используются для обозначения конца заката. |
| 102° | Навигационные сумерки: точка, в которой горизонт становится невидимым с моря. |
| 108° | Астрономические сумерки: точка, в которой Солнце заканчивает быть источником любого освещения. |
gmtoffset
Задается в часах.
gmtoffset игнорируется, если
format - SUNFUNCS_RET_TIMESTAMP.
Каждый вызов к функциям даты/времени при неправильных настройках временной зоны сгенерирует ошибку уровня E_NOTICE,
и/или ошибку уровня E_STRICT или E_WARNING при использовании системных
настроек или переменной окружения TZ. Смотрите также date_default_timezone_set()
| Версия | Описание |
|---|---|
| 5.1.0 |
Теперь ошибки, связанные с временными зонами, генерируют ошибки уровня |
Возвращает время захода солнца в заданном формате
format или FALSE в случае возникновения ошибки. Одна из возможных причин неудачного выполнения - солнце не поднимается над горизонтом вообще, что происходит внутри полярных кругов в течение части года.
Пример #1 Пример использования date_sunset()
<?php
/* calculate the sunset time for Lisbon, Portugal
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
offset: +1 GMT
*/
echo date("D M d Y"). ', время захода солнца : ' .date_sunset(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
Результатом выполнения данного примера будет что-то подобное:
Mon Dec 20 2004, время захода солнца : 18:13
Пример #2 Нет заката
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunset($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
Результат выполнения данного примера:
bool(false)