korean_lunar_utils #

Korean lunar/solar conversion utility with a structured converter API.

한국어 #

소개 #

korean_lunar_utils는 한국 음력/양력 변환을 위한 간단한 Dart 패키지입니다.

지원 범위 #

• 양력/음력 변환 범위: 1900-01-31 ~ 2049-12-31
• 윤달 정보가 필요할 경우 LunarDate를 사용하세요.

설치 #

dart pub add korean_lunar_utils

사용법 #

import 'package:korean_lunar_utils/korean_lunar_utils.dart';

// 음력 -> 양력 (윤달 정보 없음)
final solar = LunarSolarConverter.convertLunarToSolar(
  DateTime(2024, 7, 14),
);

// 양력 -> 음력 (윤달 정보 없음)
final lunar = LunarSolarConverter.convertSolarToLunar(
  DateTime(2024, 8, 17),
);

// 윤달 포함 음력 -> 양력
final solarFromLeap = LunarSolarConverter.convertLunarDateToSolar(
  const LunarDate(2020, 4, 1, isLeapMonth: true),
);

API 요약 #

• LunarSolarConverter.convertLunarToSolar(DateTime)
• LunarSolarConverter.convertSolarToLunar(DateTime)
• LunarSolarConverter.convertLunarDateToSolar(LunarDate)
• LunarSolarConverter.entries (1900~2040 변환 테이블)

English #

Overview #

korean_lunar_utils is a lightweight Dart package for converting Korean lunar and solar dates.

Supported Range #

• Supported conversion range: 1900-01-31 through 2049-12-31
• Use LunarDate when you need leap-month (intercalary) information.

Install #

dart pub add korean_lunar_utils

Usage #

import 'package:korean_lunar_utils/korean_lunar_utils.dart';

// Lunar -> Solar (no leap-month info)
final solar = LunarSolarConverter.convertLunarToSolar(
  DateTime(2024, 7, 14),
);

// Solar -> Lunar (no leap-month info)
final lunar = LunarSolarConverter.convertSolarToLunar(
  DateTime(2024, 8, 17),
);

// Lunar with leap-month -> Solar
final solarFromLeap = LunarSolarConverter.convertLunarDateToSolar(
  const LunarDate(2020, 4, 1, isLeapMonth: true),
);

API Summary #

• LunarSolarConverter.convertLunarToSolar(DateTime)
• LunarSolarConverter.convertSolarToLunar(DateTime)
• LunarSolarConverter.convertLunarDateToSolar(LunarDate)
• LunarSolarConverter.entries (conversion table for 1900-2040)

Publishing #

This package is prepared for publishing to pub.dev. Run:

dart pub publish --dry-run