ssaju

KO | EN

gitlite — search

#javascript #python #typescript #machine-learning #deep-learning #linux #docker #macos #java #awesome #vue #awesome-list #pytorch #ios

(★ 131)

🐶작고 ⚡빠른 사주/만세력 라이브러리

ssaju 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ssaju

🐶작고 ⚡빠른 사주/만세력 라이브러리.

> gzip **15KB** · 계산 **0.04ms** · 의존성 **0개**

```
npm install ssaju
```

생년월일 하나 넣으면 원국, 십성, 12운성, 합충형파해, 신살, 격국, 용신, 대운, 세운, 월운, 공망까지 한 방에 다 나옵니다.
LLM한테 먹이기 좋은 `toCompact()`랑 사람 눈에 예쁜 `toMarkdown()` 두 가지 출력 탑재.

## 🤔 왜 ssaju?

## 🚀 3초 컷

```ts
import { calculateSaju } from "ssaju";

const result = calculateSaju({
  year: 2001, month: 11, day: 3,
  hour: 14, minute: 20,
  gender: "남",
});

result.toCompact();  // 🤖 LLM한테 던지세요
result.toMarkdown(); // 👀 사람한테 보여주세요
```

## 📦 API

```ts
calculateSaju({
  // 필수
  year: 2001,
  month: 11,
  day: 3,

// 선택 (다 안 넣어도 됨)
  hour: 14,             // 기본 12
  minute: 20,            // 기본 0
  gender: "남",          // "남" | "여"
  calendar: "solar",     // "solar" | "lunar"
  leap: false,           // 음력 윤달 여부
  timezone: "Asia/Seoul",
  longitude: 126.9784,   // applyLocalMeanTime=true일 때
  applyLocalMeanTime: false,
  now: new Date(),       // 테스트/재현용 기준 시각
});
```

</details>

## 📊 출력 비교

| 포맷 | 토큰 수 | 언제 쓰나 |
|:--|--:|--:|
| `toCompact()` | ~950 | 🤖 LLM API 호출할 때 |
| `toMarkdown()` | ~2,170 | 👀 UI에 예쁘게 보여줄 때 |

## 🔍 출력 샘플

<details>
<summary><code>toCompact()</code> — LLM 최적화 압축 텍스트</summary>

```
## 기본
2001.11.03 14:20 남 양력 Asia/Seoul 만 24세
일간 庚(경)금+ 강약: 강(78) 격: 인수격 용신: 己, 丙, 癸

## 원국
 시 | 일 | 월 | 연
干 癸(계)수- | 庚(경)금+ | 戊(무)토+ | 辛(신)금-
支 未(미)토- | 午(오)화+ | 戌(술)토+ | 巳(사)화-
장간 丁,乙,己 | -,己,丁 | 辛,丁,戊 | 戊,庚,丙
干성 상관 | (일간) | 편인 | 겁재
支성 정인 | 정관 | 편인 | 편관
봉12 관대 | 목욕 | 쇠 | 장생
거12 장생 | 목욕 | 절 | 관대
12살 망신살 | 월살 | 역마살 | 년살
특살 천을귀인 | - | 화개살 | -

## 오행
干: 목0 화0 토1 금2 수1 | 支: 목0 화2 토2 금0 수0 | 계: 목0 화2 토3 금2 수1
공망 戌(술) 亥(해)
길신: 천을귀인, 화개 / 흉신: -

## 대운 역행 시작 9세 현재 ★丙申(19~28 잔여 4년)
 9(2010) 丁酉 정관/겁재 제왕 -
★19(2020) 丙申 편관/비견 건록 -
 29(2030) 乙未 정재/정인 관대 천을귀인
 39(2040) 甲午 편재/정관 목욕 -
 49(2050) 癸巳 상관/편관 장생 -
 59(2060) 壬辰 식신/편인 양 -
 69(2070) 辛卯 겁재/정재 태 도화살
 79(2080) 庚寅 비견/편재 절 -
 89(2090) 己丑 정인/정인 묘 천을귀인
 99(2100) 戊子 편인/상관 사 역마살

## 세운 2026 기준
 2021 辛丑 겁재/정인 묘
 2022 壬寅 식신/편재 절
 2023 癸卯 상관/정재 태
 2024 甲辰 편재/편인 양
 2025 乙巳 정재/편관 장생
★2026 丙午 편관/정관 목욕
 2027 丁未 정관/정인 관대
 2028 戊申 편인/비견 건록
 2029 己酉 정인/겁재 제왕
 2030 庚戌 비견/편인 쇠

## 월운 2026
1월 庚寅 비견/편재 절
2월 辛卯 겁재/정재 태
3월 壬辰 식신/편인 양
4월 癸巳 상관/편관 장생
5월 甲午 편재/정관 목욕
6월 乙未 정재/정인 관대
7월 丙申 편관/비견 건록
8월 丁酉 정관/겁재 제왕
9월 戊戌 편인/편인 쇠
10월 己亥 정인/식신 병
11월 庚子 비견/상관 사
12월 辛丑 겁재/정인 묘

## 만세력
이달 庚寅 다음 辛卯 오늘 丁丑 내일 戊寅 (2026-03-04)
```

