PHP의 easter_date() 함수는 지정된 연도의 부활절(Easter) 날짜 자정 시각에 해당하는 Unix 타임스탬프를 반환합니다. 이 함수는 캘린더(calendar) 확장 모듈에 포함되어 있으며, 특정 연도의 부활절이 언제인지 프로그램에서 손쉽게 계산해야 할 때 유용하게 사용됩니다.
문법(Syntax)
easter_date(year)
매개변수(Parameters)
year − 부활절 날짜를 구하고자 하는 연도를 지정합니다. 1970년부터 2037년 사이의 값만 사용할 수 있으며, 생략할 경우 기본값으로 현재 연도가 적용됩니다.
연도 범위 제한의 이유
easter_date() 함수가 1970~2037년으로 제한되는 이유는 32비트 환경에서 Unix 타임스탬프가 표현할 수 있는 범위와 관련이 있습니다. 이 범위를 벗어나는 값을 입력하면 함수가 경고(warning)를 발생시키며 올바른 결과를 반환하지 않으므로 주의해야 합니다.
반환값(Return)
지정한 연도의 부활절 날짜(자정 기준)를 Unix 타임스탬프 형태로 반환합니다.
사용 예제
다음은 easter_date() 함수의 기본적인 사용 예제입니다.
<?php
echo easter_date() . "<br />";
echo date("M-d-Y", easter_date()) . "<br />";
echo date("M-d-Y", easter_date(2017)) . "<br />";
?>
실행 결과(Output)
위 예제를 실행하면 다음과 같은 결과가 출력됩니다.
1522555200
Apr-01-2018
Apr-16-2017
결과 해설
첫 번째 줄은 매개변수 없이 호출하여 현재 연도(2018년)의 부활절 타임스탬프인 1522555200을 출력합니다. 두 번째 줄은 date() 함수와 함께 사용해 사람이 읽기 쉬운 형식인 Apr-01-2018(2018년 4월 1일)로 변환한 결과입니다. 세 번째 줄은 2017년을 직접 지정하여 해당 연도의 부활절인 Apr-16-2017(2017년 4월 16일)을 출력합니다.
참고 사항
easter_date()는 타임스탬프만 반환하기 때문에, 실제 날짜 문자열이 필요하다면 위 예제처럼 date() 함수와 조합하여 사용하는 것이 일반적입니다. 또한 부활절 날짜는 서양 교회력 기준(그레고리력)으로 계산되며, 동방교회(정교회)가 사용하는 율리우스력 기준 날짜와는 다를 수 있다는 점도 참고하시기 바랍니다.