date_sunset
(PHP 5, PHP 7, PHP 8)
date_sunset — Повертає час заходу сонця для заданого дня та місця розташування
Увага
ФункцияЗАСТАРІЛАпочинаючи з PHP 8.1.0. Покладатися на цю функцію не рекомендується. Використовуйте замість неї функцію date_sun_info()
Опис
date_sunset( int $timestamp, int $returnFormat = SUNFUNCS_RET_STRING, ?float $latitude = null, ?float $longitude = null, ?float $zenith = null, ?float $utcOffset = null): string|int|float|false
date_sunset() повертає час заходу сонця для певних днів (заданого аргументом timestamp) та місця розташування.
Список параметрів
timestamp
Тимчасова мітка (timestamp) Дня, для якого визначається час заходу сонця.
returnFormat
Константи 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.sunset_zenith
Поширені кути 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 | latitudelongitudezenithиutcOffset тепер допускають значення null. |
Приклади
Приклад #1 Приклад використання date_sunset()****
Висновок наведеного прикладу буде схожим на:
Mon Dec 20 2004, время захода солнца : 18:13
Приклад #2 Немає заходу сонця
Результат виконання наведеного прикладу:
bool(false)
Дивіться також
- date_sun_info() - Повертає масив з інформацією про захід сонця/світанок і початок/закінчення сутінків