Função PHP date_sunset ()
Definição e Uso
o date_sunset() A função aceita um carimbo de data / hora que representa o dia especificado e retorna a hora do pôr do sol naquele dia específico.
Sintaxe
date_sunset($timestamp, [$format, $latitude, $longitude, $zenith, $gmtoffset])
Parâmetros
Sr. Não | Parâmetro e Descrição |
---|---|
1 | timestamp (Mandatory) Isso especifica um carimbo de data / hora. |
2 | format (Optional) Isso especifica o formato no qual você precisa do valor resultante. Você pode passar três constantes como o valor desse parâmetro, a saber; SUNFUNCS_RET_STRING ( string ), SUNFUNCS_RET_DOUBLE ( float ) e, SUNFUNCS_RET_TIMESTAMP inteiro . |
3 | latitude (Optional) Isso especifica a latitude de um local por padrão, isso especifica a direção Norte. Para especificar um valor de latitude no sul, você precisa passá-lo como um valor negativo. |
4 | longitude (Optional) Isso especifica a longitude de um local por padrão, isso especifica a direção leste. Para especificar um valor de latitude no oeste, você precisa passá-lo como um valor negativo. |
5 | zenith (Optional) Isso especifica o valor zenital. Isso especifica o ângulo entre a linha perpendicular à superfície da Terra e o centro do sol. |
6 | gmtoffset (Optional) Isso especifica a diferença entre GMT e a hora local em horas. |
Valores Retornados
A função PHP date_sunset () retorna a hora do pôr do sol no formato desejado. Em caso de falha, ele retorna o valor booleano falso .
Versão PHP
Esta função foi introduzida pela primeira vez no PHP Versão 5.0 e funciona com todas as versões posteriores.
Exemplo
O exemplo a seguir demonstra o uso da função date_sunset () -
<?php
$sun_info = date_sunset("02-17-2012");
print_r($sun_info);
?>
Isso produzirá o seguinte resultado -
14:46
Exemplo
Agora, vamos invocar essa função passando os valores de latitude e longitude. Se você deseja passar os valores de latitude e longitude, é obrigatório passar o valor do formato exigido também -
<?php
$sun_info = date_sunset("02-03-2020",SUNFUNCS_RET_STRING, 23.4, -25);
print_r("Sunset Time: ".$sun_info);
?>
Isso produzirá o seguinte resultado -
Sunset Time: 19:05
Exemplo
O exemplo a seguir verifica o caso de não ocaso -
<?php
$sun_info = date_sunset("25-12-2016",SUNFUNCS_RET_STRING, 69, 41);
print("Sunset Time: ".$sun_info);
print("\n");
var_dump($sun_info);
?>
Isso produzirá o seguinte resultado -
Sunset Time:
bool(false)
Exemplo
<?php
echo("Date: " . date("D M d Y"));
echo("\n");
echo("Sunset time: ");
echo(date_sunset(time(),SUNFUNCS_RET_STRING,38.4,-9,90,1));
?>
Isso produzirá o seguinte resultado -
Date: Thu May 07 2020
Sunset time: 20:30