.NET幫助 C# 時間間隔格式 (如何為開發人員運作) Jacob Mellor 更新:2026年1月18日 下載 IronPDF NuGet 下載 DLL 下載 Windows 安裝程式 開始免費試用 LLM副本 LLM副本 將頁面複製為 Markdown 格式,用於 LLMs 在 ChatGPT 中打開 請向 ChatGPT 諮詢此頁面 在雙子座打開 請向 Gemini 詢問此頁面 在 Grok 中打開 向 Grok 詢問此頁面 打開困惑 向 Perplexity 詢問有關此頁面的信息 分享 在 Facebook 上分享 分享到 X(Twitter) 在 LinkedIn 上分享 複製連結 電子郵件文章 在當今快節奏的開發世界中,處理時間間隔對於眾多應用程式至關重要,從專案管理系統到時間追蹤工具。 C# 中的TimeSpan結構提供了一種強大的方法來表示時間間隔,使開發人員能夠更輕鬆地執行計算並有效率地格式化時間資料。 結合IronPDF (一個功能強大的.NET PDF 生成庫),可以根據時間數據建立動態、視覺效果吸引人的報告。 本文將深入探討 C# 中 TimeSpan 的格式化細節,並闡述如何將其與IronPDF無縫集成,以產生富有洞察力的報告。 無論您是追蹤員工工時還是衡量專案工期,本指南都將提供實用範例來增強您的報告能力。 Understanding TimeSpan in C C# 中的 TimeSpan 是什麼? C# 中的 TimeSpan 結構表示時間間隔,可用於測量持續時間或兩個日期和時間值之間的差異。 它是一種用途廣泛的結構,使開發人員能夠執行各種與時間相關的計算,例如: 計算任務持續時間。 測量事件之間的時間差。 建立用於性能測量的計時器。 TimeSpan 的重要性在於它能夠簡化和標準化跨應用程式的時間間隔管理,從而更容易處理各種與時間相關的任務。 建立和使用 TimeSpan 的基本方法 建立TimeSpan物件非常簡單,有多種方法可供使用,例如: TimeSpan.FromHours(double hours):建立一個表示指定小時數的 TimeSpan。 TimeSpan.FromMinutes(double minutes):建立一個表示指定分鐘數的 TimeSpan。 TimeSpan.FromSeconds(double seconds):建立一個表示指定秒數的 TimeSpan。 以下範例說明如何建立 TimeSpan 實例以及如何在計算中使用它們: // Creating TimeSpan instances TimeSpan taskDuration = TimeSpan.FromHours(2.5); // 2 hours and 30 minutes TimeSpan breakDuration = TimeSpan.FromMinutes(15); // 15 minutes // Calculating total time spent TimeSpan totalTime = taskDuration + breakDuration; Console.WriteLine($"Total time spent: {totalTime}"); // Outputs: 02:45:00 // Creating TimeSpan instances TimeSpan taskDuration = TimeSpan.FromHours(2.5); // 2 hours and 30 minutes TimeSpan breakDuration = TimeSpan.FromMinutes(15); // 15 minutes // Calculating total time spent TimeSpan totalTime = taskDuration + breakDuration; Console.WriteLine($"Total time spent: {totalTime}"); // Outputs: 02:45:00 $vbLabelText $csharpLabel 這將顯示以下輸出: 格式化顯示時間跨度 在顯示 TimeSpan 值方面,C# 提供了多種格式化選項。 指定器輸出用於控制將 TimeSpan 值轉換為字串時如何顯示這些值。 這些規格定義了 TimeSpan 物件的輸出格式,有助於自訂它們在最終 PDF 報表中的表示形式。 最常用的格式說明符包括: "c":不變格式(例如,1.02:30:45 表示 1 天 2 小時 30 分鐘 45 秒)。 "g":標準格式說明符,如果日期部分為零,則排除日期部分(例如,02:30:45)。 *自訂格式:您可以定義自訂格式以滿足特定需求,例如僅顯示小時和分鐘或日期和小時。 以下是在報表或日誌中格式化 TimeSpan 的範例: TimeSpan duration = new TimeSpan(1, 2, 30, 45); // 1 day, 2 hours, 30 minutes, 45 seconds // Default "c" format string produces the output: 1.02:30:45 Console.WriteLine(duration.ToString("c")); // Custom format "hh:mm:ss" outputs: 26:30:45 Console.WriteLine(duration.ToString(@"hh\:mm\:ss")); // Custom format with days, outputs: 1d 02h 30m Console.WriteLine(duration.ToString(@"d'd 'hh'h 'mm'm '")); TimeSpan duration = new TimeSpan(1, 2, 30, 45); // 1 day, 2 hours, 30 minutes, 45 seconds // Default "c" format string produces the output: 1.02:30:45 Console.WriteLine(duration.ToString("c")); // Custom format "hh:mm:ss" outputs: 26:30:45 Console.WriteLine(duration.ToString(@"hh\:mm\:ss")); // Custom format with days, outputs: 1d 02h 30m Console.WriteLine(duration.ToString(@"d'd 'hh'h 'mm'm '")); $vbLabelText $csharpLabel 此範例顯示以下輸出: 使用 TimeSpan 和IronPDF產生 PDF 在.NET專案中設定IronPDF 要開始使用IronPDF ,您首先需要安裝它。 如果已經安裝了 IronPDF 庫,則可以跳到下一節;否則,以下步驟將介紹如何安裝IronPDF庫。 透過NuGet套件管理器控制台 若要使用NuGet套件管理器主控台安裝IronPDF ,請開啟 Visual Studio 並導覽至套件管理員主控台。 然後運行以下命令: Install-Package IronPdf 透過NuGet套件管理器取得解決方案 開啟 Visual Studio,前往"工具 -> NuGet套件管理員 -> 管理解決方案的NuGet套件",然後搜尋IronPDF。 接下來,您只需選擇您的項目並點擊"安裝", IronPDF就會添加到您的專案中。 安裝IronPDF後,您只需在程式碼頂部新增正確的 using 語句即可開始使用IronPDF : using IronPdf; using IronPdf; $vbLabelText $csharpLabel 現在您已準備好使用IronPDF和 TimeSpan 來執行 PDF 生成任務。 使用IronPDF產生基於時間的報告 IronPDF設定完成後,您可以使用 TimeSpan 數據產生資訊豐富的 PDF 報告。 例如,假設你需要為員工產生工作日誌。 您可以利用 TimeSpan 值有效地顯示任務持續時間和休息時間。 範例場景:在 PDF 報表中設定時間跨度值的格式 以下是如何在 PDF 報告中使用 TimeSpan 數據,包括產生簡單的工作日誌: using IronPdf; public static void Main(string[] args) { TimeSpan duration = new TimeSpan(9, 30, 25); var employees = new List<(string name, TimeSpan timeSpan)> { ("Jane Doe", duration), ("John Doe", duration) }; GenerateWorkLogReport(employees); } public static void GenerateWorkLogReport(List<(string Employee, TimeSpan Duration)> workLogs) { ChromePdfRenderer renderer = new ChromePdfRenderer(); var htmlContent = "<h1>Work Log Report</h1><table border='1'><tr><th>Employee</th><th>Duration</th></tr>"; foreach (var log in workLogs) { htmlContent += $"<tr><td>{log.Employee}</td><td>{log.Duration.ToString(@"hh\:mm\:ss")}</td></tr>"; } htmlContent += "</table>"; var pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("WorkLogReport.pdf"); } using IronPdf; public static void Main(string[] args) { TimeSpan duration = new TimeSpan(9, 30, 25); var employees = new List<(string name, TimeSpan timeSpan)> { ("Jane Doe", duration), ("John Doe", duration) }; GenerateWorkLogReport(employees); } public static void GenerateWorkLogReport(List<(string Employee, TimeSpan Duration)> workLogs) { ChromePdfRenderer renderer = new ChromePdfRenderer(); var htmlContent = "<h1>Work Log Report</h1><table border='1'><tr><th>Employee</th><th>Duration</th></tr>"; foreach (var log in workLogs) { htmlContent += $"<tr><td>{log.Employee}</td><td>{log.Duration.ToString(@"hh\:mm\:ss")}</td></tr>"; } htmlContent += "</table>"; var pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("WorkLogReport.pdf"); } $vbLabelText $csharpLabel 在這個範例中,我們建立了一個簡單的表格來顯示員工的工作日誌。 GenerateWorkLogReport方法會產生一個包含格式化 TimeSpan 值的 HTML 表格,然後將其轉換為 PDF 文件。 我們使用 IronPDF 的ChromePdfRenderer類別來處理 HTML 內容到 PDF 格式的渲染。 PdfDocument用於建立 PDF 對象,該對像用於處理新建立的 PDF 並保存它。 報表中時間跨度格式設定和使用的進階技巧 針對不同使用場景自訂時間跨度輸出 自訂 TimeSpan 輸出可以顯著提高報告的可讀性。 例如,如果您只需要顯示小時和分鐘,您可以相應地設定 TimeSpan 的格式。 在這個例子中,我們將使用我們在上一個範例中建立的相同的員工數據,並將 TimeSpan 格式化為僅顯示他們工作的小時和分鐘。 在這種情況下,秒數對於記錄來說並非必要,只會佔用不必要的空間,所以我們會將其格式化掉: using IronPdf; class Program { public static void Main(string[] args) { TimeSpan duration = new TimeSpan(9, 30, 25); var employees = new List<(string name, TimeSpan timeSpan)> { ("Jane Doe", duration), ("John Doe", duration) }; GenerateWorkLogReport(employees); } public static void GenerateWorkLogReport(List<(string Employee, TimeSpan Duration)> workLogs) { ChromePdfRenderer renderer = new ChromePdfRenderer(); var htmlContent = "<h1>Work Log Report</h1><table border='1'><tr><th>Employee</th><th>Duration</th></tr>"; foreach (var log in workLogs) { // Custom format string to format the TimeSpan value for display string formattedDuration = log.Duration.ToString(@"hh\:mm"); htmlContent += $"<tr><td>{log.Employee}</td><td>{formattedDuration}</td></tr>"; } htmlContent += "</table>"; var pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("WorkLogReport.pdf"); } } using IronPdf; class Program { public static void Main(string[] args) { TimeSpan duration = new TimeSpan(9, 30, 25); var employees = new List<(string name, TimeSpan timeSpan)> { ("Jane Doe", duration), ("John Doe", duration) }; GenerateWorkLogReport(employees); } public static void GenerateWorkLogReport(List<(string Employee, TimeSpan Duration)> workLogs) { ChromePdfRenderer renderer = new ChromePdfRenderer(); var htmlContent = "<h1>Work Log Report</h1><table border='1'><tr><th>Employee</th><th>Duration</th></tr>"; foreach (var log in workLogs) { // Custom format string to format the TimeSpan value for display string formattedDuration = log.Duration.ToString(@"hh\:mm"); htmlContent += $"<tr><td>{log.Employee}</td><td>{formattedDuration}</td></tr>"; } htmlContent += "</table>"; var pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("WorkLogReport.pdf"); } } $vbLabelText $csharpLabel 在這個例子中, ToString(@"hh\:mm")使用自訂格式字串將 TimeSpan 格式化為 09:30(總小時數和分鐘數)。 透過這種方式,您可以確保以您想要的方式顯示時間跨度,同時保持文件的可讀性。 也可以反過來,透過將字串解析為 TimeSpan 來實現。 解析將遵循特定格式(例如"hh:mm"或"d.hh:mm")的輸入字串轉換為 C# 可以以程式設計方式操作的實際TimeSpan物件。 處理大時間間隔並進行可讀性格式化 處理較大的 TimeSpan 值時,為了方便閱讀,對其進行格式化非常重要。 例如,您可以將較長的持續時間轉換為更易於理解的格式,例如"3天5小時": class Program { public static void Main(string[] args) { // Sample data: List of employee names and their work durations (TimeSpan) var workLogs = new List<(string Employee, TimeSpan Duration)> { ("Alice", new TimeSpan(5, 30, 0)), // 5 hours, 30 minutes ("Bob", new TimeSpan(3, 15, 0)), // 3 hours, 15 minutes ("Charlie", new TimeSpan(7, 45, 0)) // 7 hours, 45 minutes }; // Create the HTML content for the PDF report string htmlContent = @" <h1>Work Log Report</h1> <table border='1' cellpadding='5' cellspacing='0'> <tr> <th>Employee</th> <th>Work Duration (hh:mm)</th> </tr>"; // Loop through the work logs and add rows to the table foreach (var log in workLogs) { string formattedDuration = FormatLargeTimeSpan(log.Duration); // Custom method to format large TimeSpan values htmlContent += $"<tr><td>{log.Employee}</td><td>{formattedDuration}</td></tr>"; } // Close the HTML table htmlContent += "</table>"; // Create a new HtmlToPdf renderer ChromePdfRenderer renderer = new ChromePdfRenderer(); // Render the HTML content as a PDF PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); // Save the PDF to a file pdf.SaveAs("WorkLogReport.pdf"); } // Custom method to handle the formatting operation static string FormatLargeTimeSpan(TimeSpan timeSpan) { // Check if there are days in the TimeSpan and format accordingly if (timeSpan.TotalDays >= 1) { return string.Format("{0} days, {1} hours, {2} minutes", (int)timeSpan.TotalDays, timeSpan.Hours, timeSpan.Minutes); } else { // If the duration is less than a day, show only hours and minutes return string.Format("{0} hours, {1} minutes", timeSpan.Hours, timeSpan.Minutes); } } } class Program { public static void Main(string[] args) { // Sample data: List of employee names and their work durations (TimeSpan) var workLogs = new List<(string Employee, TimeSpan Duration)> { ("Alice", new TimeSpan(5, 30, 0)), // 5 hours, 30 minutes ("Bob", new TimeSpan(3, 15, 0)), // 3 hours, 15 minutes ("Charlie", new TimeSpan(7, 45, 0)) // 7 hours, 45 minutes }; // Create the HTML content for the PDF report string htmlContent = @" <h1>Work Log Report</h1> <table border='1' cellpadding='5' cellspacing='0'> <tr> <th>Employee</th> <th>Work Duration (hh:mm)</th> </tr>"; // Loop through the work logs and add rows to the table foreach (var log in workLogs) { string formattedDuration = FormatLargeTimeSpan(log.Duration); // Custom method to format large TimeSpan values htmlContent += $"<tr><td>{log.Employee}</td><td>{formattedDuration}</td></tr>"; } // Close the HTML table htmlContent += "</table>"; // Create a new HtmlToPdf renderer ChromePdfRenderer renderer = new ChromePdfRenderer(); // Render the HTML content as a PDF PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); // Save the PDF to a file pdf.SaveAs("WorkLogReport.pdf"); } // Custom method to handle the formatting operation static string FormatLargeTimeSpan(TimeSpan timeSpan) { // Check if there are days in the TimeSpan and format accordingly if (timeSpan.TotalDays >= 1) { return string.Format("{0} days, {1} hours, {2} minutes", (int)timeSpan.TotalDays, timeSpan.Hours, timeSpan.Minutes); } else { // If the duration is less than a day, show only hours and minutes return string.Format("{0} hours, {1} minutes", timeSpan.Hours, timeSpan.Minutes); } } } $vbLabelText $csharpLabel 在這個例子中,自訂方法FormatLargeTimeSpan將較大的 TimeSpan 值轉換為易於閱讀的格式,例如"6 天 5 小時 30 分鐘"。它會檢查 TimeSpan 值是否包含天,並根據情況使用支援複合格式的方法格式化輸出。 如果總時長超過 24 小時,則提取日期並與剩餘的小時和分鐘一起顯示。 對於少於一天的時間間隔,只顯示小時和分鐘。 為什麼選擇IronPDF來產生基於時間跨度的 PDF 檔案? IronPDF在報表應用上的主要優勢 IronPDF 的突出特點在於其強大的功能,能夠根據字串、時間和 HTML 資料產生動態 PDF。 使用IronPDF,處理 PDF 相關任務將變得輕而易舉。 從基本的 PDF 產生到安全的 PDF 加密, IronPDF都能滿足您的需求。 主要優勢包括: HTML 轉 PDF:輕鬆將HTML 內容轉換為 PDF,同時保持佈局和設計。 IronPDF還可以處理將許多其他文件類型轉換為 PDF,包括DOCX 、圖像、 URL和ASPX 。 *自訂選項:*使用自訂範本和格式自訂報告以滿足特定的業務需求,為您的 PDF 文件添加專業外觀的頁首和頁尾、目錄,甚至自訂背景。 像素級完美 PDF:** IronPDF 對現代網絡標準的強大支持,能夠生成與您的品牌視覺一致的高質量 PDF 文檔,即使是從網絡內容生成的 PDF 也能始終保持像素級完美。 與.NET和 TimeSpan 格式的無縫集成 IronPDF與.NET應用程式無縫集成,使開發人員能夠有效地利用 TimeSpan 結構。 使用IronPDF,您可以輕鬆產生包含格式化時間資料的專業報告,讓您的報告流程有效率且簡單。 結論 在本文中,我們探討如何在 C# 中格式化和處理TimeSpan值,並將其無縫整合到IronPDF中以產生基於時間的動態報告。 C# TimeSpan 格式結構是表示時間間隔(例如專案持續時間、工作日誌和任務完成時間)的重要工具。 無論處理的是短時間跨度還是跨越數天、數小時和數分鐘的大時間間隔,C# 都提供了靈活的格式化選項,以人類可讀的格式呈現這些數據。 更進階的範例可能包括遵循文化格式約定、取得時間輸入、將字串解析為 TimeSpan 等等。 IronPDF能夠精確地將 HTML 轉換為 PDF,是產生資料驅動型應用程式報告的理想工具。 它與 C# 的整合使得將 TimeSpan 等複雜結構融入高品質 PDF 變得容易。 現在您已經了解如何使用IronPDF格式化 TimeSpan 值並將其整合到 PDF 報告中,是時候進行下一步了。下載IronPDF免費試用版,探索其在為您的專案產生動態、數據驅動型報告方面的全部潛力。 使用IronPDF,您可以輕鬆將基於時間的資料轉換為精美專業的文件。 常見問題解答 怎樣在 C# 中將 HTML 轉換為 PDF? 您可以使用 IronPDF 的 RenderHtmlAsPdf 方法將 HTML 字符串轉換為 PDF。您還可以使用 RenderHtmlFileAsPdf 將 HTML 文件轉換為 PDF。 C# 中的 TimeSpan 結構用於什麼? C# 中的 TimeSpan 結構用於表示時間間隔。它簡化了測量持續時間、計算時間差等任務,並可以與 IronPDF 等 PDF 生成庫集成來創建詳細的基於時間的報告。 如何格式化 TimeSpan 對象以包含在 PDF 報告中? 要格式化用於包含在 PDF 報告中的 TimeSpan 對象,可以使用多種格式字符串,如 "c"、"g" 或自定義格式。一旦格式化,時間數據可以使用 IronPDF 渲染成 PDF。 生成 PDF 報告時,我可以自定義 TimeSpan 的輸出嗎? 是的,您可以使用格式字符串自定義 TimeSpan 的輸出以滿足特定報告需求,例如僅顯示小時和分鐘。 IronPDF 允許這些自定義格式字符串無縫整合到 PDF 報告中。 如何將 PDF 生成庫與 C# 中的 TimeSpan 集成? 要將 PDF 生成庫(如 IronPDF)與 C# 中的 TimeSpan 集成,您首先要根據需要格式化 TimeSpan 數據,然後使用 IronPDF 將這些數據與其他內容一起轉換為 PDF 文檔。 在 .NET 項目中安裝 PDF 生成庫的步驟有哪些? 要在 .NET 項目中安裝 PDF 生成庫,您可以在 Visual Studio 的 NuGet 包管理器控制台中執行適當的安裝命令,或利用解決方案的 NuGet 包管理器來添加庫。 如何處理大型 TimeSpan 值以提高 PDF 報告的可讀性? 對於大型 TimeSpan 值,您可以通過將它們轉換為如「3 天 5 小時」這樣的人性化字符串來提高可讀性。 IronPDF 允許您在 PDF 報告中包含這些格式化的字符串,以提高展示效果。 使用 PDF 生成庫創建報告有哪些優勢? 像 IronPDF 的 PDF 生成庫提供了許多優勢,例如能將 HTML 轉換為 PDF、應用自定義模板,以及生成高質量、外觀專業的報告,保持視覺的一致性。 Jacob Mellor 立即與工程團隊聊天 首席技術官 Jacob Mellor是Iron Software的首席技術官,也是開創C# PDF技術的前瞻性工程師。作為Iron Software核心代碼庫的原始開發者,他自公司成立以來就塑造了公司的產品架構,並與CEO Cameron Rimington將公司轉型為服務NASA、Tesla以及全球政府機構的50多人公司。Jacob擁有曼徹斯特大學土木工程一級榮譽學士學位(1998年–2001年)。他於1999年在倫敦開立首家軟體公司,並於2005年建立了他的第一個.NET組件,專注於解決Microsoft生態系統中的複雜問題。他的旗艦作品IronPDF和Iron Suite .NET程式庫全球已獲得超過3000萬次NuGet安裝,他的基礎代碼不斷在全球各地驅動開發者工具。擁有25年以上的商業經驗和41年的編碼專業知識,Jacob仍然專注於推動企業級C#、Java和Python PDF技術的創新,同時指導下一代技術領導者。 相關文章 更新2026年2月20日 銜接 CLI 簡化與 .NET : 使用 Curl DotNet 與 IronPDF for .NET Jacob Mellor 藉由 CurlDotNet 彌補了這方面的不足,CurlDotNet 是為了讓 .NET 生態系統能熟悉 cURL 而建立的函式庫。 閱讀更多 更新2025年12月20日 RandomNumberGenerator C# 使用RandomNumberGenerator C#類可以幫助將您的PDF生成和編輯項目提升至新水準 閱讀更多 更新2025年12月20日 C#字符串等於(它如何對開發者起作用) 當結合使用強大的PDF庫IronPDF時,開關模式匹配可以讓您構建更智能、更清晰的邏輯來進行文檔處理 閱讀更多 C#非同步等待(開發者如何理解其工作)解析C#(開發者如何理解其...
更新2026年2月20日 銜接 CLI 簡化與 .NET : 使用 Curl DotNet 與 IronPDF for .NET Jacob Mellor 藉由 CurlDotNet 彌補了這方面的不足,CurlDotNet 是為了讓 .NET 生態系統能熟悉 cURL 而建立的函式庫。 閱讀更多