gregoriantojd

(PHP 4, PHP 5, PHP 7, PHP 8)

gregoriantojdConverte uma data gregoriana para o "Julian Day Count"

Descrição

gregoriantojd(int $month, int $day, int $year): int

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"