<?php
##
## this file name is 'class.solar.php'
##
## solar object -- get sun position or 24 solar terms
##
## [author]
##  - Chilbong Kim, <san2(at)linuxchannel.net>
##  - http://linuxchannel.net/
##
## [changes]
##  - 2014.09.26 : support PHP/5.4 (calltime reference)
##  - 2011.11.06 : some
##  - 2011.09.30 : tune of sunrise_sunset()
##  - 2011.09.19 : tune of time2stime()
##  - 2010.10.15 : bug fixed of _constellation()
##  - 2010.07.29 : add sambok()
##  - 2009.06.08 : extended, date() to calendar::_date() of class.calendar.php
##  - 2005.04.17 : add sunrise_sunset()
##  - 2005.02.06 : rebuid deg2valid(), add zodiac()
##  - 2005.01.24 : rebuild time2stime(), atan2()
##  - 2005.01.18 : bug fixed:$RA
##  - 2003.09.08 : bug fixed
##  - 2003.09.06 : new build
##
## [근사식에 대한 신뢰]
##  - 표준편차 : 1289.7736 = 21.5 minutes (standard deviation)
##  - 평균오차 : 817.57409541246 = 13.6 minutes
##  - 최대오차 : +4102.7340(68.4 minutes), -4347.2395(72.5 minutes)
##
## [근사식으로 계산한 24절기 실제 오차] 1902 ~ 2037 년
##  - 표준편차 : 1122.1921 = 18.7 분
##  - 평균오차 : +686.08382175161 = +11.4 분
##  - 최대오차 : +4297.252300024 = +71.6 분, -4278.048699975 = -71.3 분
##  - 최소오차 : +0.16999998688698 = 0 초
##
## [근사식 + 년도 보정으로 계산한 24절기 실제 오차] 1902 ~ 2037 년
##  - 표준편차 : 450.8534 = 7.5 분
##  - 평균오차 : +305.38638890903 = 5.0 분
##  - 최대오차 : +3028.2343000174 = +50.5 분, -1982.9391000271 = -33.1 분
##  - 최소오차 : +0.0085000991821289 = 0 초
##
## [valid date]
##  - 1902.01.01 00:00:00 <= utime <= 2037.12.31 23:59:59
##
## [support date]
##  - unix timestamp base: 1902-01-01 00:00:00 <= date <= 2037-12-31 23:59:59 (guess)
##  - JD(Julian Day) base: BC 4713-01-01 12:00 GMT <= Gregorian date <= AD 9999 (guess)
##
## [download & online source view]
##  - http://ftp.linuxchannel.net/devel/php_solar/
##  - http://ftp.linuxchannel.net/devel/php_calendar/
##
## [demo]
##  - http://linuxchannel.net/gaggle/solar.php
##
## [docs]
##  - http://linuxchannel.net/docs/solar-24terms.txt
##
## [references]
##  - http://cgi.chollian.net/~kohyc/
##  - http://user.chollian.net/~kimdbin/
##  - http://user.chollian.net/~kimdbin/re/calendar.html
##  - http://user.chollian.net/~kimdbin/re/suncoord.html
##  - http://user.chollian.net/~kimdbin/qna/al138.html
##  - http://ruby.kisti.re.kr/~manse/contents-3.html
##  - http://ruby.kisti.re.kr/~anastro/sub_index.htm
##  - http://www-ph.postech.ac.kr/~obs/lecture/lec1/elementary/nakedeyb.htm
##  - http://ruby.kisti.re.kr/~anastro/calendar/etime/ETime.html
##  - http://www.sundu.co.kr/5-information/5-3/5f3-3-5-04earth-1.htm
##  - http://www-ph.postech.ac.kr/~obs/lecture/lec1/elementary/nakedeya.htm
##  - http://upgradename.com/calm.php
##  - http://aa.usno.navy.mil/faq/docs/SunApprox.html
##  - http://aa.usno.navy.mil/data/docs/JulianDate.html
##  - http://williams.best.vwh.net/sunrise_sunset_example.htm    // sunrise sunset
##  - http://www.stargazing.net/kepler/sunrise.html    // sunrise sunset
##  - http://eclipse.gsfc.nasa.gov/SEhelp/deltatpoly2004.html    // delta T
##  - http://eclipse.gsfc.nasa.gov/SEhelp/deltat2004.html    // delta T
##  - http://star-www.st-and.ac.uk/~fv/webnotes/index.html  // Positional Astronomy
##
## [usage]
##
## [example]
##  require_once 'class.calendar.php';
##  require_once 'class.solar.php';
##  $sun = array();
##  $terms = solar::terms(date('Y'),1,12,&$sun);
##  print_r($terms);
##  print_r($sun);
##  print_r(solar::sun(time()));
##

