在實際環境中測試
在生產環境中測試無浮水印。
在任何需要的地方都能運作。
Humanizer 是一個強大且靈活的 .NET 函式庫,它簡化和人性化了處理數據的過程,特別是在以使用者友好的格式顯示資訊時。 無論您是否需要將日期轉換為相對時間字串(3 天前)將單字複數化、將數字格式化為文字,或處理枚舉、顯示字串、將 Pascal 大小寫輸入字串作為具有自訂描述的句子、將底線輸入字串轉換為標題大小寫字串,以及長文字截斷,Humanizer 在 C#.NET 中提供大量工具和擴展方法來優雅地處理這些任務,以將非人性化的輸入字串轉換為句子。
在本文中,我們將討論 C# 中 Humanizer 的詳細教學。 我們還將討論如何使用 Humanizer 和 IronPDF for C# PDF Library 生成 PDF 文件。
要開始使用Humanizer,您需要通過NuGet安裝該庫。 在您的專案中,您可以通過套件管理器主控台使用以下命令來完成此操作:
Install-Package Humanizer
Install-Package Humanizer
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package Humanizer
或者,如果您在使用 .NET Core CLI,您可以使用以下命令添加 Humanizer:
dotnet add package Humanizer
安裝後,您可以透過在您的 C# 文件中包含適當的命名空間開始使用 Humanizer:
using Humanizer;
using Humanizer;
Imports Humanizer
Humanizer 最常見的用途之一是使用 Humanize
方法將日期和時間轉換為人類可讀的格式、時間跨度、數字和數量。 這特別適用於顯示相對時間,例如「2小時前」或「5天後」。
DateTime pastDate = DateTime.Now.AddDays(-3);
string humanizedTime = pastDate.Humanize(); // Output: "3 days ago"
DateTime futureDate = DateTime.Now.AddHours(5);
string futureHumanizedTime = futureDate.Humanize(); // Output: "in 5 hours"
DateTime pastDate = DateTime.Now.AddDays(-3);
string humanizedTime = pastDate.Humanize(); // Output: "3 days ago"
DateTime futureDate = DateTime.Now.AddHours(5);
string futureHumanizedTime = futureDate.Humanize(); // Output: "in 5 hours"
Dim pastDate As DateTime = DateTime.Now.AddDays(-3)
Dim humanizedTime As String = pastDate.Humanize() ' Output: "3 days ago"
Dim futureDate As DateTime = DateTime.Now.AddHours(5)
Dim futureHumanizedTime As String = futureDate.Humanize() ' Output: "in 5 hours"
Humanizer 擴充方法自動處理不同的時間單位,甚至調整語法正確性。
Humanizer 也可以將 TimeSpan
物件人性化,使顯示持續時間的格式易於閱讀。
TimeSpan timeSpan = TimeSpan.FromMinutes(123);
string humanizedTimeSpan = timeSpan.Humanize(2); // Output: "2 hours, 3 minutes"
TimeSpan timeSpan = TimeSpan.FromMinutes(123);
string humanizedTimeSpan = timeSpan.Humanize(2); // Output: "2 hours, 3 minutes"
Dim timeSpan As TimeSpan = System.TimeSpan.FromMinutes(123)
Dim humanizedTimeSpan As String = timeSpan.Humanize(2) ' Output: "2 hours, 3 minutes"
Humanizer 提供多種方法將數字轉換為人類可讀的文字,並處理序數。
int number = 123;
string words = number.ToWords(); // Output: "one hundred and twenty-three"
int number = 123;
string words = number.ToWords(); // Output: "one hundred and twenty-three"
Dim number As Integer = 123
Dim words As String = number.ToWords() ' Output: "one hundred and twenty-three"
int number = 21;
string ordinal = number.ToOrdinalWords(); // Output: "twenty-first"
int number = 21;
string ordinal = number.ToOrdinalWords(); // Output: "twenty-first"
Dim number As Integer = 21
Dim ordinal As String = number.ToOrdinalWords() ' Output: "twenty-first"
Humanizer 使得在單數和複數形式之間轉換變得簡單,這對於根據數量動態生成長文本非常有用。
string singular = "car";
string plural = singular.Pluralize(); // Output: "cars"
string word = "people";
string singularForm = word.Singularize(); // Output: "person"
string singular = "car";
string plural = singular.Pluralize(); // Output: "cars"
string word = "people";
string singularForm = word.Singularize(); // Output: "person"
Dim singular As String = "car"
Dim plural As String = singular.Pluralize() ' Output: "cars"
Dim word As String = "people"
Dim singularForm As String = word.Singularize() ' Output: "person"
Humanizer 也能處理不規則的複數化和單數化,使其在各種使用情境中更為強大。
枚舉常常在 C# 應用程序中使用,用來表示一組命名常數。 Humanizer 可以將列舉值轉換為易讀的字串。
MyEnum enumValue = MyEnum.FirstValue;
string humanizedEnum = enumValue.Humanize();
System.Console.WriteLine(humanizedEnum);
public enum MyEnum
{
FirstValue,
SecondValue
} // Output: "First value"
MyEnum enumValue = MyEnum.FirstValue;
string humanizedEnum = enumValue.Humanize();
System.Console.WriteLine(humanizedEnum);
public enum MyEnum
{
FirstValue,
SecondValue
} // Output: "First value"
Private enumValue As MyEnum = MyEnum.FirstValue
Private humanizedEnum As String = enumValue.Humanize()
System.Console.WriteLine(humanizedEnum)
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'public enum MyEnum
'{
' FirstValue,
' SecondValue
'} ' Output: "First value"
此方法對於在用戶界面中顯示易於使用的標籤特別有用。
Humanizer 的另一個便利功能是能將位元組大小人性化,將大的位元組值轉換為可讀格式,如 KB、MB 或 GB。
long bytes = 1048576;
string humanizedBytes = bytes.Bytes().Humanize(); // Output: "1 MB"
long bytes = 1048576;
string humanizedBytes = bytes.Bytes().Humanize(); // Output: "1 MB"
Dim bytes As Long = 1048576
Dim humanizedBytes As String = bytes.Bytes().Humanize() ' Output: "1 MB"
Humanizer 不僅限於上述基本場景。 它支持多種進階功能,例如 Truncate
方法以及多種語言和擴展。
Humanizer 也可以處理 DateTimeOffset
,這對於處理時區的應用程式非常有用。
DateTimeOffset dateTimeOffset = DateTimeOffset.Now.AddDays(-2);
string humanizedDateTimeOffset = dateTimeOffset.Humanize(); // Output: "2 days ago"
DateTimeOffset dateTimeOffset = DateTimeOffset.Now.AddDays(-2);
string humanizedDateTimeOffset = dateTimeOffset.Humanize(); // Output: "2 days ago"
Dim dateTimeOffset As DateTimeOffset = System.DateTimeOffset.Now.AddDays(-2)
Dim humanizedDateTimeOffset As String = dateTimeOffset.Humanize() ' Output: "2 days ago"
Humanizer 被設計得非常高效,但像任何庫一樣,其性能取決於其使用方式。 對於需要高效能的應用程式,尤其是涉及大型數據集或即時處理的應用程式,必須考慮到頻繁的人工操作對效能的影響。
IronPDF 是一個全面的 PDF 生成和操作庫,適用於 .NET 應用程式。 它使開發人員能夠輕鬆地創建、讀取、編輯和提取 PDF 文件的內容。 IronPDF 設計為使用者友好,提供廣泛的功能,包括將 HTML 轉換為 PDF、合併文件、添加浮水印等多種功能。 其多功能性和強大功能使其成為在 C# 專案中處理 PDF 文件的出色選擇。
按照以下步驟使用 NuGet 套件管理器安裝 IronPDF:
在 Visual Studio 中打開您的專案:
打開 NuGet 套件管理員:
在方案總管中右鍵點擊你的專案。
安裝 IronPDF:
在 NuGet 套件管理器中,轉到「瀏覽」標籤。
搜尋 IronPDF。
從搜索結果中選擇 IronPDF 套件。
按照這些步驟,IronPDF 將會安裝並在您的 C# 項目中準備就緒,讓您能夠利用其強大的 PDF 處理功能。
using Humanizer;
using IronPdf;
using System;
using System.Collections.Generic;
class Program
{
static void Main()
{
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
List<string> content = GenerateHumanizedContent();
string htmlContent = "<h1>Humanizer Examples</h1><ul>";
// Iterate over each item in the List and add it to the HTML string
foreach (var item in content)
{
htmlContent += $"<li>{item}</li>";
}
htmlContent += "</ul>";
// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
// Export to a file or stream
pdf.SaveAs("output.pdf");
}
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;
}
}
using Humanizer;
using IronPdf;
using System;
using System.Collections.Generic;
class Program
{
static void Main()
{
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
List<string> content = GenerateHumanizedContent();
string htmlContent = "<h1>Humanizer Examples</h1><ul>";
// Iterate over each item in the List and add it to the HTML string
foreach (var item in content)
{
htmlContent += $"<li>{item}</li>";
}
htmlContent += "</ul>";
// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
// Export to a file or stream
pdf.SaveAs("output.pdf");
}
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
Friend Class Program
Shared Sub Main()
' Instantiate Renderer
Dim renderer = New ChromePdfRenderer()
Dim content As List(Of String) = GenerateHumanizedContent()
Dim htmlContent As String = "<h1>Humanizer Examples</h1><ul>"
' Iterate over each item in the List and add it to the HTML string
For Each item In content
htmlContent &= $"<li>{item}</li>"
Next item
htmlContent &= "</ul>"
' Create a PDF from an HTML string using C#
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
' Export to a file or stream
pdf.SaveAs("output.pdf")
End Sub
Private 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 = System.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 開發人員。 它的功能範圍廣泛,從日期和時間的人性化到數字和枚舉的格式化,使其成為提高應用程式可用性的多功能工具。 通過利用 Humanizer,開發人員可以節省實現自定義格式化邏輯的時間和精力,確保他們的應用程式能更有效地向終端使用者傳達數據。
同樣,IronPDF提供全面的PDF生成和操作功能,使其成為在C#項目中創建和處理PDF文檔的絕佳選擇。 Humanizer 和 IronPDF 共同可以顯著提升 .NET 應用程序的功能性和展示效果。 如需有關 IronPDF 授權的更多詳細資訊,請參考IronPDF Licensing Information. 如需進一步探索,請查看我們的HTML轉PDF轉換詳細教程.