number-formatter-string

Библиотека для форматирования чисел, дат и строк с поддержкой локализации /
JavaScript/TypeScript library for formatting numbers, dates and strings with localization support

Разработчики / Developers

| Role / Роль | Name / Имя | GitHub Profile | |--------------------|----------------|----------------| | Team Lead | Vladimir | vladimirplyukhin89 | | Author & Developer | Leonid | miliukovlo | | Developer | Demid | knyazWeb | | Developer | Denis | krylv |

📥 Установка / Installation

npm install number-formatter-string
# или / or
yarn add number-formatter-string

Функционал / Features:

1. formatDateToString(date: Date): string - Форматирование даты в строку / Date to string formatting

const today = new Date();
formatDateToString(today); // "15.11.2023 14:30:00"

2. formatFloatReplaceDot(value: number): string - Замена точки на запятую / Dot to comma replacement

formatFloatReplaceDot(1234.56); // "1234,56"

3. formatLocalPhoneNumber(phone: string | number): string - Форматирование телефона / Phone number formatting

formatLocalPhoneNumber("79001234567"); // "+7 (900) 123-45-67"
formatLocalPhoneNumber(79001234567);  // "+7 (900) 123-45-67"

4. formatNumberToPriceIntl(value: number, options?) - Денежное форматирование / Currency formatting

// По умолчанию RUB / Default RUB
formatNumberToPriceIntl(1500); // "1 500 ₽"

// Доллары США / USD
formatNumberToPriceIntl(1500, { 
  locale: 'en-US', 
  currency: 'USD'
}); // "$1,500"

// Евро с копейками / Euro with cents
formatNumberToPriceIntl(1500.5, {
  locale: 'de-DE',
  currency: 'EUR',
  minFractionDigits: 2,
  maxFractionDigits: 2
}); // "1.500,50 €"

5. formatNumberToPriceString(value: string | number): string - Форматирование с единицами / Unit formatting

formatNumberToPriceString(1500); // "1.50K"
formatNumberToPriceString(2500000); // "2.50M"

6. formatNumberToRoman(num: number): string - Римские цифры / Roman numerals

formatNumberToRoman(1987); // "MCMLXXXVII"
formatNumberToRoman(2023); // "MMXXIII"

7. formatNumberWithSpaces(value, options?) - Разделители тысяч / Thousands separators

formatNumberWithSpaces(1234567); // "1 234 567"
formatNumberWithSpaces(1234567.89, {
  thousands: '.',
  decimal: ',',
  decimals: 2
}); // "1.234.567,89"

8. getNoun(count: number, forms: string[]): string - Склонение существительных / Noun pluralization

// Русский / Russian
getNoun(5, ['слон', 'слона', 'слонов']); // "слонов"
getNoun(1, ['слон', 'слона', 'слонов']); // "слон"

// English
getNoun(5, ['day', 'days', 'days']); // "days"
getNoun(1, ['day', 'days', 'days']); // "day"