운한（運限）
^2.6.2 운한（運限） 조회는 명반을 생성할 때 저장된 설정과 언어를 사용합니다. 전역 기본값을 바꾸거나 다른 명반을 만들어도 기존 명반의 조회 결과는 바뀌지 않습니다.horoscope()는 유효한 Date 객체나 날짜 문자열을 받으며, 날짜를 생략하면 호출 시점의 현재 시간을 사용합니다. 시각 인덱스를 직접 지정할 때는 0~12의 정수여야 합니다. 유효하지 않은 날짜나 시각 인덱스는 오류를 발생시킵니다.서문
자미두수（紫微斗數）의 운한（運限）에는 대한（大限）, 소한（小限）, 유년（流年）, 유월（流月）, 유일（流日）, 유시（流時）, 분 단위 운한（流分）, 초 단위 운한（流秒） 등이 있습니다. 개념과 활용은 운한 설명을 읽어 보세요. iztro는 대한（大限）, 소한（小限）, 유년（流年）, 유월（流月）, 유일（流日）, 유시（流時）를 지원합니다. 이 중 대한（大限）, 유년（流年）, 유월（流月）, 유일（流日）, 유시（流時）는 유요（流曜）와 사화（四化）를 제공합니다. 유월（流月）, 유일（流日）, 유시（流時）의 유요는 v2.4.4부터 제공됩니다. 소한（小限）에는 독립적인 유요가 없고, 소한（小限）의 사화는 해당 궁의 궁간（宮干）으로 계산합니다.
팁
운한（運限）의 연·월 간지 경계는 명반에 저장된 horoscopeDivide 설정을 따르며, 소한（小限）의 세는나이（虛歲） 경계는 ageDivide를 따릅니다.
클래스와 분석 메서드
개발 제안
운한（運限）은 명반을 바탕으로 하므로, new로 직접 객체를 만들기보다 명반 인스턴스에서 가져오세요. 명반의 horoscope() 메서드가 운한 객체를 반환합니다.
import { astro } from "iztro";
const astrolabe = astro.astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN");
const horoscope = astrolabe.horoscope('2023-10-26', 2);위 코드가 실행되면 FunctionalHoroscope 인스턴스가 반환됩니다.
FunctionalHoroscope
implements
IFunctionalHoroscope extends Horoscope이 클래스의 모든 속성은 Horoscope에서 상속되며, 인터페이스에는 운한의 별을 분석하는 메서드가 추가됩니다.
인터페이스 정의
ts^2.6.1interface IFunctionalHoroscope extends Horoscope { toJSON: () => Horoscope; agePalace: () => FunctionalPalace | undefined; palace: (palaceName: PalaceName, scope: Scope) => FunctionalPalace | undefined; surroundPalaces: (palaceName: PalaceName, scope: Scope) => FunctionalSurpalaces | undefined; hasHoroscopeStars: (palaceName: PalaceName, scope: Scope, horoscopeStar: StarName[]) => boolean; notHaveHoroscopeStars: (palaceName: PalaceName, scope: Scope, horoscope: StarName[]) => boolean; hasOneOfHoroscopeStars: (palaceName: PalaceName, scope: Scope, horoscopeStar: StarName[]) => boolean; hasHoroscopeMutagen: (palaceName: PalaceName, scope: Scope, horoscopeMutagen: Mutagen) => boolean; }palaceName에는 명반의 출력 언어와 상관없이 설정된 어느 언어의 궁 이름이든 전달할 수 있습니다. 예를 들어 중국어로 출력된 명반에도 영어 궁 이름"soul"을 사용할 수 있습니다.속성
참조 Horoscope
메서드
toJSON() ^2.6.0
목적
분석 기능이 있는 운한 객체를 일반 JSON 객체로 변환합니다. 분석 메서드와 소속 명반에 대한 실행 시점의 참조는 포함하지 않으며, 순환 참조도 안전하게 제외합니다.
정의
tstype toJSON = () => Horoscope;매개변수
없음
반환 값
예제
tsimport { astro } from "iztro"; const astrolabe = astro.bySolar("2000-8-16", 2, "女"); const data = astrolabe.horoscope("2023-8-19").toJSON();
agePalace() v1.3.0
목적
소한（小限）이 위치한 궁을 가져옵니다.정의
tstype agePalace: () => FunctionalPalace | undefined;매개변수
없음
반환 값
FunctionalPalace|undefined예제
tsimport { astro } from "iztro"; const astrolabe = astro .astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN"); const agePalace = astrolabe .horoscope('2023-10-26', 2) .agePalace();
palace() v1.3.0
목적
지정한 운한（運限）의 궁을 가져옵니다.
정의
tstype palace = ( palaceName: PalaceName, scope: Scope ) => FunctionalPalace | undefined;매개변수
매개변수 타입 필수 여부 기본값 설명 palaceName PalaceNametrue- 궁 이름 scope Scopetrue- 운한 이름 반환 값
FunctionalPalace|undefined예제
대한（大限）의부처（夫妻）궁을 가져옵니다.tsimport { astro } from "iztro"; const astrolabe = astro .astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN"); const spousePalace = astrolabe .horoscope('2023-10-26', 2) .palace("夫妻", "decadal");
surroundPalaces() ^1.3.0
목적
지정한 운한 궁의 삼방사정（三方四正）에 해당하는 궁들을 가져옵니다.
정의
tstype surroundPalaces = ( palaceName: PalaceName, scope: Scope ) => FunctionalSurpalaces | undefined;매개변수
매개변수 타입 필수 여부 기본값 설명 palaceName PalaceNametrue- 궁 이름 scope Scopetrue- 운한 이름 반환 값
FunctionalSurpalaces|undefined예제
유년 부처궁（流年夫妻宮）의 삼방사정（三方四正）에 해당하는 궁들을 가져옵니다.tsimport { astro } from "iztro"; const astrolabe = astro .astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN"); const surpalaces = astrolabe .horoscope('2023-10-26', 2) .surroundPalaces("夫妻", "yearly");
hasHoroscopeStars() ^1.3.0
목적
지정한 운한의 궁에 있는 유요（流曜）를 확인합니다. 지정한 모든 별이 존재해야 참을 반환합니다.
정의
tstype hasHoroscopeStars = ( palaceName: PalaceName, scope: Scope, horoscopeStar: StarName[] ) => boolean;매개변수
매개변수 타입 필수 여부 기본값 설명 palaceName PalaceNametrue- 궁 이름 scope Scopetrue- 운한 이름 horoscopeStar StarName[]true- 유요 배열 반환 값
boolean예제
유년 부처궁（流年夫妻宮）에천희(년)（流喜）와문곡(년)（流曲）이 모두 있는지 확인합니다.tsimport { astro } from "iztro"; const astrolabe = astro .astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN"); const flag = astrolabe .horoscope('2023-10-26', 2) .hasHoroscopeStars("夫妻", "yearly", ["流喜", "流曲"]);
notHaveHoroscopeStars() ^1.3.2
목적
지정한 운한의 궁에 지정한 유요（流曜）가 하나도 없어야 참을 반환합니다.
정의
tstype notHaveHoroscopeStars = ( palaceName: PalaceName, scope: Scope, horoscope: StarName[] ) => boolean;매개변수
매개변수 타입 필수 여부 기본값 설명 palaceName PalaceNametrue- 궁 이름 scope Scopetrue- 운한 이름 horoscopeStar StarName[]true- 유요 배열 반환 값
boolean예제
유년 부처궁（流年夫妻宮）에천희(년)（流喜）와문곡(년)（流曲）이 모두 없는지 확인합니다.tsimport { astro } from "iztro"; const astrolabe = astro .astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN"); const flag = astrolabe .horoscope('2023-10-26', 2) .notHaveHoroscopeStars("夫妻", "yearly", ["流喜", "流曲"]);
hasOneOfHoroscopeStars() ^1.3.3
목적
지정한 운한의 궁에 지정한 유요（流曜）가 하나라도 있으면 참을 반환합니다.
정의
tstype hasOneOfHoroscopeStars= (palaceName: PalaceName, scope: Scope, horoscopeStar: StarName[]) => boolean;매개변수
매개변수 타입 필수 여부 기본값 설명 palaceName PalaceNametrue- 궁 이름 scope Scopetrue- 운한 이름 horoscopeStar StarName[]true- 유요 배열 반환 값
boolean예제
유년 부처궁（流年夫妻宮）에천희(년)（流喜）나문곡(년)（流曲） 중 하나라도 있는지 확인합니다.tsimport { astro } from "iztro"; const astrolabe = astro .astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN"); const flag = astrolabe .horoscope('2023-10-26', 2) .hasOneOfHoroscopeStars("夫妻", "yearly", ["流喜", "流曲"]);
hasHoroscopeMutagen() ^1.3.4
목적
지정한 운한（運限）의 사화（四化）가 해당 궁에 있는지 확인합니다.
정의
tstype hasHoroscopeMutagen = (palaceName: PalaceName, scope: Scope, horoscopeMutagen: Mutagen) => boolean;매개변수
매개변수 타입 필수 여부 기본값 설명 palaceName PalaceNametrue- 궁 이름 scope Scopetrue- 운한 이름 horoscopeMutagen Mutagentrue- 사화（四化） 반환 값
boolean예제
유년 부처궁（流年夫妻宮）에록（化祿）이 있는지 확인합니다.tsimport { astro } from "iztro"; const astrolabe = astro .astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN"); const flag = astrolabe .horoscope('2023-10-26', 2) .hasHoroscopeMutagen("夫妻", "yearly", "禄");