Retorna um array com informações sobre pôr/nascer do sol e o início/fim do dia

Descrição

date_sun_info(int $timestamp, float $latitude, float $longitude): array

Parâmetros

timestamp: Timestamp Unix.
latitude: Latitude em graus.
longitude: Longitude em graus.

Valor Retornado

Retorna um cuja estrutura é detalhada na lista abaixo:

sunrise: O timestamp do nascer do sol (ângulo em relação ao zênite = 90°35').
sunset: O timestamp do pôr do sol (ângulo em relação ao zênite = 90°35').
transit: O timestamp quando o sol está em seu zênite, ou seja, atingiu seu ponto mais alto.
civil_twilight_begin: O início do amanhecer civil (ângulo em relação ao zênite = 96°). Termina no sunrise.
civil_twilight_end: O final do crepúsculo civil (ângulo em relação ao zênite = 96°). Começa no sunset.
nautical_twilight_begin: O início do amanhecer náutico (ângulo em relação ao zênite = 102°). Termina no civil_twilight_begin.
nautical_twilight_end: O final do crepúsculo náutico (ângulo em relação ao zênite = 102°). Começa no civil_twilight_end.
astronomical_twilight_begin: O início do amanhecer astronômico (ângulo em relação ao zênite = 108°). Termina no nautical_twilight_begin.
astronomical_twilight_end: O final do crepúsculo astronômico (ângulo em relação ao zênite = 108°). Começa no nautical_twilight_end.

Os valores dos elementos do array podem ser timestamps UNIX, false se o sol estiver abaixo do respectivo ângulo durante todo o dia, or true se o sol estiver acima do respectivo ângulo durante todo o dia.

Registro de Alterações

Versão	Descrição
7.2.0	Os cálculos foram corrigidos com base na meia-noite local em vez do meio-dia local, o que muda os resultados um pouco.

Exemplos

Example #1 Um exemplo de date_sun_info()

<?php
$sun_info = date_sun_info(strtotime("2006-12-12"), 31.7667, 35.2333);
foreach ($sun_info as $key => $val) {
    echo "$key: " . date("H:i:s", $val) . "\n";
}
?>

O exemplo acima produzirá:

sunrise: 05:52:11
sunset: 15:41:21
transit: 10:46:46
civil_twilight_begin: 05:24:08
civil_twilight_end: 16:09:24
nautical_twilight_begin: 04:52:25
nautical_twilight_end: 16:41:06
astronomical_twilight_begin: 04:21:32
astronomical_twilight_end: 17:12:00

Example #2 Noite polar, com algum processamento

<?php
$tz = new \DateTimeZone('America/Anchorage');

$si = date_sun_info(strtotime("2022-12-21"), 70.21, -148.51);
foreach ($si as $key => $value) {
    echo
        match ($value) {
            true => 'always',
            false => 'never',
            default => date_create("@{$value}")->setTimeZone($tz)->format( 'H:i:s T' ),
        },
        ": {$key}",
        "\n";
}
?>

O exemplo acima produzirá:

never: sunrise
never: sunset
12:52:18 AKST: transit
10:53:19 AKST: civil_twilight_begin
14:51:17 AKST: civil_twilight_end
09:01:47 AKST: nautical_twilight_begin
16:42:48 AKST: nautical_twilight_end
07:40:47 AKST: astronomical_twilight_begin
18:03:49 AKST: astronomical_twilight_end

Example #3 Sol da meia-noite (Tromsø, Norway)

<?php
$si = date_sun_info(strtotime("2022-06-26"), 69.68, 18.94);
print_r($si);
?>

O exemplo acima produzirá:

Array
(
    [sunrise] => 1
    [sunset] => 1
    [transit] => 1656240426
    [civil_twilight_begin] => 1
    [civil_twilight_end] => 1
    [nautical_twilight_begin] => 1
    [nautical_twilight_end] => 1
    [astronomical_twilight_begin] => 1
    [astronomical_twilight_end] => 1
)

Example #4 Calculando a duração do dia (Kiev)

<?php
$si = date_sun_info(strtotime('2022-08-26'), 50.45, 30.52);
$diff = $si['sunset'] - $si['sunrise'];
echo "Duração do dia: ",
    floor($diff / 3600), "h ",
    floor(($diff % 3600) / 60), "s\n";
?>

O exemplo acima produzirá:

Duração do dia: 13h 56s