gregoriantojd
(PHP 4, PHP 5, PHP 7, PHP 8)
gregoriantojd — Converte uma data gregoriana para o "Julian Day Count"
Descrição
A escala válida para o Calendário Gregoriano é de 25 de Novembro, 4714 A.C. até pelo menos 31 de Dezembro, 9999 D.C.
Entretanto esta função pode trabalhar com todas datas anteriores à, porém usá-la desta maneira não tem muito sentido. O Calendário Gregoriano não foi instituído até 15 de Outubro de 1582 (ou 5 de Outubro de 1582, no calendário JDC ("Julian Day Count")). Alguns países aceitaram este calendário um pouco mais tarde. Por exemplo, a Grã Bretanha converteu-se em 1752, a URSS em 1918 e a Grécia em 1923. A maioria dos países Europeus usaram o calendário "Julian" (JDC) antes do calendário Gregoriano.
Parâmetros
month
-
O mês como um número entre 1 (para janeiro) e 12 (para dezembro)
day
-
O dia como um número entre 1 e 31 Se o mês tem menos dias do que o especificado; veja o exemplo abaixo.
year
-
O ano como um número entre -4714 e 9999 Números negativos indicam anos A.C., números positivos indicam anos D.C. Note que não existe ano
0
; 31 de Dezembro, 1 A.C. é seguido emediatamente por 1 de Janeiro, 1 D.C.
Valor Retornado
A data juliana para a dada data gregoriana como um inteiro.
Datas fora da escala válida retornam 0
.
Exemplos
Example #1 Funções de Calendário
<?php
$jd = gregoriantojd(10,11,1970);
echo "$jd\n";
$gregorian = jdtogregorian($jd);
echo "$gregorian\n";
?>
O exemplo acima produzirá:
2440871 10/11/1970
Example #2 Overflow behavior
<?php
echo gregoriantojd(2, 31, 2018), PHP_EOL,
gregoriantojd(3, 3, 2018), PHP_EOL;
?>
O exemplo acima produzirá:
2458181 2458181
Veja Também
- jdtogregorian() - Converte uma data no formato "Julian Day Count" para o formato Gregoriano
- cal_to_jd() - Converte um calendário (suportado) para o calendário "Julian Day Count"