Docs For Class Lunar

int cal2jd(
array
$v, [
$julian = false])

Gregorian 날자를 Julian date로 변환

Tags:

return:	Julian date
access:	public

Parameters:

array	$v	연월일 배열 : array ($y, $m, $d)
	$julian

[ Top ]

stdClass dayfortune(
[int|string
$v = null])

세차(년)/월건(월)/일진(일) 데이터를 구한다.

예제:

/*
* $lunar->dayfortuen ($date)
*
* input:
* 2013-07-16 or
* 2013-7-16 or
* 20130716 or
* 1373900400 or
* NULL
*
* output:
* stdClass Object
* (
* [data] => stdClass Object
* (
* [y] => 29 // 세차 index
* [m] => 55 // 월건 index
* [d] => 19 // 일진 index
* )
*
* [year] => 계사 // 세차 값
* [month] => 기미 // 월건 값
* [day] => 계미 // 일진 값
* [hyear] => 癸巳 // 한자 세차 값
* [hmonth] => 己未 // 한자 월건 값
* [hday] => 癸未 // 한자 일진 값
* )
*/
print_r ($lunar->dayfortune ('2013-07-16'));
/*
* 7월 1일 부터 30일 까지의 일진을 구할 경우
* 다음은 아주 안좋은 방법이다.
*/
for ( $i=1; $i<31; $i++ ) {
$r = $lunar->dayfortune ('2013-07-' . $i);
$iljin[$i] = $r->day;
}
/*
* 위의 경우는 아래와 같이 $lunar->ganji_ref method를 이용하여
* 성능을 높일 수 있다.
*/
$r = $lunar->dayfortune ('2013-07-01');
$iljin[$i] = $r->day;
$gindex = $r->data->d;
for ( $i=2; $i<31; $i++ ) {
$gindex++;
if ( $gindex >= 60 )
$gindex -= 60;
$iljin[$i] = $lunar->ganji_ref[$gindex];

Tags:

return:

   stdClass Object
   (
       [data] => stdClass Object
           (
                [y] => 29           // 세차 index
                [m] => 55           // 월건 index
                [d] => 19           // 일진 index
           )

       [year] => 계사               // 세차 값
       [month] => 기미              // 월건 값
       [day] => 계미                // 일진 값
       [hyear] => 癸巳              // 한자 세차 값
       [hmonth] => 己未             // 한자 월건 값
       [hday] => 癸未               // 한자 일진 값
   )

access:

public

Parameters:

int|string

$v

날자형식

unixstmap (1970년 12월 15일 이후부터 가능)
Ymd or Y-m-d
null data (현재 시간)
1582년 10월 15일 이전의 날자는 율리우스력의 날자로 취급함.

[ Top ]

string ganji_ref(
int
$no, [bool
$mode = false])

dayfortune method의 ganji index 반환값을 이용하여, ganji 값을 구함

예제:

/*
* $lunar->dayfortuen ($date)
*
* input:
* 2013-07-16 or
* 2013-7-16 or
* 20130716 or
* 1373900400 or
* NULL
*
* output:
* stdClass Object
* (
* [data] => stdClass Object
* (
* [y] => 29 // 세차 index
* [m] => 55 // 월건 index
* [d] => 19 // 일진 index
* )
*
* [year] => 계사 // 세차 값
* [month] => 기미 // 월건 값
* [day] => 계미 // 일진 값
* [hyear] => 癸巳 // 한자 세차 값
* [hmonth] => 己未 // 한자 월건 값
* [hday] => 癸未 // 한자 일진 값
* )
*/
print_r ($lunar->dayfortune ('2013-07-16'));
/*
* 7월 1일 부터 30일 까지의 일진을 구할 경우
* 다음은 아주 안좋은 방법이다.
*/
for ( $i=1; $i<31; $i++ ) {
$r = $lunar->dayfortune ('2013-07-' . $i);
$iljin[$i] = $r->day;
}
/*
* 위의 경우는 아래와 같이 $lunar->ganji_ref method를 이용하여
* 성능을 높일 수 있다.
*/
$r = $lunar->dayfortune ('2013-07-01');
$iljin[$i] = $r->day;
$gindex = $r->data->d;
for ( $i=2; $i<31; $i++ ) {
$gindex++;
if ( $gindex >= 60 )
$gindex -= 60;
$iljin[$i] = $lunar->ganji_ref[$gindex];

Tags:

access:

public

Parameters:

int	$no	ganji index number
bool	$mode	출력 모드 (false => 한글, true => 한자)

[ Top ]

string human_year(
int
$y)

연도를 human readable하게 표시

예제:

/*
* $lunar->human_year ($y)
*
* input:
* -2334
*
* output:
* BC 2333
*/

Tags:

return:	AD/BC type의 연도
access:	public

Parameters:

int

$y

연도

[ Top ]

bool is_gregorian(
int
$y, int
$m, [int
$d = 1])

해당 날자가 gregorian 범위인지 체크

Tags:

access:

public

Parameters:

int	$y	연도
int	$m	월
int	$d	일

[ Top ]

bool is_leap(
int
$y, [bool
$julian = false])

윤년 체크

예제:

/*
* $lunar->is_reap ($y)
*
* input:
* 1992 (양력)
*
* output:
* true
*/
if ( $lunar->is_leap (1992) )
echo "This is Yoon Year\n";
else

Tags:

access:

public

Parameters:

int	$y	년도
bool	$julian	Julian 여부 <p> 1582년 이전은 Julian calender로 판단하여 이 값이 false라도 율리우스력으로 간주하여 판단한다. (sinse 1.0.1) </p>

[ Top ]

stdClass moonstatus(
[int|string
$v = null])

양력일에 대한 음력월 합삭/망 데이터 구하기

예제:

/*
* $lunar->moonstatus ($date)
*
* input:
* 2013-07-16 or
* 2013-7-16 or
* 20130716 or
* 1373900400 or
* NULL
*
* output:
* stdClass Object
* (
* [new] => stdClass Object
* (
* [hyear] => AD 2013
* [year] => 2013
* [month] => 7
* [day] => 8
* [hour] => 16
* [min] => 15
* )
*
* [full] => stdClass Object
* (
* [hyear] => AD 2013
* [year] => 2013
* [month] => 7
* [day] => 23
* [hour] => 2
* [min] => 59
* )
* )
*/
print_r ($lunar->moonstatus ('2013-07-01'));
/*
* 합삭/망 정보의 경우, 한달에 음력월이 2개가 있으므로,
* 1일의 정보만 얻어서는 합삭/망 중에 1개의 정보만 나올 수 있다.
* 그러므로, 1일의 데이터를 얻은 다음, 음력 1일의 정보까지 구하면
* 한달의 합삭/망 정보를 모두 표현할 수 있다.
*/
$lun = $lunar->tolunar ('2013-07-01');
if ( $lun->largemonth ) // 평달의 경우 마지막이 29일이고 큰달은 30일이다.
$plus = 29 - $lun->day;
else
$plus = 30 - $lun->day;
$r1 = $lunar->moonstatus ('2013-07-01'); // 음력 2013-05-23
$r2 = $lunar->moonstatus ('2013-07-' . 1 + $plus); // 음력 2013-06-01
print_r ($r1);

Tags:

return:

합삭/망 object

   stdClass Object
   (
       [new] => stdClass Object      // 합삭 (New Moon) 데이터
           (
               [hyear] => AD 2013          // 합삭 AD/BC 형식 연도
               [year] => 2013              // 합삭 연도
               [month] => 7                // 합삭 월
               [day] => 8                  // 합삭 일
               [hour] => 16                // 합삭 시간
               [min] => 15                 // 합삭 분
               [julian] => 2456481.8020833 // Julian date (UTC)
           )

       [full] => stdClass Object     // 망 (Full Moon) 데이터
           (
               [hyear] => AD 2013          // 망 AD/BC 형식 연도
               [year] => 2013              // 망 연도
               [month] => 7                // 망 월
               [day] => 23                 // 망 일
               [hour] => 2                 // 망 시간
               [min] => 59                 // 망 분
               [julian] => 2456496.2493056 // Julian date (UTC)
           )
   )

access:

public

Parameters:

int|string

$v

날자형식

unixstmap (1970년 12월 15일 이후부터 가능)
Ymd or Y-m-d
null data (현재 시간)
1582년 10월 15일 이전의 날자는 율리우스력의 날자로 취급함.

[ Top ]

stdClass s28day(
[int|string
$v = null])

특정일의 28수를 구한다.

예제:

/*
* $lunar->s28day ($date)
*
* input:
* 2013-07-16 or
* 2013-7-16 or
* 20130716 or
* 1373900400 or
* NULL
*
* output:
* stdClass Object
* (
* [data] => 5
* [k] => 미
* [h] => 尾
* )
*/
print_r ($lunar->s28day ('2013-07-16'));
/*
* 역시 7/1 부터 7/30 까지의 일진을 구할 경우에는 다음과 같이
* 하면 성능이 매우 좋아진다.
*/
$s28 = null;
for ( $i=0; $i<30; $i++ ) {
if ( $s28 === null )
$s28 = $lunar->s28day ('2013-07-01');
else
$s28 = $lunar->s28day ($s28);
$s28v[$i] = $s28->k;

Tags:

return:	stdClass Object ( [data] => 5 // 28수 index [k] => 미 // 한글 28수 값 [h] => 尾 // 한자 28수 값 )
access:	public

Parameters:

int|string

$v

날자형식

unixstmap (1970년 12월 15일 이후부터 가능)
Ymd or Y-m-d
null data (현재 시간)
1582년 10월 15일 이전의 날자는 율리우스력의 날자로 취급함.
Recursion s28day return value:
loop에서 s28day method를 반복해서 호출할 경우 return value를 이용할 경우, return value의 index값을 이용하여 계산을 하지 않아 속도가 빠름.

[ Top ]

stdClass seasondate(
[int|string
$v = null])

해당 양력일에 대한 음력 월의 절기 시간 구하기

2.0.1 부터는 KASI-Lunar 2.0.0 이상이 설치 되어 있을 경우, 천문과학연구원의 2004~2026 의 절기 데이터를 이용한다.

예제:

/*
* $lunar->seasondate ($date)
*
* input:
* 2013-07-16 or
* 2013-7-16 or
* 20130716 or
* 1373900400 or
* NULL
*
* output:
* stdClass Object
* (
* [center] => stdClass Object
* (
* [name] => 소서
* [hname] => 小暑
* [hyear] => AD 2013
* [year] => 2013
* [month] => 7
* [day] => 7
* [hour] => 7
* [min] => 49
* )
*
* [ccenter] => stdClass Object
* (
* [name] => 대서
* [hname] => 大暑
* [hyear] => AD 2013
* [year] => 2013
* [month] => 7
* [day] => 23
* [hour] => 1
* [min] => 11
* )
*
* [nenter] => stdClass Object
* (
* [name] => 입추
* [hname] => 立秋
* [hyear] => AD 2013
* [year] => 2013
* [month] => 8
* [day] => 7
* [hour] => 17
* [min] => 36
* )
* )
*/

Tags:

return:

현달 초입/중기와 다음달 초입 데이터 반환

   stdClass Object
   (
       [center] => stdClass Object      // 이번달 초입 데이터
           (
               [name] => 소서              // 절기 이름
               [hname] => 小暑             // 절기 한자 이름
               [hyear] => AD 2013          // AD/BC 형식 연도
               [year] => 2013              // 초입 연도
               [month] => 7                // 초입 월
               [day] => 7                  // 초입 일
               [hour] => 7                 // 초입 시간
               [min] => 49                 // 초입 분
               [julian] => 2456480.4506944 // Julian date (UTC)
           )

       [ccenter] => stdClass Object     // 이번달 중기 데이터
           (
               [name] => 대서              // 절기 이름
               [hname] => 大暑             // 절기 한자 이름
               [hyear] => AD 2013          // AD/BC 형식 연도
               [year] => 2013              // 중기 연도
               [month] => 7                // 중기 월
               [day] => 23                 // 중기 일
               [hour] => 1                 // 중기 시간
               [min] => 11                 // 중기 분
               [julian] => 2456496.1743056 // Julian date (UTC)
           )

       [nenter] => stdClass Object      // 다음달 초입 데이터
           (
               [name] => 입추              // 절기 이름
               [hname] => 立秋             // 절기 한자 이름
               [hyear] => AD 2013          // AD/BC 형식 연도
               [year] => 2013              // 초입 연도
               [month] => 8                // 초입 월
               [day] => 7                  // 초입 일
               [hour] => 17                // 초입 시간
               [min] => 36                 // 초입 분
               [julian] => 2456511.8583333 // Julian date (UTC)
           )
   )

access:

public

Parameters:

int|string

$v

날자형식

unixstmap (1970년 12월 15일 이후부터 가능)
Ymd or Y-m-d
null data (현재 시간
1582년 10월 15일 이전의 날자는 율리우스력의 날자로 취급함.

[ Top ]

array split_date(
array|string
$date)

YYYY-MM-DD 또는 array ((string) YYYY, (string) MM, (string) DD) 입력값을 * array ((int) $y, (int) $m, (int) $d)으로 변환

Tags:

return:	array ((int) $y, (int) $m, (int) $d)
access:	public

Parameters:

array|string

$date

- YYYY-MM-DD

array ((string) YYYY, (string) MM, (stirng) DD)

[ Top ]

array toargs(
string|int
&$v, [
$lunar = false])

입력된 날자 형식을 연/월/일의 멤버를 가지는 배열로 반환한다.

입력된 변수 값은 YYYY-MM-DD 형식으로 변환 된다.

예제:

/*
* $lunar->toargs (&$v)
*
* input:
* 2013-07-13
* 2013-7-13
* 20130713
* 1373641200
* Null
*
* output:
* Array
* (
* [0] => 2013
* [1] => 7
* [2] => 13
* )
*
* and reference variavble $v is changed to '2013-07-13'
*/
$v = '2013-7-13';
$r = $lunar->toargs ($v);
echo "### $v\n";

Tags:

return:	Array ( [0] => 2013 [1] => 7 [2] => 16 )
access:	public

Parameters:

string|int

&$v

날자형식

unixstmap (1970년 12월 15일 이후부터 가능)
Ymd or Y-m-d
null data (현재 시간)

$lunar

[ Top ]

stdClass tolunar(
[int|string
$v = null])

양력 날자를 음력으로 변환

진짜 만세력은 1582/10/15(Gregorian calendar의 시작) 이전의 날자 역시 Gregorian으로 표기를 한다. 그러므로 Calendar의 오류로 보일 수도 있다. (실제로는 계산상의 오류는 없다고 봐야 한다.)

이런 부분을 보정하기 위하여, tolunar method는 1582/10/04 까지의 날자는 julian calendar로 변환을 하여 음력날자를 구한다. 이로 인 하여 1582/10/15 이전의 음력 날자는 original 진짜 만세력과 다른 값을 가지게 된다.)

이렇게 표현될 경우, 천문우주 지식정보의 값과 비슷하게 나올 수는 있으나, 평달/큰달 계산은 진짜 만세력의 것을 이용하므로 오차는 발생할 수 있다. http://astro.kasi.re.kr/Life/ConvertSolarLunarForm.aspx?MenuID=115

2.0 부터는 이러한 오차를 줄이기 위하여 oops\KASI_Lunar package가 설치되어 있을 경우, 1392-02-05 ~ 2050-12-31 기간에 대해서는 천문과학연구원의 데이터를 이용할 수 있도록 지원한다.

예제:

/*
* $lunar->tolunar ($date)
*
* input:
* 2013-07-16 or
* 2013-7-16 or
* 20130716 or
* 1373900400 or
* NULL
*
* output
* stdClass Object
* (
* [fmt] => 2013-06-09
* [dangi] => 4346
* [hyear] => AD 2013
* [year] => 2013
* [month] => 6
* [day] => 9
* [leap] =>
* [largemonth] => 1
* [week] => 화
* [hweek] => 火
* [unixstamp] => 1373900400
* [ganji] => 계사
* [hganji] => 癸巳
* [gan] => 계
* [hgan] => 癸
* [ji] => 사
* [hji] => 巳
* [ddi] => 뱀
* )
*/

Tags:

return:

음력 날자 정보 반환

   stdClass Object
   (
       [fmt] => 2013-06-09          // YYYY-MM-DD 형식의 음력 날자
       [dangi] => 4346              // 단기
       [hyear] => AD 2013           // AD/BC 형식의 연도
       [year] => 2013               // 연도
       [month] => 6                 // 월
       [day] => 9                   // 일
       [leap] =>                    // 음력 윤달 여부
       [largemonth] => 1            // 평달/큰달 여부
       [week] => 화                 // 요일
       [hweek] => 火                // 한자 요일
       [unixstamp] => 1373900400    // unixstamp (양력 날자)
       [ganji] => 계사              // 세차(년)
       [hganji] => 癸巳             // 한자 세차
       [gan] => 계                  // 세차 10간
       [hgan] => 癸                 // 세차 한자 10간
       [ji] => 사                   // 세차 12지
       [hji] => 巳                  // 세차 한자 12지
       [ddi] => 뱀                  // 띠
   )

access:

public

Parameters:

int|string

$v

날자형식

unixstmap (1970년 12월 15일 이후부터 가능)
Ymd or Y-m-d
null data (현재 시간)
1582년 10월 15일 이전의 날자는 율리우스력의 날자로 취급함.

[ Top ]

stdClass tosolar(
[int|string
$v = null], [bool
$leap = false])

음력 날자를 양력으로 변환.

구하는 음력월이 윤달인지 여부를 알 수 없을 경우, tosolar method 를 실행하여 얻은 양력 날자를 다시 tolunar로 변환하여 비교하여 동일하지 않다면, 윤달 파라미터 값을 주고 다시 구해야 한다!

진짜 만세력은 Gregorian으로 표기를 하기 때문에, 양력 1582-10-15 이전의 경우에는 return object의 julian member 값으로 비교를 해야 한다.

예제:

/*
* $lunar->tosolar ($date)
*
* input:
* 2013-06-09 or
* 2013-6-09 or
* 20130609 or
* NULL
*
* output
* stdClass Object
* (
* [fmt] => 2013-07-16
* [dangi] => 4346
* [hyear] => AD 2013
* [year] => 2013
* [month] => 7
* [day] => 16
* [week] => 화
* [hweek] => 火
* [unixstamp] => 1373900400
* [ganji] => 계사
* [hganji] => 癸巳
* [gan] => 계
* [hgan] => 癸
* [ji] => 사
* [hji] => 巳
* [ddi] => 뱀
* )
*/
print_r ($lunar->tosolar ('2013-06-09'));
/*
* 구하는 음력월의 윤달 여부를 모른다면 다음과 같이 확인
* 과정이 필요하다.
*/
$lun = '2013-06-09';
$solv = $lunar->tosolar ($lun);
$lunv = $lunar->tolunar ($sol->fmt);
if ( $lun != $lunv->fmt )

Tags:

return:

양력 날자 정보 object 반환

   stdClass Object
   (
       [jd] => 2456527             // Julian Date Count
       [fmt] => 2013-07-16         // YYYY-MM-DD 형식의 양력 날자 (15821015 이전은 율리우스력)
       [gregory] => 2013-07-16     // Gregory Calendar
       [julian] => 2013-08-09      // Julian Calendar
       [dangi] => 4346             // 단기 (양력)
       [hyear] => AD 2013          // AD/BC 형식 년도
       [year] => 2013              // 양력 연도
       [month] => 7                // 월
       [day] => 16                 // 일
       [week] => 화                // 요일
       [hweek] => 火               // 한자 요일
       [unixstamp] => 1373900400   // unixstamp (양력)
       [ganji] => 계사             // 세차
       [hganji] => 癸巳            // 세차 한자
       [gan] => 계                 // 세차 10간
       [hgan] => 癸                // 세차 한자 10간
       [ji] => 사                  // 세차 12지
       [hji] => 巳                 // 세차 한자 12지
       [ddi] => 뱀                 // 띠
   )

access:

public

Parameters:

int|string

$v

날자형식

unixstmap (1970년 12월 15일 이후부터 가능)
Ymd or Y-m-d
null data (현재 시간)

bool

$leap

윤달여부

[ Top ]

string version(
)

oops\Lunar package 의 버전을 반환.

Tags:

access:

public

[ Top ]

Class: Lunar

Class Overview

Author(s):

Copyright:

Methods

Inherited Variables

Class: Lunar_API

Inherited Methods

Class: Lunar_API

Class Details

Tags:

Class Methods

method cal2jd [line 575]

Tags:

Parameters:

method dayfortune [line 967]

Tags:

Parameters:

method ganji_ref [line 1363]

Tags:

Parameters:

method human_year [line 213]

Tags:

Parameters:

method is_gregorian [line 316]

Tags:

Parameters:

method is_leap [line 291]

Tags:

Parameters:

method moonstatus [line 1283]

Tags:

Parameters:

method s28day [line 1015]

Tags:

Parameters:

method seasondate [line 1102]

Tags:

Parameters:

method split_date [line 235]

Tags:

Parameters:

method toargs [line 162]

Tags:

Parameters:

method tolunar [line 726]

Tags:

Parameters:

method tosolar [line 848]

Tags:

Parameters:

method version [line 132]

Tags: