Humanizer C# (.NET): métodos, exemplos, instalação | PythonLib

Humanizer para C# (.NET): guia completo com exemplos práticos

1. O que é e para que serve

Humanizer é uma biblioteca open source popular para a plataforma .NET que resolve um dos problemas mais comuns dos desenvolvedores: converter dados técnicos e orientados a máquina em um formato legível para humanos. Em vez de escrever dezenas de métodos auxiliares para formatar datas, números, enums e strings, o Humanizer oferece uma interface fluente elegante (encadeamento de chamadas de métodos) que torna o código mais limpo e a saída mais amigável.

Para que serve? Imagine que você precisa exibir para o usuário o horário de publicação de um comentário. Em vez do seco "2024-03-15T14:30:00Z", é muito melhor mostrar "15 de março de 2024, 14:30" ou, se passou pouco tempo, "agora mesmo", "há 5 minutos". O Humanizer faz essas transformações com uma única linha de código. A biblioteca oferece suporte a localização (mais de 30 idiomas, incluindo português), trabalho com números (números ordinais, algarismos romanos, bytes "humanizados"), enums (strings bonitas com espaços em vez de CamelCase) e muito mais.

O Humanizer é escrito em C# e é totalmente compatível com .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5/6/7/8, além de Xamarin, Unity e outras plataformas que suportam .NET Standard 2.0. Isso o torna a escolha ideal para qualquer projeto .NET que exija localização e melhoria da experiência do usuário.

2. Instalação

A instalação do Humanizer em um projeto .NET é feita através do gerenciador de pacotes NuGet. Use um dos seguintes comandos:

# Instalação via .NET CLI (recomendado)
dotnet add package Humanizer

# Instalação via Package Manager Console (Visual Studio)
Install-Package Humanizer

# Instalação via NuGet Package Manager
# Ou procure por "Humanizer" na interface gráfica do NuGet

Após a instalação, adicione a diretiva using Humanizer; no início do arquivo de código.

Nota: Se você precisar apenas de uma funcionalidade específica (por exemplo, apenas trabalhar com datas), existem pacotes mais leves: Humanizer.Core (básico), Humanizer.Core.pt (localização em português). Mas para a maioria dos projetos, o pacote completo Humanizer é suficiente.