array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.date-sunrise.php', 1 => 'date_sunrise', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Функции даты и времени', ), 'prev' => array ( 0 => 'function.date-sun-info.php', 1 => 'date_sun_info', ), 'next' => array ( 0 => 'function.date-sunset.php', 1 => 'date_sunset', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/datetime/functions/date-sunrise.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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)