TOSOLAR 함수

【 함수 요약 】

음력일자를 날짜형식의 양력으로 변환

(변환가능일자 : 인터넷사용시 - 기원전 음력59년  ~ 2100년, 인터넷 미사용시 1900~2100년) 

 

이 함수는 EGTools 추가기능에서 지원하는 함수입니다.

양력을 음력으로 변환하는 함수는 TOLUNAR입니다.

【 적용 버전 】

Windows용 : 모든버전

 

【 함수 구문 】

= TOSOLAR (  Date , [ LeapMonth ] , [ Delimiter ] , [ API ] )

 

【 함수 인수 】

인수명	옵션	기본값	설    명
Date	필수	없음	양력으로 전환할 날짜형식의 문자열로 아래 4가지 형태를 지원함 YYYY-MM-DD, YYYY/MM/DD, YYYY.MM.DD, YYYYMMDD (v4.3.3 예정) YYYY-MM-DD(윤), YYYY-윤M-DD 형태 추가
LeapMonth	선택	False	생략하거나 False로 지정하면 평달, True로 지정하면 윤달의 Date (v4,3,3 예정) Date에 "윤"이 있을 경우 자동으로 True로 반영
Delimiter	선택	"-"	출력할 양력의 년월일을 구분하는 구분자
API	선택	False	1900~2050년 구간에 대해서 강제로 API를 사용하게 함 False나 생략하면 내장 기능으로 작동 True를 지정하면 천문연구원의 API를 사용해서 처리

 

【 함수 상세 설명 】

Date는 음력날짜로 문자열 형태로 입력되어야 함 (YYYY-MM-DD, YYYY/MM/DD, YYYY.MM.DD, YYYYMMDD)

실제 Excel에서는 셀서식이 날짜형식인 Date형식의 값도 정상작동함

 

【 함수 오류 설명 】

Date가 지정한 날짜 형태가 아닌 경우 #VALUE! 오류

지원하는 날짜 구간이 아닌 경우  #VALUE! 오류

윤달이 아닌데 LeapMonth에 True를 지정한 경우 #N/A 오류

 

【 함수 사용시 주의사항 】

Excel은 기본적으로 1900년 1월 1일~ 1900년 2월 28일 사이의 날짜는 오류가 있으므로 이 구간을 사용할 때에는 주의

Excel에서는 =TEXT(60, "YYYY-MM-DD") 의 결과가 "1900-02-29"이나 해당연도는 윤년이 아니므로 29일 없음.

 

【 함수 사용 예제 】

=TOSOLAR("2023-01-01")                : 2023-01-22

=TOSOLAR("2023-02-01", True)       : 2023-03-22

 

 

【 비슷한 기능의 다른 함수 】

TOLUNAR : 양력을 음력으로 변환

JULIANDAY : 양력날짜를 율리우스적일로 환산

JDTODATE : 율리우스적일을 양력날짜로 환산