PHP GregorianToJD() 함수란?
GregorianToJD() 함수는 그레고리력(Gregorian calendar)으로 표현된 날짜를 율리우스 일수(Julian day count)로 변환하는 PHP 내장 함수입니다. 이 함수는 변환된 결과로 율리우스 일 번호(Julian day number)를 정수 형태로 반환합니다.
율리우스 일 번호는 특정 기준일로부터 경과한 일수를 나타내는 연속적인 숫자 체계로, 서로 다른 달력 체계 간의 날짜 계산이나 비교에 유용하게 활용됩니다.
참고 − 그레고리력의 유효 범위는 기원전 4714년 11월 25일부터 서기 9999년 12월 31일까지입니다. 이 범위를 벗어나는 날짜를 입력하면 올바른 결과가 보장되지 않습니다.
구문(Syntax)
GregorianToJD(month, date, year)
매개변수(Parameters)
month − 월을 의미하며, 1부터 12 사이의 숫자로 지정합니다.
date − 일을 의미하며, 1부터 31 사이의 숫자로 지정합니다.
year − 연도를 의미하며, -4714부터 9999 사이의 숫자로 지정합니다.
반환값(Return)
GregorianToJD() 함수는 입력된 그레고리력 날짜에 해당하는 율리우스 일 번호를 정수로 반환합니다.
사용 예제
다음은 GregorianToJD() 함수를 활용한 예제 코드입니다. 이 예제에서는 2017년 9월 27일을 율리우스 일수로 변환한 뒤, 반대로 jdtogregorian() 함수를 사용하여 다시 그레고리력 날짜로 되돌리는 과정을 보여줍니다.
<?php
$jd = gregoriantojd(9,27,2017);
echo $jd . "<br>";
echo jdtogregorian($jd);
?>
실행 결과(Output)
2458024
9/27/2017
예제 설명
먼저 gregoriantojd(9, 27, 2017) 호출을 통해 2017년 9월 27일이 율리우스 일 번호 2458024로 변환됩니다. 이후 jdtogregorian($jd) 함수에 해당 값을 전달하면 원래의 그레고리력 날짜인 9/27/2017이 출력되는 것을 확인할 수 있습니다. 이처럼 두 함수는 서로 반대 방향의 변환을 수행하므로, 날짜 데이터를 다양한 형식으로 처리해야 하는 프로그램에서 함께 자주 사용됩니다.