UaKit 0.1.3
dotnet add package UaKit --version 0.1.3
NuGet\Install-Package UaKit -Version 0.1.3
<PackageReference Include="UaKit" Version="0.1.3" />
<PackageVersion Include="UaKit" Version="0.1.3" />
<PackageReference Include="UaKit" />
paket add UaKit --version 0.1.3
#r "nuget: UaKit, 0.1.3"
#:package UaKit@0.1.3
#addin nuget:?package=UaKit&version=0.1.3
#tool nuget:?package=UaKit&version=0.1.3
UaKit: сума прописом, ЄДРПОУ, ІПН для .NET і JavaScript
Сума прописом, число прописом, перевірка ЄДРПОУ та ІПН (РНОКПП) для C#/.NET і JavaScript/TypeScript, без залежностей. Спробувати в браузері: Сума прописом онлайн.
Ukrainian amount in words (UAH, USD, EUR), number to words, EDRPOU and RNOKPP (tax ID) validation for .NET and JS.
Що вміє:
- ЄДРПОУ: перевірка контрольної цифри;
- РНОКПП (ІПН): перевірка, дата народження, стать;
- Сума прописом: гривні, долари, євро («Одна тисяча двісті п’ятдесят гривень 50 копійок»);
- Числа словами з узгодженням роду («одна», «дві», «одне»).
Обидві реалізації проходять один набір тестових векторів (shared/test-vectors.json), тому на однакових даних вони дають однаковий результат.
.NET
dotnet add package UaKit
Цільові платформи: netstandard2.0, net8.0, net10.0.
using UaKit;
Edrpou.IsValid("14360570"); // true
Edrpou.ComputeCheckDigit("1436057"); // 0
Rnokpp.IsValid("3287301233"); // true
if (Rnokpp.TryParse("3287301233", out var info))
{
// info.BirthDate == 1990-01-01, info.Sex == Sex.Male
}
MoneyToWords.ToWords(1250.50m);
// "Одна тисяча двісті п’ятдесят гривень 50 копійок"
MoneyToWords.ToWords(1250.50m, Currency.Uah, new MoneyWordsOptions { FractionAsWords = true });
// "Одна тисяча двісті п’ятдесят гривень п’ятдесят копійок"
MoneyToWords.ToWords(21m, Currency.Usd); // "Двадцять один долар США 00 центів"
NumberToWords.ToWords(2, Gender.Feminine); // "дві"
NumberToWords.Plural(5, "гривня", "гривні", "гривень"); // "гривень"
JavaScript / TypeScript
npm install uakit
ESM, типи в комплекті, Node 18+ і браузери.
import { isValidEdrpou, isValidRnokpp, parseRnokpp, moneyToWords, numberToWords } from 'uakit';
isValidEdrpou('14360570'); // true
isValidRnokpp('3287301233'); // true
parseRnokpp('3287301233'); // { code: '3287301233', birthDate: '1990-01-01', sex: 'male' }
moneyToWords(1250.5); // "Одна тисяча двісті п’ятдесят гривень 50 копійок"
moneyToWords('1250,50'); // те саме, кома теж підходить
moneyToWords(1.005); // "Одна гривня 01 копійка": округлення десяткове, без похибки float
moneyToWords(2, { currency: 'EUR' }); // "Два євро 00 центів"
moneyToWords(5, { fractionAsWords: true, apostrophe: "'" }); // "П'ять гривень нуль копійок"
numberToWords(21, { gender: 'feminine' }); // "двадцять одна"
numberToWords(10n ** 18n); // "один квінтильйон"
Налаштування суми прописом
.NET (MoneyWordsOptions) |
JS | За замовчуванням | Що робить |
|---|---|---|---|
FractionAsWords |
fractionAsWords |
false |
копійки словами замість цифр |
Capitalize |
capitalize |
true |
перша літера велика |
Apostrophe |
apostrophe |
’ (U+2019) |
символ апострофа, напр. ' |
параметр currency |
currency |
гривня | UAH, USD, EUR або власні форми |
Округлення до копійок: 0.5 округлюється від нуля (0.995 → 1.00).
Алгоритми
- ЄДРПОУ: ваги
1…7(для кодів від 30000000 до 60000000 ваги7,1…6), сума mod 11. Якщо вийшло 10, ваги збільшуються на 2 і рахунок повторюється; якщо знову 10, контрольна цифра 0. - РНОКПП: ваги
-1,5,7,9,4,6,10,5,7, контрольна цифра = сума mod 11 mod 10. Перші 5 цифр означають кількість днів від 31.12.1899; 9-та цифра непарна в чоловіків і парна в жінок.
Перевірка контрольної цифри означає лише, що номер правильно сформований, а не те, що такий платник існує в реєстрі.
Розробка
cd dotnet && dotnet test
cd js && npm install && npm test
Новий випадок спершу додавайте в shared/test-vectors.json: його перевірять обидві реалізації.
Реліз
CI проганяє тести обох пакетів на кожен push і PR. Публікація запускається тегом, з якого береться версія для NuGet і npm:
git tag v0.2.0 && git push origin v0.2.0
Секрети не потрібні: NuGet і npm приймають публікацію з publish.yml через Trusted Publishing (OIDC).
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
-
net10.0
- No dependencies.
-
net8.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.