class solar
{
  
## check solar terms in today or tomorrow
  ##
  
function &solar($utime=0$GMT=FALSE)
  {
    return 
solar::today($utime,$GMT);
  }

  function &
today($utime=0$GMT=FALSE)
  {
    if(
$utime == ''$utime time();
    if(
$GMT$utime -= 32400;

    list(
$year,$moon,$moonday) = explode(' ',date('Y n nd',$utime));
    
$tomorrow date('nd',$utime+86400);

    
$terms solar::terms($year,$moon,0);
    
$samboks solar::sambok($year);
    
$sambok1 $samboks[$moonday];
    
$sambok2 $samboks[$tomorrow];

    if(
$term $terms[$moonday])
    {
        if(
$sambok1$term .= '/'.$sambok1;
        
$str '오늘은 <B>'.$term.'</B>입니다.';
    }
    else if(
$term $terms[$tomorrow])
    {
        if(
$sambok2$term .= '/'.$sambok2;
        
$str '내일은 <B>'.$term.'</B>입니다.';
    }
    else if(
$sambok1$str '오늘은 <B>'.$sambok1.'</B>입니다.';
    else if(
$sambok2$str '내일은 <B>'.$sambok2.'</B>입니다.';

    return 
$str;
  }

  
## get sun position at unix timestamp
  ##
  ## [limit]
  ##  - mktime(0,0,0,1,1,1902) < $utime < mktime(23,59,59,12,31,2037)
  ##
  ## [study]
  ##  - w = 23.436
  ##  - tan RA = (sin L * cos w - tan e * sin w ) / cos L
  ##  - sin d = (sin e * cos w) + (cos e * sin w * sin L)
  ##
  ## [example]
  ##  - print_r(solar::sun(mktime(  10,0,0,3,21,2003)  ));
  ##  - print_r(solar::sun(mktime(10-9,0,0,3,21,2003),1)); // same as
  ##
  
function &sun($utime$GMT=FALSE)
  {
    
$L $D $JD 0$J '';
    
$deg2rad = array();

    
/***
    if($utime<-2145947400 || $utime>2145884399)
    {
        echo "\nerror: invalid input $utime, 1902.01.01 00:00:00 <= utime <= 2037.12.31 23:59:59\n";
        return -1;
    }
    ***/

    
list($L,$atime) = solar::sunl($utime,$GMT,$D,$JD,$J,$deg2rad);

    
## Sun's ecliptic, in degress
    ##
    
$e sprintf('%.10f',23.439 - (0.00000036*$D)); // degress

    
$cosg cos($deg2rad['g']); // degress
    
$cos2g cos($deg2rad['2g']); // degress

    ## R == AU (sun ~ earth)
    ## The distance of the Sun from the Earth, R, in astronomical units (AU)
    ##
    
$R sprintf('%.10f',1.00014 - (0.01671*$cosg) - (0.00014*$cos2g));

    
## convert
    ##
    
$deg2rad['e'] = deg2rad($e); // radian
    
$deg2rad['L'] = deg2rad($L); // radian

    
$cose cos($deg2rad['e']); // degress
    
$sinL sin($deg2rad['L']); // degress
    
$cosL cos($deg2rad['L']); // degress
    
$sine sin($deg2rad['e']); // degress

    ## the Sun's right ascension(RA)
     ##
    //$tanRA = sprintf('%.10f',$cose * $sinL / $cosL); // degress
    //$RA = sprintf('%.10f',rad2deg(atan($tanRA)));
    //$RA = $cosL<0 ? $RA+180 : ($sinL<0 ? $RA+360 : $RA); // patch 2005.01.18
    
$RA sprintf('%.10f',rad2deg(atan2($cose*$sinL,$cosL)));
    
$RA solar::deg2valid($RA);

    
## the Sun's declination(d)
    ##
    
$sind sprintf('%.10f',$sine $sinL); // degress
    
$d sprintf('%.10f',rad2deg(asin($sind))); // Sun's declination, degress

    
$solartime solar::deg2solartime($L);
    
$daytime solar::deg2daytime($RA);

    
//if(!($L1=round($L) % 15))
    //{
    //    $idx = $L1 / 15;
    //    list($hterms) = solar::gterms();
    //}

    ## all base degress or decimal
    ##
     
return array
    (
    
'JD' => $JD,    /*** Julian Day ***/
    
'J'  => 'J'.$J// Jxxxx.xxxx format
    
'L'  => $L,    /*** Sun's geocentric apparent ecliptic longitude ***/
    
'e'  => $e,    /*** Sun's ecliptic ***/
    
'R'  => $R,    /*** Sun from the Earth, astronomical units (AU) ***/
    
'RA' => $RA,    /*** Sun's right ascension ***/
    
'd'  => $d,    /*** Sun's declination ***/
    
'stime'  => $solartime,        /*** solar time ***/
    
'dtime'  => $daytime,        /*** day time ***/
    
'atime'  => $atime,        /*** append time for integer degress **/
    
'utime'  => $utime,        /*** unix timestamp ***/
    
'date'   => calendar::_date('D, d M Y H:i:s T',$utime),    /*** KST date ***/
    
'gmdate' => calendar::_date('D, d M Y H:i:s ',$utime-date('Z')).'GMT',    /*** GMT date ***/
    
'_L'  => solar::deg2angle($L),
    
'_e'  => solar::deg2angle($e,1),
    
'_RA' => solar::deg2angle($RA),
    
'_d'  => solar::deg2angle($d,1),
    
'_stime' => solar::time2stime($solartime,FALSE,TRUE),
    
'_dtime' => solar::time2stime($daytime),
    
'_atime' => solar::time2stime($atime,TRUE),
    );
  }

  function &
sunl($utime$GMT=FALSE, &$D=0, &$JD=0, &$J='', &$deg2rad=array())
  {
    if(
$GMT$utime += 32400// force GMT to static KST, see 946727936

    ## D -- get the number of days from base JD
    ## D = JD(Julian Day) - 2451545.0, base JD(J2000.0)
    ##
    ## base position (J2000.0), 2000-01-01 12:00:00, UT
    ## as   mktime(12,0,0-64,1,1,2000) == 946695536 unix timestamp at KST
    ## as gmmktime(12,0,0-64,1,1,2000) == 946727936 unix timestamp at GMT
    ##
    
$D $utime 946727936// number of time
    
$D sprintf('%.10f',$D/86400); // float, number of days
    
$JD sprintf('%.10f',$D+2451545.0); // float, Julian Day
    
$J sprintf('%.4f',2000.0 + ($JD-2451545.0)/365.25); // Jxxxx.xxxx format

    
$g sprintf('%.10f',357.529 + (0.98560028 $D));
    
$q sprintf('%.10f',280.459 + (0.98564736 $D));

    
## fixed
    ##
    
$g solar::deg2valid($g); // to valid degress
    
$q solar::deg2valid($q); // to valid degress

    ## convert
    ##
    
$deg2rad = array();
    
$deg2rad['g'] = deg2rad($g); // radian
    
$deg2rad['2g'] = deg2rad($g*2); // radian

    
$sing sin($deg2rad['g']); // degress
    
$sin2g sin($deg2rad['2g']); // degress

    ## L is an approximation to the Sun's geocentric apparent ecliptic longitude
    ##
    
$L sprintf('%.10f',$q + (1.915 $sing) + (0.020*$sin2g)); 
    
$L solar::deg2valid($L); // degress
    
$atime solar::deg2solartime(round($L)-$L); // float

    
return array($L,$atime); // array, float degress, float seconds
  
}

  
/***
  function &_atime($utime)
  {
    static $unit = 87658.1256;

    list($L) = solar::sunl($utime);
    $td = round($L) - $L;

    while(abs($td) > 0.0000114) // 1/$unit
    {
        $utime += $unit * $td;
        list($L) = solar::sunl($utime);
        $td = round($L) - $L;
    }

    return $utime;
  }
  ***/

  /***
  function &sinl($f, $v)
  {
    return sin(deg2rad($f+$v));
  }

  ## http://linux-sarang.net/board/?p=read&table=qa&no=198189
  ## -2 < sin x < + 2
  ## sin (77 + L) ==> (77 + L - 1.915 sin (77 + L))
  ##
  function &l2d($L)
  {
    $L = (int)$L; // 0 <= $L <= 345
    //$sinl  = sin(deg2rad(77+$L));
    $sinl = solar::sinl($L,77);
    //$sinl = solar::sinl($L-(1.915)*$sinl,77);

    //$sin2l = sin(deg2rad(154+($L*2)));
    $sin2l = solar::sinl($L*2,154);
    $sin2l = solar::sinl($L-(0.020*$L*2*$sin2l),154);
    $sin2l = solar::sinl($L-(0.020*$L*2*$sin2l),154);

    $D = sprintf('%.10f',($L - 280.459 - (1.915 * $sinl) - (0.020 * $sin2l)) / 0.98564736);

    return $D; // float
  }

  function &l2jd($L)
  {
    $D  = solar::l2d($L);
    $JD = sprintf('%.10f',$D+2451545.0);
    //$JD = $JD + ($i * 360 / 0.98564736) 

    return $JD; // float
  }

  function &l2utime($year, $L, $GMT=FLASE)
  {
    $i = (int)$year - 2000 + 1;
    $D = solar::l2d($L);

    $utime = ($D * 86400) + 946727936 + (31556925.216 * $i);
    $utime = round($utime);

    return $utime - ($GMT ? 32400 : 0); // integer
  }
  ***/

  ## 1 hour == 15 degress
  ## 1 degress == 4 minute == 240 seconds
  ##
  
function &deg2daytime($deg)
  {
    return 
sprintf('%.4f',$deg*240); // seconds
  
}

  
## 1 solar year == 365.242190 days == 31556925.216 seconds
  ## 1 degress == 31556925.216 seconds / 360 degress == 87658.1256 seconds
  ##
  
function &deg2solartime($deg)
  {
    return 
sprintf('%.4f',$deg*87658.1256); // seconds
  
}

  function &
deg2angle($deg$singed=FALSE)
  {
    list(
$d,$m,$s) = calendar::deg2dms($deg,$signed);

    return 
$d.chr(161).chr(198).$m.chr(161).chr(199).$s.chr(161).chr(200);
  }

  function &
deg2valid($deg)
  {
    
//if($deg <= 360 && $deg >=0) return $deg;
    
$deg = ($deg>=0) ? fmod($deg,360) : fmod($deg,360)+360.0;

    return (float)
$deg// float degress
  
}

  function &
moon2valid($moon)
  {
    
//$moon = max($moon,1);
    //$moon = min($moon,12);

    
if($moon 1$moon 1;
    else if(
$moon 12$moon 12;

    return (int)
$moon;
  }

  function &
time2stime($time$singed=FALSE$printday=FALSE)
  {
    if(
$singed$singed '+';
    if(
$time<0) { $singed '-'$time abs($time); }
    
$printday $printday 'z ' ''// why? 0 is false

    
return $singed.date($printday.'H i s',$time-date('Z')); // $time is small, _date() to date()
  
}

  function &
gterms()
  {
    static 
$hterms = array
    (
    
'소한','대한','입춘','우수','경칩','춘분','청명','곡우',
    
'입하','소만','망종','하지','소서','대서','입추','처서',
    
'백로','추분','한로','상강','입동','소설','대설','동지'
    
);

    static 
$tterms = array
    (
    -
6418939, -5146737, -3871136, -2589569, -1299777,        0,
     
1310827,  2633103,  3966413,  5309605,  6660762,  8017383,
     
93765111073501812089855134381991477779216107008,
    
174248411873136820027093213134522259240323866369
    
);

    
## mktime(7+9,36,19-64,3,20,2000), 2000-03-20 16:35:15(KST)
    ##
    
if(!defined('__SOLAR_START__'))
    {
    
define('__SOLAR_START__',953537715); // start base unix timestamp
    
define('__SOLAR_TYEAR__',31556940); // tropicalyear to seconds
    
define('__SOLAR_BYEAR__',2000); // start base year
    
}

    return array(
$hterms,$tterms);
  }

  function &
tterms($year)
  {
    static 
$addstime = array
    (
    
1902=> 15451903=> 17341904=> 17401906=>  4751907=>  432,
    
1908=>  4801909=>  4621915=> -3701916=> -3321918=> -335,
    
1919=> -2631925=>  3401927=>  3441928=> 21331929=> 2112,
    
1930=> 21001931=> 18581936=> -4001937=> -4001938=> -342,
    
1939=> -3001944=>  3651945=>  3801946=>  4001947=>  200,
    
1948=>  2441953=> -2661954=> 26001955=> 31681956=> 3218,
    
1957=> 33661958=> 33001959=> 34831960=> 23861961=> 3015,
    
1962=> 20901963=> 20901964=> 22641965=> 23701966=> 2185,
    
1967=> 21441968=> 15261971=> -3931972=> -4301973=> -445,
    
1974=> -5431975=> -3931980=>  3001981=>  4901982=>  400,
    
1983=>  4451984=>  3931987=>-15301988=>-16001990=> -362,
    
1991=> -3661992=> -4001993=> -4491994=> -3211995=> -344,
    
1999=>  3562000=>  4802001=>  4832002=>  5042003=>  294,
    
2007=> -2062008=> -3142009=> -4662010=> -4162011=> -457,
    
2012=> -3132018=>  3472020=>  2572021=>  3512022=>  159,
    
2023=>  1772026=> -1342027=> -3402028=> -3822029=> -320,
    
2030=> -4702031=> -3702032=> -3732036=>  3492037=>  523,
    );

    static 
$addttime = array
    (
    
1919=> array(14=>-160), 1939=> array(10=> -508),
    
1953=> array( 0=> 220), 1954=> array( 1=>-2973),
    
1982=> array(18=> 241), 1988=> array(13=>-2455),
    
2013=> array( 6=> 356), 2031=> array(20=>  411),
    
2023=> array( 0=>  39911=>-571),
    );

    return array(
$addstime[$year],$addttime[$year]);
  }

  
## get the 24 solar terms, 1902 ~ 2037
  ##
  ## [usage]
  ##  - array solar::terms(int year [, int smoon [, int length [, array &sun]]] )
  ##
  
function &terms($year=0$smoon=1$length=12$sun=array())
  {
    
$year  = (int)$year;
    
$sun = array();
    
$smoon = (int)$smoon;
    
$length = (int)$length;
    
$times = array();

    if(!
$year$year date('Y');

    
/***
    if($year<1902 || $year>2037)
    {
        echo "\nerror: invalid input $year, 1902 <= year <= 2037\n";
        return -1;
    }
    ***/

    
list($hterms,$tterms) = solar::gterms();
    list(
$addstime,$addttime) = solar::tterms($year);

    
## mktime(7+9,36,19-64,3,20,2000), 2000-03-20 16:35:15(KST)
    ##
    
$start __SOLAR_START__// start base unix timestamp
    
$tyear __SOLAR_TYEAR__// tropicalyear to seconds
    
$byear __SOLAR_BYEAR__// start base year

    
$start += ($year $byear) * $tyear;

    if(
$length < -12$length = -12;
    else if(
$length 12$length 12;

    
$smoon solar::moon2valid($smoon);
    
$emoon solar::moon2valid($smoon+$length);

    
$sidx =  (min($smoon,$emoon) - 1) * 2;
    
$eidx = ((max($smoon,$emoon) - 1) * 2) + 1;

    for(
$i=$sidx$i<=$eidx$i++)
    {
        
$time $start $tterms[$i];
        list(,
$atime) = solar::sunl($time,FALSE);
        
$time += $atime $addstime $addttime[$i]; // re-fixed
        
$terms[calendar::_date('nd',$time)] = &$hterms[$i];
        
$times[] = $time// fixed utime
    
}

    
## for detail information
    ##
    
if(func_num_args() > 3)
    {
        
$i $sidx;
        foreach(
$times AS $time)
        {
            
$sun[$i] = solar::sun($time,FALSE);
            
$sun[$i]['_avgdate'] = calendar::_date('D, d M Y H:i:s ',$start+$tterms[$i]-date('Z')).'GMT';
            
$sun[$i]['_name'] = &$hterms[$i];
            
$i++;
        }
    }

    unset(
$times);

    return 
$terms// array
  
}

  
## public, get a Constellation of zodiac
  ##
  
function &zodiac($y$m$d)
  {
    static 
$ffd = array // patch day
    
(
    
19030622 => -2419221222 =>   419540420 => -6119550723 => -48,
    
19551222 => -5719560320 => -4819580823 => -5219600219 => -55,
    
19610221 => -5919620823 => -3719651023 => -4219870525 =>  64,
    
19880722 =>  6120230621 =>   420300218 =>   7
    
);

    
$horoscope = array
    (
    array(
chr(187).chr(234).chr(190).chr(231),'Aries'),
    array(
chr(200).chr(178).chr(188).chr(210),'Taurus'),
    array(
chr(189).chr(214).chr(181).chr(213).chr(192).chr(204),'Gemini'),
    array(
chr(176).chr(212),'Cancer'),
    array(
chr(187).chr(231).chr(192).chr(218),'Leo'),
    array(
chr(195).chr(179).chr(179).chr(224),'Virgo'),
    array(
chr(195).chr(181).chr(196).chr(170),'Libra'),
    array(
chr(192).chr(252).chr(176).chr(165),'Scorpius'),
    array(
chr(177).chr(195).chr(188).chr(246),'Sagittarius'),
    array(
chr(191).chr(176).chr(188).chr(210),'Capricon'),
    array(
chr(185).chr(176).chr(186).chr(180),'Aquarius'),
    array(
chr(185).chr(176).chr(176).chr(237).chr(177).chr(226),'Pisces')
    );

    
//list(,$nd) = _solar::_terms($y,$m,0);
    //$idx = ($m.$d<$nd) ? $m-2 : $m-1;
    //if($idx < 0) $idx += 12;

    
$fk sprintf('%d%02d%d',$y,$m,$d);
    list(
$L) = solar::sunl(calendar::_mktime(23,59+(int)$ffd[$fk],59,$m,$d,$y));

    return 
$horoscope[floor($L/30)];
  }

  
## public, get sunrise, sunset on Korea
  ##
  ## same as PHP5 `date_sunrise()', `date_sunset()'
  ## http://williams.best.vwh.net/sunrise_sunset_example.htm
  ## or
  ## Positional Astronomy: Sunrise, sunset and twilight
  ## http://star-www.st-and.ac.uk/~fv/webnotes/chapt12.htm 
  ## or
  ## http://kr.php.net/manual/en/function.date-sunrise.php
  ##
  ## [zenith]
  ##  offical      = 90 degrees 50'
  ##  civil        = 96 degrees
  ##  nautical     = 102 degrees
  ##  astronomical = 108 degrees
  ##
  
function sunrise_sunset($_y$_m$_d$_location=0$_zenith=0)
  {
    static 
$_locations = array
    (
    array(
126.95,37.55/* 서울 */, array(131.87,37.24/* 독도 */,
    array(
129.37,36.04/* 포항 */, array(126.35,36.52/* 안면 */,
    );

    static 
$_zeniths = array(90.833396.0102.0108.0);

    
//$_timezone = 9.0; // KST +9H
    
$_timezone date('Z') / 3600;

    
## check arguments
    ##
    
if(!preg_match('/^[0-3]$/',$_location)) $_location 0;
    if(!
preg_match('/^[0-3]$/',$_zenith)) $_zenith 0;

    
## inital configurations
    ##
    
$location  $_locations[$_location];
    
$longitude $location[0];
    
$latitude  deg2rad($location[1]);
    
$zenith    deg2rad($_zeniths[$_zenith]);

    
## 1. first calculate the day of the year
    ##
    
$N floor(275*$_m/9) - (floor(($_m+9)/12) * (1+floor(($_y-4*floor($_y/4)+2)/3))) + $_d 30;

    
## 2. convert the longitude to hour value and calculate an approximate time
    ##
    
$lhour $longitude 15;
    
$t['r'] = sprintf('%.8f',$N+((6-$lhour)/24.0)); // sunrise
    
$t['s'] = sprintf('%.8f',$N+((18-$lhour)/24.0)); // sunset

    ## 3. calculate the Sun's mean anomaly
    ##
    
$M['r'] = (0.9856*$t['r']) - 3.289;
    
$M['s'] = (0.9856*$t['s']) - 3.289;

    
## 4. calculate the Sun's true longitude
    ## to be adjusted into the range [0,360) by adding/subtracting 360
    ##
    
$L['r'] = $M['r'] + (1.916*sin(deg2rad($M['r']))) + (0.020*sin(deg2rad(2*$M['r']))) + 282.634;
    
$L['s'] = $M['s'] + (1.916*sin(deg2rad($M['s']))) + (0.020*sin(deg2rad(2*$M['s']))) + 282.634;
    
$L['r'] = ($L['r']>=0) ? fmod($L['r'],360) : fmod($L['r'],360)+360.0;
    
$L['s'] = ($L['s']>=0) ? fmod($L['s'],360) : fmod($L['s'],360)+360.0;
    
$l['r'] = deg2rad($L['r']);
    
$l['s'] = deg2rad($L['s']);

    
## 5a. calculate the Sun's right ascension
    ## to be adjusted into the range [0,360) by adding/subtracting 360
    ##
    
$RA['r'] = rad2deg(atan(0.91764*tan($l['r'])));
    
$RA['s'] = rad2deg(atan(0.91764*tan($l['s'])));
    
$RA['r'] = ($RA['r']>=0) ? fmod($RA['r'],360) : fmod($RA['r'],360)+360.0;
    
$RA['s'] = ($RA['s']>=0) ? fmod($RA['s'],360) : fmod($RA['s'],360)+360.0;

    
## 5b. right ascension value needs to be in the same quadrant as L
    ##
    
$RA['r'] += (floor($L['r']/90.0)*90.0) - (floor($RA['r']/90.0)*90.0);
    
$RA['s'] += (floor($L['s']/90.0)*90.0) - (floor($RA['s']/90.0)*90.0);

    
## 5c. right ascension value needs to be converted into hours
    ##
    
$RA['r'] /= 15;
    
$RA['s'] /= 15;

    
## 6. calculate the Sun's declination
    ##
    
$sindec['r'] = 0.39782 sin($l['r']);
    
$sindec['s'] = 0.39782 sin($l['s']);
    
$cosdec['r'] = cos(asin($sindec['r']));
    
$cosdec['s'] = cos(asin($sindec['s']));

    
## 7a. calculate the Sun's local hour angle
    ## (cosH> 1) the sun never rises on this location (on the specified date)
    ## (cosH<-1) the sun never sets on this location (on the specified date)
    ##
    
$cosH['r'] = (cos($zenith) - ($sindec['r']*sin($latitude))) / ($cosdec['r']*cos($latitude));
    
$cosH['s'] = (cos($zenith) - ($sindec['s']*sin($latitude))) / ($cosdec['s']*cos($latitude));

    
## 7b. finish calculating H and convert into hours
    ##
    
$H['r'] = 360.0 rad2deg(acos($cosH['r']));
    
$H['s'] = rad2deg(acos($cosH['s']));
    
$H['r'] /= 15;
    
$H['s'] /= 15;

    
## 8. calculate local mean time of rising/setting
    ##
    
$T['r'] = $H['r'] + $RA['r'] - (0.06571*$t['r']) - 6.622;
    
$T['s'] = $H['s'] + $RA['s'] - (0.06571*$t['s']) - 6.622;

    
## 9. adjust back to UTC
    ## to be adjusted into the range [0,24) by adding/subtracting 24
    ##
    
$UT['r'] = $T['r'] - $lhour;
    
$UT['s'] = $T['s'] - $lhour;
    
$UT['r'] = ($UT['r']>=0) ? fmod($UT['r'],24.0) : fmod($UT['r'],24.0) + 24.0;
    
$UT['s'] = ($UT['s']>=0) ? fmod($UT['s'],24.0) : fmod($UT['s'],24.0) + 24.0;

    
## 10. convert UT value to local time zone of latitude/longitude
    ##
    
$localT['r'] = fmod($UT['r']+$_timezone,24.0);
    
$localT['s'] = fmod($UT['s']+$_timezone,24.0);

    
## last convert localT to human time
    ##
    
$sunrise['H'] = floor($localT['r']);
    
$sunrise['m'] = (int)(($localT['r']-$sunrise['H'])*60);
    
$sunset['H'] = floor($localT['s']);
    
$sunset['m'] = (int)(($localT['s']-$sunset['H'])*60);

    
// good idea, but slow
    //return array(date('H:i',$UT['r']*3600),date('H:i',$UT['s']*3600)); // date(UT) to local timezone

    
return array
    (
    
sprintf('%02d',$sunrise['H']).':'.sprintf('%02d',$sunrise['m']), // sunrise HH:MM
    
sprintf('%02d',$sunset['H']).':'.sprintf('%02d',$sunset['m']), // sunset HH:MM
    
);
  }

  
## add san2@2010.07.29
  ##
  
function _get_basejd_of_sambok($_y$_m$_d)
  {
    static 
$basejd 2451546// 2451546.6257407409139 2000.01.03 12:00:00, base of kanji, idx 0

    
list($bjd) = calendar::_getjd($_y,$_m,$_d,12,0,0);
    
$addterm = (floor($bjd)-$basejd) % 10;

    if(
$addterm 0$addterm 10 $addterm;
    else if(
$addterm 0$addterm abs($addterm);

    return 
$bjd $addterm// JD
  
}

  
## add san2@2010.07.29
  ##
  
function sambok($_y NULL)
  {
    if(!
func_num_args()) $_y date('Y');

    
$terms solar::terms($_y,6,2); // solar 24's terms of Jun ~ Oct
    
$terms array_keys($terms);
    
$h[0] = substr($terms[1],0,1);
    
$h[1] = substr($terms[1],-2);
    
$l[0] = substr($terms[4],0,1);
    
$l[1] = substr($terms[4],-2);

    
## JD
    ##
    
$chobok solar::_get_basejd_of_sambok($_y,$h[0],$h[1]) + 20;
    
$malbok solar::_get_basejd_of_sambok($_y,$l[0],$l[1]);
    
$jungbok $chobok 10;

    
## JD to date
    ##
    
$c calendar::_todate($chobok);
    
$j calendar::_todate($jungbok);
    
$m calendar::_todate($malbok);

    
$c $c[1].sprintf('%02d',$c[2]);
    
$j $j[1].sprintf('%02d',$j[2]);
    
$m $m[1].sprintf('%02d',$m[2]);

    
## add korean name
    ##
    
$kname['c'] = chr(195).chr(202).chr(186).chr(185);
    
$kname['j'] = chr(193).chr(223).chr(186).chr(185);
    
$kname['m'] = chr(184).chr(187).chr(186).chr(185);

    return array(
$c => $kname['c'],$j => $kname['j'],$m => $kname['m']);
  }
// end of class

/*** example ***
require_once 'class.calendar.php';
require_once 'class.solar.php';
$sun = array();
$terms = solar::terms(date('Y'),1,12,&$sun);
print_r($terms);
print_r($sun);
print_r(solar::sun(time()));
echo solar::today()."\n";
echo solar::solar(mktime(0,0,0,3,20))."\n";
echo solar::solar(mktime(0,0,0,3,21))."\n";
echo solar::solar(mktime(0,0,0,3,22))."\n";
echo "\n\n";
print_r(solar::terms(2023));
***/
?>