date_sun_info

(PHP 5 >= 5.1.2, PHP 7, PHP 8)

date_sun_infoRetorna 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 array em caso de sucesso ou false em caso de falha. A estrutura do array é 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

Exemplo #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

Exemplo #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

Exemplo #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
)

Exemplo #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

add a note add a note

User Contributed Notes 1 note

up
8
TheFax
2 years ago
In the last example, conversion from seconds to Hour, Minutes, Seconds is wrong.
This is the correct verion:

<?php
$si
= date_sun_info(strtotime('2022-08-26'), 50.45, 30.52);
$diff = $si['sunset'] - $si['sunrise'];  # $diff is measured in seconds.
echo "Length of day: ",
   
floor($diff / 3600), "h",
   
floor(($diff % 3600) / 60), "m",
   
floor($diff % 60), "s\n";
?>

Output:
  Length of day: 13h53m15s
To Top