</details>

<details>
<summary><code>toMarkdown()</code> — Markdown 테이블 포맷</summary>

```markdown
## 기본 정보
- 생년월일: 2001년 11월 3일 14:20
- 성별: 남성
- 역법: 양력
- 시간대: Asia/Seoul
- 일간: 庚 (경금, 양)

## 사주 4주 (남성)
| | 시주 | 일주 | 월주 | 연주 |
|:---:|:---:|:---:|:---:|:---:|
| 천간 | 癸(계) | 庚(경) | 戊(무) | 辛(신) |
| 오행/음양 | 수/음 | 금/양 | 토/양 | 금/음 |
| 지지 | 未(미) | 午(오) | 戌(술) | 巳(사) |
| 오행/음양 | 토/음 | 화/양 | 토/양 | 화/음 |

## 지장간
| 구분 | 시주(未) | 일주(午) | 월주(戌) | 연주(巳) |
|:---:|:---:|:---:|:---:|:---:|
| 여기 | 丁 | - | 辛 | 戊 |
| 중기 | 乙 | 己 | 丁 | 庚 |
| 정기 | 己 | 丁 | 戊 | 丙 |

## 오행 분포
| 구분 | 목 | 화 | 토 | 금 | 수 |
|:---:|:---:|:---:|:---:|:---:|:---:|
| 천간 | 0 | 0 | 1 | 2 | 1 |
| 지지 | 0 | 2 | 2 | 0 | 0 |
| 합계 | 0 | 2 | 3 | 2 | 1 |

## 십성 & 12운성
| 구분 | 시주 | 일주 | 월주 | 연주 |
|:---:|:---:|:---:|:---:|:---:|
| 천간십성 | 상관 | (일간) | 편인 | 겁재 |
| 지지십성 | 정인 | 정관 | 편인 | 편관 |
| 봉법12운성 | 관대 | 목욕 | 쇠 | 장생 |
| 거법12운성 | 장생 | 목욕 | 절 | 관대 |

## 해석 시 주의 포인트 (충/형 중심)
- 지지 형: 未戌 형 -> 압박/피로 누적 구간이 생기기 쉬워 갈등 확대 전에 조정이 필요합니다.
- 지지 파: 未戌 파 -> 계획의 균열이나 기대치 차이로 인한 이탈 신호를 점검하세요.

## 사주별 신살
| 구분 | 시주 | 일주 | 월주 | 연주 |
|:---:|:---:|:---:|:---:|:---:|
| 12신살 | 망신살 | 월살 | 역마살 | 년살 |
| 특수신살 | 천을귀인 | - | 화개살 | - |

## 공망 (空亡)
- 공망: 戌(술), 亥(해)

## 고급 분석
- 일간 강약: 강함 (78)
- 격국: 인수격
- 용신: 己, 丙, 癸
- 길신: 천을귀인, 화개
- 흉신: -

## 대운
- 시작나이: 9세 (정밀 8.67세)
- 현재 대운: 丙申 (19세~28세, 잔여 4년)
| 대운나이 | 간지 | 천간십성 | 지지십성 | 12운성 | 신살 |
|:---:|:---:|:---:|:---:|:---:|:---:|
| 9세 | 丁酉 | 정관 | 겁재 | 제왕 | - |
| 19세 ★ | 丙申 | 편관 | 비견 | 건록 | - |
| 29세 | 乙未 | 정재 | 정인 | 관대 | 천을귀인 |
| 39세 | 甲午 | 편재 | 정관 | 목욕 | - |
| 49세 | 癸巳 | 상관 | 편관 | 장생 | - |
| 59세 | 壬辰 | 식신 | 편인 | 양 | - |
| 69세 | 辛卯 | 겁재 | 정재 | 태 | 도화살 |
| 79세 | 庚寅 | 비견 | 편재 | 절 | - |
| 89세 | 己丑 | 정인 | 정인 | 묘 | 천을귀인 |
| 99세 | 戊子 | 편인 | 상관 | 사 | 역마살 |

## 세운 (2026년 기준)
| 연도 | 간지 | 천간십성 | 지지십성 | 12운성 |
|:---:|:---:|:---:|:---:|:---:|
| 2021 | 辛丑 | 겁재 | 정인 | 묘 |
| 2022 | 壬寅 | 식신 | 편재 | 절 |
| 2023 | 癸卯 | 상관 | 정재 | 태 |
| 2024 | 甲辰 | 편재 | 편인 | 양 |
| 2025 | 乙巳 | 정재 | 편관 | 장생 |
| 2026 ★ | 丙午 | 편관 | 정관 | 목욕 |
| 2027 | 丁未 | 정관 | 정인 | 관대 |
| 2028 | 戊申 | 편인 | 비견 | 건록 |
| 2029 | 己酉 | 정인 | 겁재 | 제왕 |
| 2030 | 庚戌 | 비견 | 편인 | 쇠 |

## 월운 (2026년)
| 월 | 간지 | 천간십성 | 지지십성 | 12운성 |
|:---:|:---:|:---:|:---:|:---:|
| 인월(1월) | 庚寅 | 비견 | 편재 | 절 |
| 묘월(2월) | 辛卯 | 겁재 | 정재 | 태 |
| 진월(3월) | 壬辰 | 식신 | 편인 | 양 |
| 사월(4월) | 癸巳 | 상관 | 편관 | 장생 |
| 오월(5월) | 甲午 | 편재 | 정관 | 목욕 |
| 미월(6월) | 乙未 | 정재 | 정인 | 관대 |
| 신월(7월) | 丙申 | 편관 | 비견 | 건록 |
| 유월(8월) | 丁酉 | 정관 | 겁재 | 제왕 |
| 술월(9월) | 戊戌 | 편인 | 편인 | 쇠 |
| 해월(10월) | 己亥 | 정인 | 식신 | 병 |
| 자월(11월) | 庚子 | 비견 | 상관 | 사 |
| 축월(12월) | 辛丑 | 겁재 | 정인 | 묘 |

## 계산 기준
- 대운 기준: 역행, 절입 2001-10-08 05:22 UTC

## 만세력
- 올해: 丙午
- 내년: 丁未
- 이번달: 庚寅
- 다음달: 辛卯
- 오늘: 丁丑
- 내일: 戊寅
- 오늘날짜: 2026-03-04

## 해석
인수격 구조입니다. 학습, 연구, 문서, 상담 영역에서 장점이 큽니다.

가장 강한 오행은 토(3개)이며, 안정·중재 지향 성향이 두드러집니다.
길신: 천을귀인, 화개
```

</details>

## ⏱️ 벤치마크

warmup 800회 돌리고 6,000회 측정. Apple M2 기준.

| 뭘 했나 | 걸린 시간 | ops/sec |
|:--|--:|--:|
| 사주 계산 (양력) | 0.04ms | 23,348 |
| 사주 계산 (음력) | 0.04ms | 24,264 |
| 계산 + `toCompact()` | 0.06ms | 17,160 |
| 계산 + `toMarkdown()` | 0.06ms | 17,333 |

| 파일 | 크기 |
|:--|--:|
| dist raw | 42.5 KB |
| dist gzip | 14.7 KB |
| dist brotli | 12.4 KB |

</details>

ssaju

ssaju 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ssaju

ssaju 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README