KoreanNumberParser 1.2.0

KoreanNumberParser

🌐 English | 한국어

KoreanNumberParser는 한국어 숫자 문자열을 int, long, decimal, double로 변환하고 정수 값을 다시 한국어 숫자 문자열로 변환하는 .NET 라이브러리입니다.

10억4천3백만이십일, 사천만5백, 4000만오백처럼 한자어 수사와 아라비아 숫자가 섞인 표현을 처리할 수 있습니다.

설치

dotnet add package KoreanNumberParser

사용법

using KoreanNumberParser;

var value1 = KoreanNumber.ParseInt64("10억4천3백만이십일");
var value2 = KoreanNumber.ParseInt32("사천만5백");
var value3 = KoreanNumber.ParseInt64("4000만오백");
var value4 = KoreanNumber.ParseDecimal("일점오");
var value5 = KoreanNumber.ParseDecimal("1.5억");
var value6 = KoreanNumber.ParseDouble("삼쩜일사");

Console.WriteLine(value1); // 1043000021
Console.WriteLine(value2); // 40000500
Console.WriteLine(value3); // 40000500
Console.WriteLine(value4); // 1.5
Console.WriteLine(value5); // 150000000
Console.WriteLine(value6); // 3.14

문자열로 변환

using KoreanNumberParser;

var hangul = KoreanNumber.ToKoreanString(40000500);
var arabicChunk = KoreanNumber.ToKoreanString(40000500, KoreanNumberFormat.ArabicChunk);
var arabicUnitDigit = KoreanNumber.ToKoreanString(40000500, KoreanNumberFormat.ArabicUnitDigit);

Console.WriteLine(hangul); // 사천만 오백
Console.WriteLine(arabicChunk); // 4000만 500
Console.WriteLine(arabicUnitDigit); // 4천만 5백

ToKoreanString의 세 번째 파라미터 separateUnits(기본값 true)는 만·억·조·경 같은 큰 단위 그룹 사이에 띄어쓰기를 넣을지 결정합니다. false로 지정하면 띄어쓰기 없이 이어 붙인 결과를 반환합니다.

var hangulJoined = KoreanNumber.ToKoreanString(40000500, KoreanNumberFormat.Hangul, separateUnits: false);
Console.WriteLine(hangulJoined); // 사천만오백

지원 범위

• int, long 파싱과 포맷팅, decimal, double 파싱.
• 소수는 점, 쩜, . 구분자로 표현하며 소수부는 아라비아 숫자와 한글 숫자(영~구)만 지원합니다. 소수 뒤에는 십·백·천·만·억·조·경 같은 단위를 붙일 수 있습니다. 예: 1.5, 일점오, 삼쩜일사, 1.5억, 2.3천만.
• 영, 공, 일, 이, 삼, 사, 오, 육, 칠, 팔, 구.
• 십, 백, 천, 만, 억, 조, 경.
• 하나, 둘, 셋, 넷, 스물, 서른, 마흔 같은 고유어 수사 입력.
• -, +, 마이너스, 플러스, 공백, 쉼표.
• 아라비아 숫자와 한국어 단위가 섞인 입력.

고유어 수사는 입력 파싱에서만 지원합니다. 출력은 항상 한자어 수사 기반입니다.

예외

• KoreanNumberParseException: 입력 문자열을 한국어 숫자로 해석할 수 없을 때 발생합니다.
• KoreanNumberOverflowException: 파싱한 값이 요청한 타입의 범위를 벗어날 때 발생합니다.
• ArgumentNullException: ParseInt32, ParseInt64, ParseDecimal 또는 ParseDouble에 null을 전달했을 때 발생합니다.

TryParseInt32, TryParseInt64, TryParseDecimal, TryParseDouble은 실패 시 예외를 던지지 않고 false를 반환합니다.

라이선스

KoreanNumberParser는 MIT 라이선스로 배포됩니다.

제작자

이호원 (airtaxi)이 만들었습니다.

OpenAI Codex의 도움을 받아 제작되었습니다.