Humanizer, verilerle çalışmayı basitleştiren ve insanlaştıran, özellikle bilgileri kullanıcı dostu bir formatta gösterirken güçlü ve esnek bir .NET kütüphanesidir. Tarihleri göreli zaman dizelerine dönüştürmeniz ('3 gün önce'), kelimeleri çoğul hale getirmeniz, sayıları kelime olarak biçimlendirmeniz veya enum'larla çalışmanız, dizeler gösterirken, Pascal durum girdi dizeleri gibi cümlelerle özelleştirilmiş açıklamalar yapmanız, alt çizgili giriş dizelerini normal başlık durum dizeleri haline getirmeniz ve uzun metin kesilmesi gibi işlemler için Humanizer'a ayrıntılı bir araç ve genişletme yöntemleri sağlıyor.
Bu makalede, C#'da Humanizer'in ayrıntılı bir öğreticisini tartışacağız. Ayrıca, C# PDF Kütüphanesi için Humanizer ve IronPDF kullanarak PDF belgelerini nasıl oluşturacağımızı tartışacağız.
Humanizer ile çalışmaya başlamak için NuGet aracılığıyla kütüphaneyi yüklemeniz gerekir. Projenizde bunu şu komutla Paket Yöneticisi Konsolu aracılığıyla yapabilirsiniz:
Alternatif olarak, .NET Core CLI'yi kullanıyorsanız, şu komutla Humanizer ekleyebilirsiniz:
Kurulumdan sonra, C# dosyalarınıza uygun ad alanını dahil ederek Humanizer kullanmaya başlayabilirsiniz:
using Humanizer;Imports HumanizerHumanizer'ın en yaygın kullanım alanlarından biri, tarhiler ve saatleri Humanize yöntemi ile insan tarafından okunabilir formatlara, süre aralıklarına, sayılara ve miktarlara dönüştürmektir. Bu özellikle "2 saat önce" veya "5 gün içinde" gibi göreceli zamanları göstermek için faydalıdır.
using System;
class HumanizerDemo
{
static void Main()
{
DateTime pastDate = DateTime.Now.AddDays(-3);
// Humanize the past date, which converts it to a relative time format
string humanizedTime = pastDate.Humanize(); // Output: "3 days ago"
DateTime futureDate = DateTime.Now.AddHours(5);
// Humanize the future date, presenting it in relative time
string futureHumanizedTime = futureDate.Humanize(); // Output: "in 5 hours"
Console.WriteLine("Humanized Past Date: " + humanizedTime);
Console.WriteLine("Humanized Future Date: " + futureHumanizedTime);
}
}Imports System
Friend Class HumanizerDemo
Shared Sub Main()
Dim pastDate As DateTime = DateTime.Now.AddDays(-3)
' Humanize the past date, which converts it to a relative time format
Dim humanizedTime As String = pastDate.Humanize() ' Output: "3 days ago"
Dim futureDate As DateTime = DateTime.Now.AddHours(5)
' Humanize the future date, presenting it in relative time
Dim futureHumanizedTime As String = futureDate.Humanize() ' Output: "in 5 hours"
Console.WriteLine("Humanized Past Date: " & humanizedTime)
Console.WriteLine("Humanized Future Date: " & futureHumanizedTime)
End Sub
End ClassHumanizer genişletme yöntemi, farklı zaman birimlerini otomatik olarak işler ve hatta dilbilgisi doğruluğu için ayarlamalar yapar.
Humanizer ayrıca süreleri okunabilir bir formatta görüntülemeyi kolaylaştırarak TimeSpan objelerini de insancıllaştırabilir.
using System;
class TimeSpanHumanizerDemo
{
static void Main()
{
TimeSpan timeSpan = TimeSpan.FromMinutes(123);
// Humanizing the TimeSpan into hours and minutes
string humanizedTimeSpan = timeSpan.Humanize(2); // Output: "2 hours, 3 minutes"
Console.WriteLine("Humanized TimeSpan: " + humanizedTimeSpan);
}
}Imports System
Friend Class TimeSpanHumanizerDemo
Shared Sub Main()
Dim timeSpan As TimeSpan = System.TimeSpan.FromMinutes(123)
' Humanizing the TimeSpan into hours and minutes
Dim humanizedTimeSpan As String = timeSpan.Humanize(2) ' Output: "2 hours, 3 minutes"
Console.WriteLine("Humanized TimeSpan: " & humanizedTimeSpan)
End Sub
End Class
Humanizer, sayıları insan tarafından okunabilir kelimelere dönüştürmek ve ordinalları işlemek için birkaç yöntem sağlar.
using System;
class NumberHumanizerDemo
{
static void Main()
{
int number = 123;
// Convert number to words
string words = number.ToWords(); // Output: "one hundred and twenty-three"
Console.WriteLine("Number in Words: " + words);
}
}Imports System
Friend Class NumberHumanizerDemo
Shared Sub Main()
Dim number As Integer = 123
' Convert number to words
Dim words As String = number.ToWords() ' Output: "one hundred and twenty-three"
Console.WriteLine("Number in Words: " & words)
End Sub
End Class
using System;
class OrdinalHumanizerDemo
{
static void Main()
{
int number = 21;
// Convert number to ordinal words
string ordinal = number.ToOrdinalWords(); // Output: "twenty-first"
Console.WriteLine("Ordinal Number: " + ordinal);
}
}Imports System
Friend Class OrdinalHumanizerDemo
Shared Sub Main()
Dim number As Integer = 21
' Convert number to ordinal words
Dim ordinal As String = number.ToOrdinalWords() ' Output: "twenty-first"
Console.WriteLine("Ordinal Number: " & ordinal)
End Sub
End Class
Humanizer, kelimeleri tekil ve çoğul biçimleri arasında dönüştürmeyi kolaylaştırır, bu da miktara göre uzun metinleri dinamik olarak oluşturmak için kullanışlıdır.
using System;
class PluralizationDemo
{
static void Main()
{
string singular = "car";
// Pluralize the word
string plural = singular.Pluralize(); // Output: "cars"
string word = "people";
// Singularize the word
string singularForm = word.Singularize(); // Output: "person"
Console.WriteLine("Plural of 'car': " + plural);
Console.WriteLine("Singular of 'people': " + singularForm);
}
}Imports System
Friend Class PluralizationDemo
Shared Sub Main()
Dim singular As String = "car"
' Pluralize the word
Dim plural As String = singular.Pluralize() ' Output: "cars"
Dim word As String = "people"
' Singularize the word
Dim singularForm As String = word.Singularize() ' Output: "person"
Console.WriteLine("Plural of 'car': " & plural)
Console.WriteLine("Singular of 'people': " & singularForm)
End Sub
End ClassHumanizer, düzensiz çoğul ve tekil koşulları da işleyerek çeşitli kullanım senaryoları için sağlam olur.
Enum'lar, C# uygulamalarında sıkça bir dizi adlandırılmış sabit temsil etmek için kullanılır. Humanizer enum değerlerini insan tarafından okunabilir dizelere dönüştürebilir.
using System;
public enum MyEnum
{
FirstValue,
SecondValue
}
class EnumHumanizerDemo
{
static void Main()
{
MyEnum enumValue = MyEnum.FirstValue;
// Humanizing enum to a readable format
string humanizedEnum = enumValue.Humanize(); // Output: "First value"
Console.WriteLine("Humanized Enum: " + humanizedEnum);
}
}Imports System
Public Enum MyEnum
FirstValue
SecondValue
End Enum
Friend Class EnumHumanizerDemo
Shared Sub Main()
Dim enumValue As MyEnum = MyEnum.FirstValue
' Humanizing enum to a readable format
Dim humanizedEnum As String = enumValue.Humanize() ' Output: "First value"
Console.WriteLine("Humanized Enum: " & humanizedEnum)
End Sub
End ClassBu yöntem, özellikle kullanıcı dostu etiketlerin arayüzlerde gösterilmesi için faydalı olabilir.
Humanizer'in başka bir elverişli özelliği, büyük bayt değerlerini KB, MB veya GB gibi okunabilir formatlara dönüştürerek bayt boyutlarını insanlaştırma yeteneğidir.
using System;
class ByteSizeHumanizerDemo
{
static void Main()
{
long bytes = 1048576;
// Humanize bytes to a readable size format
string humanizedBytes = bytes.Bytes().Humanize(); // Output: "1 MB"
Console.WriteLine("Humanized Byte Size: " + humanizedBytes);
}
}Imports System
Class ByteSizeHumanizerDemo
Shared Sub Main()
Dim bytes As Long = 1048576
' Humanize bytes to a readable size format
Dim humanizedBytes As String = bytes.Bytes().Humanize() ' Output: "1 MB"
Console.WriteLine("Humanized Byte Size: " & humanizedBytes)
End Sub
End Class
Humanizer, yukarıda tanımlanan temel senaryolarla sınırlı değildir. Uygulama zonalarını destekleyen Truncate yöntemi ve birden çok dil ve uzantılar gibi birçok gelişmiş özelliği destekler.
Humanizer, zaman dilimlerini ele alan uygulamalar için faydalı olan DateTimeOffset ile de başa çıkabilir.
using System;
class DateTimeOffsetHumanizerDemo
{
static void Main()
{
DateTimeOffset dateTimeOffset = DateTimeOffset.Now.AddDays(-2);
// Humanize DateTimeOffset
string humanizedDateTimeOffset = dateTimeOffset.Humanize(); // Output: "2 days ago"
Console.WriteLine("Humanized DateTimeOffset: " + humanizedDateTimeOffset);
}
}Imports System
Friend Class DateTimeOffsetHumanizerDemo
Shared Sub Main()
Dim dateTimeOffset As DateTimeOffset = System.DateTimeOffset.Now.AddDays(-2)
' Humanize DateTimeOffset
Dim humanizedDateTimeOffset As String = dateTimeOffset.Humanize() ' Output: "2 days ago"
Console.WriteLine("Humanized DateTimeOffset: " & humanizedDateTimeOffset)
End Sub
End Class
Humanizer verimli olacak şekilde tasarlanmıştır, ancak herhangi bir kütüphane gibi, performansı nasıl kullanıldığına bağlıdır. Büyük veri setleriyle veya gerçek zamanlı işleme ile ilgilenen uygulamalar için, sıkça yapılan insanlaştırma işlemlerinin etkisini düşünmek önemlidir.
IronPDF, .NET uygulamaları için kapsamlı bir PDF oluşturma ve manipülasyon kütüphanesidir. Geliştiricilere PDF dosyalarını kolaylıkla oluşturma, okuma, düzenleme ve içerik çıkarma imkanı sunar. IronPDF, kullanıcı dostu olacak şekilde tasarlanmış ve HTML'den PDF'ye dönüştürme, belgeleri birleştirme, filigran ekleme ve çok daha fazla işlevsellik sunar. Çok yönlülüğü ve güçlü özellikleri, C# projelerinde PDF belgeleriyle çalışmak için mükemmel bir seçim haline getirir.
NuGet Paket Yöneticisi'ni kullanarak IronPDF'i yüklemek için bu adımları izleyin:
Projenizi Visual Studio'da Açın:
NuGet Paket Yöneticisini Açın:
Bu adımları izleyerek, IronPDF C# projenize yüklenmiş ve kullanıma hazır hale gelecek, güçlü PDF manipülasyon yeteneklerinden yararlanmanızı sağlayacaktır.
using Humanizer;
using IronPdf;
using System;
using System.Collections.Generic;
class PDFGenerationDemo
{
static void Main()
{
// Instantiate the PDF renderer
var renderer = new ChromePdfRenderer();
// Generate humanized content
List<string> content = GenerateHumanizedContent();
// HTML content template for the PDF
string htmlContent = "<h1>Humanizer Examples</h1><ul>";
// Build the list items to add to the HTML content
foreach (var item in content)
{
htmlContent += $"<li>{item}</li>";
}
htmlContent += "</ul>";
// Render the HTML into a PDF document
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
// Save the PDF to a file
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF document generated successfully: output.pdf");
}
/// <summary>
/// Generates a list of humanized content examples
/// </summary>
/// <returns>List of humanized content as strings</returns>
static List<string> GenerateHumanizedContent()
{
List<string> content = new List<string>();
// DateTime examples
DateTime pastDate = DateTime.Now.AddDays(-3);
DateTime futureDate = DateTime.Now.AddHours(5);
content.Add($"DateTime.Now: {DateTime.Now}");
content.Add($"3 days ago: {pastDate.Humanize()}");
content.Add($"In 5 hours: {futureDate.Humanize()}");
// TimeSpan examples
TimeSpan timeSpan = TimeSpan.FromMinutes(123);
content.Add($"TimeSpan of 123 minutes: {timeSpan.Humanize()}");
// Number examples
int number = 12345;
content.Add($"Number 12345 in words: {number.ToWords()}");
content.Add($"Ordinal of 21: {21.ToOrdinalWords()}");
// Pluralization examples
string singular = "car";
content.Add($"Plural of 'car': {singular.Pluralize()}");
string plural = "children";
content.Add($"Singular of 'children': {plural.Singularize()}");
// Byte size examples
long bytes = 1048576;
content.Add($"1,048,576 bytes: {bytes.Bytes().Humanize()}");
return content;
}
}Imports Humanizer
Imports IronPdf
Imports System
Imports System.Collections.Generic
Class PDFGenerationDemo
Shared Sub Main()
' Instantiate the PDF renderer
Dim renderer As New ChromePdfRenderer()
' Generate humanized content
Dim content As List(Of String) = GenerateHumanizedContent()
' HTML content template for the PDF
Dim htmlContent As String = "<h1>Humanizer Examples</h1><ul>"
' Build the list items to add to the HTML content
For Each item In content
htmlContent += $"<li>{item}</li>"
Next
htmlContent += "</ul>"
' Render the HTML into a PDF document
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
' Save the PDF to a file
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF document generated successfully: output.pdf")
End Sub
''' <summary>
''' Generates a list of humanized content examples
''' </summary>
''' <returns>List of humanized content as strings</returns>
Shared Function GenerateHumanizedContent() As List(Of String)
Dim content As New List(Of String)()
' DateTime examples
Dim pastDate As DateTime = DateTime.Now.AddDays(-3)
Dim futureDate As DateTime = DateTime.Now.AddHours(5)
content.Add($"DateTime.Now: {DateTime.Now}")
content.Add($"3 days ago: {pastDate.Humanize()}")
content.Add($"In 5 hours: {futureDate.Humanize()}")
' TimeSpan examples
Dim timeSpan As TimeSpan = TimeSpan.FromMinutes(123)
content.Add($"TimeSpan of 123 minutes: {timeSpan.Humanize()}")
' Number examples
Dim number As Integer = 12345
content.Add($"Number 12345 in words: {number.ToWords()}")
content.Add($"Ordinal of 21: {21.ToOrdinalWords()}")
' Pluralization examples
Dim singular As String = "car"
content.Add($"Plural of 'car': {singular.Pluralize()}")
Dim plural As String = "children"
content.Add($"Singular of 'children': {plural.Singularize()}")
' Byte size examples
Dim bytes As Long = 1048576
content.Add($"1,048,576 bytes: {bytes.Bytes().Humanize()}")
Return content
End Function
End Class
Humanizer, .NET geliştiricilerinin kullanıcı dostu ve insan tarafından okunabilir bir formatta bilgi sunan uygulamalar oluşturmayı hedeflediği vazgeçilmez bir kütüphanedir. Tarihler ve zamanlar için insanlaştırma, sayı ve enum formatlama gibi geniş özellik yelpazesi, uygulamaların kullanılabilirliğini artırmak için çok yönlü bir araç yapar. Humanizer'dan yararlanan geliştiriciler, uygulamalarının son kullanıcılara verileri daha etkili bir şekilde iletmesini sağlayarak özel formatlama mantığını uygulama zahmetinden tasarruf edebilirler.
Benzer şekilde, IronPDF, C# projelerinde PDF belgeleri oluşturmak ve yönetmek için kapsamlı PDF üretim ve manipülasyon yetenekleri sunarak mükemmel bir seçimdir. Humanizer ve IronPDF bir araya geldiğinde, .NET uygulamalarının işlevselliğini ve sunumunu önemli ölçüde artırabilirler. IronPDF lisansı hakkında daha fazla bilgi için, IronPDF Lisans Bilgisine bakın. Daha fazla keşfetmek için, HTML'den PDF'ye Dönüştürme Üzerine Ayrıntılı Eğitimimize göz atın.
Jacob Mellor, Iron Software'de Baş Teknoloji Yöneticisidir ve C# PDF teknolojisinde öncü bir mühendisdir. Iron Software'ın ana kod tabanının ilk geliştiricisi olarak, CEO Cameron Rimington ile birlikte şirketin ürün mimarisini 50'den fazla kişilik bir şirkete dönüştürmüştür ve NASA, Tesla ve dünya genelindeki devlet kurumlarına hizmet etmektedir.
IronPDF, IRONSUITE'in bir parçasıdır
Ofis belgeleriniz için 10 .NET API ürünü
PDF'nizin HTML gibi görünmesine ihtiyaç duyduğunuzda, hızlı.
