(PHP 5, PHP 7, PHP 8)
date_sunrise — Возвращает время рассвета для заданных дня и местоположения
Функция УСТАРЕЛА, начиная с PHP 8.1.0. Полагаться на эту функцию крайне не рекомендуется. Используйте вместо неё функцию date_sun_info().
$timestamp
,$returnFormat
= SUNFUNCS_RET_STRING
,$latitude
= null
,$longitude
= null
,$zenith
= null
,$utcOffset
= null
date_sunrise() возвращает время рассвета для
определённых дня (заданного аргументом timestamp
)
и местоположения.
timestamp
Временная метка (timestamp
) дня, для которого
определяется время рассвета.
returnFormat
константа | описание | пример |
---|---|---|
SUNFUNCS_RET_STRING | тип возвращаемого результата string | 16:46 |
SUNFUNCS_RET_DOUBLE | тип возвращаемого результата float | 16.78243132 |
SUNFUNCS_RET_TIMESTAMP | тип возвращаемого результата int (временная метка) | 1095034606 |
latitude
По умолчанию в Северном полушарии, для Южного передаётся отрицательная величина. Смотрите также date.default_latitude.
longitude
По умолчанию восточная, для указания западной долготы передаётся отрицательная величина. Смотрите также date.default_longitude.
zenith
zenith
- это угол между центром Солнца и линией,
перпендикулярной поверхности Земли. По умолчанию
date.sunrise_zenith
Угол | Описание |
---|---|
90°50' | Восход солнца: точка, где Солнце становится видимым. |
96° | Гражданские сумерки: обычно используются для обозначения начала рассвета. |
102° | Навигационные сумерки: точка, в которой горизонт становится видимым с моря. |
108° | Астрономические сумерки: точка, в которой Солнце начинает быть источником любого освещения. |
utcOffset
Задаётся в часах.
utcOffset
игнорируется, если
returnFormat
-
SUNFUNCS_RET_TIMESTAMP
Возвращает время восхода солнца в заданном формате
returnFormat
или false
в случае возникновения ошибки. Одна из возможных причин неудачного выполнения - солнце не поднимается над горизонтом вообще, что происходит внутри полярных кругов в течение части года.
Каждый вызов к функциям даты/времени при неправильных настройках часового пояса сгенерирует ошибку уровня E_WARNING
,
если часовой пояс некорректный. Смотрите также date_default_timezone_set()
Версия | Описание |
---|---|
8.1.0 | Функция объявлена устаревшей, используйте вместе неё date_sun_info(). |
8.0.0 |
latitude , longitude ,
zenith и utcOffset теперь допускают значение null.
|
Пример #1 Пример использования date_sunrise()
<?php
/* расчёт времени восхода солнца в Лиссабоне, Португалия
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
offset: +1 GMT
*/
echo date("D M d Y"). ', время восхода солнца : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
Результатом выполнения данного примера будет что-то подобное:
Mon Dec 20 2004, время восхода солнца : 08:54
Пример #2 Нет восхода солнца
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
Результат выполнения данного примера:
bool(false)