Библиотека Humanizer в C#

[ Полезный рекламный блок ]

Попробуйте свои силы в игре, где ваши навыки программирования на C# станут решающим фактором. Переходите по ссылке 🔰.

Библиотека «Humanizer» является инструментом, предназначенным для упрощения работы с текстовым форматированием в C#. Она позволяет выполнять человеко-читаемое форматирование различных типов данных, таких как даты, числа, временные интервалы и другие.

Рассмотрим основные возможности, предоставляемые библиотекой Humanizer:

Форматирование чисел

HumanizeInteger: Позволяет форматировать целые числа в читабельную форму. Например, число 1000 может быть представлено как «1K» (одна тысяча).

Romanize: Преобразует число в римскую систему счисления.

Форматирование дат и времени

Humanize: Позволяет форматировать даты и времена в форме, более понятной для человека. Например, «2 часа назад», «вчера», «завтра» и т.д.

HumanizeInput: Преобразует дату и время в более читаемый формат в зависимости от разницы с текущим временем. Например, «2 недели назад», «через 5 минут» и т.д.

Работа с строками

Truncate: Усекает длину строки до указанного количества символов и добавляет троеточие.

Ordinalize: Преобразует число в его порядковую форму. Например, 1 превращается в «1st» (первый), 2 в «2nd» (второй) и т.д.

Работа с коллекциями

Oxfordize: Форматирует элементы коллекции в строку, разделяя их запятыми и используя союз «и» перед последним элементом. Например, «яблоки, апельсины и бананы».

Это только некоторые из множества возможностей, предоставляемых библиотекой Humanizer. Она имеет обширный набор методов для различных типов данных и предоставляет множество опций для настройки форматирования.

Установка и настройка

Для примера, создадим простой проект Console Application Net. Перейдем в Nuget Package Manager и в поиске введем: «Humanizer»:

Данная библиотека поддерживает множество языков, поэтому скачивайте ту, что вас интересует. Для примера я выбрал — «Humanizer.Core», который содержит английскую локализацию.

Примеры использования

Работать с этой библиотекой интуитивно просто, рассмотрим основные методы:

class Program
{
    static void Main()
    {
        // Форматирование чисел       
        int number = 42;
        string romanNumber = number.ToRoman(); // "XLII"

        int number2 = 1234;
        string wordsNumber = number2.ToWords(); // "one thousand two hundred and thirty-four"

        //Указание гендера числа, при русской локализации
        Console.WriteLine(1.ToWords(GrammaticalGender.Neuter)); // "одно"
        Console.WriteLine(1.ToWords(GrammaticalGender.Masculine)); // "один"
        Console.WriteLine(1.ToWords(GrammaticalGender.Feminine)); // "одна"
        
        //Порядок следования       
        Console.WriteLine(1.ToOrdinalWords()); // "first"
        Console.WriteLine(2.ToOrdinalWords()); // "second"
        Console.WriteLine(3.ToOrdinalWords()); // "third"

        //Можно так же указать гендер, при русской локализации
        Console.WriteLine(1.ToOrdinalWords(GrammaticalGender.Neuter)); // "первое"
        Console.WriteLine(2.ToOrdinalWords(GrammaticalGender.Masculine)); // "второй"
        Console.WriteLine(3.ToOrdinalWords(GrammaticalGender.Feminine)); // "третья"

        //Порядок следования, второй вариант
        Console.WriteLine(1.Ordinalize()); // "1st"
        Console.WriteLine(2.Ordinalize()); // "2nd"
        Console.WriteLine(3.Ordinalize()); // "3rd"

        // Форматирование дат и времени
        DateTime date = DateTime.Now.AddHours(-2);
        string humanizedDate = date.Humanize(); // "2 hours ago"


        DateTime date2 = DateTime.Now.AddDays(1);
        string humanizedDate2 = date2.Humanize(); // "tomorrow"

        string humanizedDate3 = DateTime.Now.AddSeconds(-30).Humanize();// "30 seconds ago"

        // Работа со строками
        string longString = "This is a very long string that needs to be truncated.";
        string truncatedString = longString.Truncate(20); // "This is a very long..."

        // Преобразование строки во множественное число с указанием количества
        int catCount = 1;
        string catString = "cat".ToQuantity(catCount, ShowQuantityAs.Numeric); // "1 cat"

        catCount = 3;
        catString = "cat".ToQuantity(catCount, ShowQuantityAs.Numeric); // "3 cats"       
    }  
}

class Program

{

static void Main()

{

// Форматирование чисел

int number = 42;

string romanNumber = number.ToRoman(); // "XLII"

int number2 = 1234;

string wordsNumber = number2.ToWords(); // "one thousand two hundred and thirty-four"

//Указание гендера числа, при русской локализации

Console.WriteLine(1.ToWords(GrammaticalGender.Neuter)); // "одно"

Console.WriteLine(1.ToWords(GrammaticalGender.Masculine)); // "один"

Console.WriteLine(1.ToWords(GrammaticalGender.Feminine)); // "одна"

//Порядок следования

Console.WriteLine(1.ToOrdinalWords()); // "first"

Console.WriteLine(2.ToOrdinalWords()); // "second"

Console.WriteLine(3.ToOrdinalWords()); // "third"

//Можно так же указать гендер, при русской локализации

Console.WriteLine(1.ToOrdinalWords(GrammaticalGender.Neuter)); // "первое"

Console.WriteLine(2.ToOrdinalWords(GrammaticalGender.Masculine)); // "второй"

Console.WriteLine(3.ToOrdinalWords(GrammaticalGender.Feminine)); // "третья"

//Порядок следования, второй вариант

Console.WriteLine(1.Ordinalize()); // "1st"

Console.WriteLine(2.Ordinalize()); // "2nd"

Console.WriteLine(3.Ordinalize()); // "3rd"

// Форматирование дат и времени

DateTime date = DateTime.Now.AddHours(-2);

string humanizedDate = date.Humanize(); // "2 hours ago"

DateTime date2 = DateTime.Now.AddDays(1);

string humanizedDate2 = date2.Humanize(); // "tomorrow"

string humanizedDate3 = DateTime.Now.AddSeconds(-30).Humanize();// "30 seconds ago"

// Работа со строками

string longString = "This is a very long string that needs to be truncated.";

string truncatedString = longString.Truncate(20); // "This is a very long..."

// Преобразование строки во множественное число с указанием количества

int catCount = 1;

string catString = "cat".ToQuantity(catCount, ShowQuantityAs.Numeric); // "1 cat"

catCount = 3;

catString = "cat".ToQuantity(catCount, ShowQuantityAs.Numeric); // "3 cats"

}

Кроме того что я показал, есть множество других возможностей, изучайте.

Я надеюсь, что вам понравилось читать эту статью, и она оказалась легкой для понимания. Пожалуйста, дайте мне знать, если у вас есть какие-либо комментарии или исправления.

Так же вам может быть интересна предыдущая статья — Как создать документ Word.

Вы хотите научится писать код на языке программирования C#?

Создавать различные информационные системы, состоящие из сайтов, мобильных клиентов, десктопных приложений, телеграмм-ботов и т.д.

Переходите к нам на страницу Dijix и ознакомьтесь с условиями обучения, мы специализируемся только на индивидуальных занятиях, как для начинающих, так и для более продвинутых программистов. Вы можете взять как одно занятие для проработки интересующего Вас вопроса, так и несколько, для более плотной работы. Благодаря личному кабинету, каждый студент повысит качество своего обучения, в вашем распоряжении: