date_sunrise

    (PHP 5, PHP 7, PHP 8)

    date_sunrise — Retorna a hora do nascer do sol para um dia e uma localicação informados

    Aviso

    Esta função foi DESCONTINUADA desde o PHP 8.1.0. Confiar nesta função é altamente desencorajado. Use date_sun_info() no lugar.

    Descrição

    date_sunrise(
        int$timestamp,
        int$returnFormat = SUNFUNCS_RET_STRING,
        ?float$latitude = null,
        ?float$longitude = null,
        ?float$zenith = null,
        ?float$utcOffset = null
    ): string|int|float|false

    A função date_sunrise() retorna a hora do nascer do sol para um dia (especificado como um timestamp) e uma localização informados.

    Parâmetros

    timestamp

    O timestamp do nascer do sol do dia desejado.

    returnFormat

    Constantes de returnFormat
    ConstanteDescriçãoExemplo
    SUNFUNCS_RET_STRINGRetorna o resultado como uma string16:46
    SUNFUNCS_RET_DOUBLERetorna o resultado como um float16.78243132
    SUNFUNCS_RET_TIMESTAMPRetorna o resultado como um int (timestamp)1095034606
    latitude

    Padronizado para o norte, passe um valor negativo para o sul. Veja também: date.default_latitude

    longitude

    Padronizado para o leste, passe um valor negativado para o oeste. Veja também: date.default_longitude

    zenith

    zenith é o ângulo entre o centro do sol e uma linha perpendicular à superfície da Terra. É padronizado para date.sunrise_zenith

    Ângulos comuns em relação ao zenith
    ÂnguloDescrição
    90°50'Nascer do sol: o ponto onde o sol se torna visível.
    96°Amanhecer civil: convencionado para significar o início do amanhecer.
    102°Amanhecer náutico: o ponto no qual o horizonte começa a ficar visível no mar.
    108°Amanhecer astronômico: o ponto no qual o sol começa a se tornar fonte de iluminação.
    utcOffset

    Especificado em horas. O parâmetro utcOffset é ignorado se returnFormat for SUNFUNCS_RET_TIMESTAMP.

    Valor Retornado

    Retorna o horário do nascer do sol no returnFormat especificado em caso de sucesso ou false em caso de falha. Um potencial motivo para falha é quando o sol não nasce, o que acontece dentro dos círculos polares durante parte do ano.

    Erros/Exceções

    Toda chamada a uma função de data/hora gerará um E_WARNING se o fuso horário não for válido. Veja também date_default_timezone_set()

    Registro de Alterações

    VersãoDescrição
    8.1.0 Esta função foi descontinuada em favor de date_sun_info().
    8.0.0latitude, longitude, zenith e utcOffset agora podem ser nulos.

    Exemplos

    Exemplo #1 Exemplo da função date_sunrise()

    <?php



    echo date("D M d Y"). ', horário do nascer do sol : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);

    ?>

    O exemplo acima produzirá algo semelhante a:

    Mon Dec 20 2004, horário do nascer do sol : 08:54

    Exemplo #2 Sem nascer do sol

    <?php
    $solstice     = strtotime('2017-12-21');
    var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
    ?>

    O exemplo acima produzirá:

    bool(false)

    Veja Também

    • date_sun_info() - Retorna um array com informações sobre pôr/nascer do sol e o início/fim do dia
    To Top