C# TimeSpan Format (Geliştiriciler İçin Nasıl Çalışır)

C#'ta TimeSpan Nedir?

C#'ta TimeSpan yapısı bir zaman aralığını temsil eder ve süreleri veya iki tarih ve saat değeri arasındaki farkı ölçmek için kullanılabilir. Bu, geliştiricilerin görev sürelerini hesaplama, olaylar arasındaki zaman farklarını ölçme, performans ölçümü için zamanlayıcılar oluşturma gibi çeşitli zamanla ilgili hesaplamaları gerçekleştirmesini sağlayan çok yönlü bir yapıdır.

• Görevlerin süresini hesaplamak.
• Olaylar arasındaki zaman farklarını ölçmek.
• Performans ölçümü için zamanlayıcılar oluşturmak.

TimeSpan'in önemi, uygulamalar arasında zaman aralığı yönetimini basitleştirip standart hale getirme yeteneğinde yatar, böylece çeşitli zamanla ilgili görevleri ele almak daha kolay hale gelir.

TimeSpan Oluşturma ve Kullanma için Temel Yöntemler

TimeSpan nesnesi oluşturmak basittir, çeşitli yöntemler mevcuttur, örneğin:

• TimeSpan.FromHours(double hours): Belirtilen saat sayısını temsil eden bir TimeSpan oluşturur.
• TimeSpan.FromMinutes(double minutes): Belirtilen dakika sayısını temsil eden bir TimeSpan oluşturur.
• TimeSpan.FromSeconds(double seconds): Belirtilen saniye sayısını temsil eden bir TimeSpan oluşturur.

İşte TimeSpan örneklerini nasıl oluşturabileceğinizi ve hesaplamalarda nasıl kullanabileceğinizi gösteren bir örnek:

// 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

' Creating TimeSpan instances
Dim taskDuration As TimeSpan = TimeSpan.FromHours(2.5) ' 2 hours and 30 minutes
Dim breakDuration As TimeSpan = TimeSpan.FromMinutes(15) ' 15 minutes
' Calculating total time spent
Dim totalTime As TimeSpan = taskDuration.Add(breakDuration)
Console.WriteLine($"Total time spent: {totalTime}") ' Outputs: 02:45:00

Bu, aşağıdaki çıktıyı görüntüler:

Görüntüleme için TimeSpan Biçimlendirme

TimeSpan değerlerini görüntülemek söz konusu olduğunda, C# çeşitli biçimlendirme seçenekleri sunar. Özelleştirme çıktıları, TimeSpan değerlerinin dizelere dönüştürülürken nasıl görüneceğini kontrol etmek için kullanılır. Bu belirteçler, TimeSpan nesnelerinin çıkış formatını tanımlar, son PDF raporunda onların temsilini özelleştirmeye yardımcı olur. En çok kullanılan format belirteçleri arasında:

• "c": Değişmez format (ör. 1.02:30:45, 1 gün, 2 saat, 30 dakika ve 45 saniye için).
• "g": Standart format belirteci, gün kısmı sıfırsa dahil etmez (ör. 02:30:45).
• Özel biçimler: Saatler ve dakikaları ya da günlerle saatleri sadece görüntülemek gibi özel gereksinimleri karşılamak için özel biçimler tanımlayabilirsiniz.

İşte raporlarda veya günlüklerde çıktı için TimeSpan'in nasıl biçimlendirileceğine dair örnekler:

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 '"));

Dim duration As 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 '"))

Bu örnek aşağıdaki çıktıyı görüntüler:

.NET Projenizde IronPDF'i Kurmak

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

IronPDF ile Zaman Tabanlı Raporlar Oluşturma

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");
}

Imports IronPdf
Public Shared Sub Main(ByVal args() As String)
	Dim duration As New TimeSpan(9, 30, 25)
	Dim employees = New List(Of (name As String, timeSpan As TimeSpan)) From {("Jane Doe", duration), ("John Doe", duration)}
	GenerateWorkLogReport(employees)
End Sub
Public Shared Sub GenerateWorkLogReport(ByVal workLogs As List(Of (Employee As String, Duration As TimeSpan)))
	Dim renderer As New ChromePdfRenderer()
	Dim htmlContent = "<h1>Work Log Report</h1><table border='1'><tr><th>Employee</th><th>Duration</th></tr>"
	For Each log In workLogs
		htmlContent &= $"<tr><td>{log.Employee}</td><td>{log.Duration.ToString("hh\:mm\:ss")}</td></tr>"
	Next log
	htmlContent &= "</table>"
	Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
	pdf.SaveAs("WorkLogReport.pdf")
End Sub

Farklı Kullanım Durumları için TimeSpan Çıktısını Özelleştirme

TimeSpan çıktısını özelleştirmek, raporlarınızın okunabilirliğini önemli ölçüde artırabilir. Örneğin, sadece saat ve dakikayı göstermeniz gerekiyorsa, TimeSpan'inizi buna göre biçimlendirebilirsiniz. Bu örnekte, önceki örnekte oluşturduğumuz aynı çalışan verilerini alacağız ve çalışanların çalıştığı saat ve dakikaları sadece göstermek için TimeSpan'i biçimlendireceğiz. Bu senaryoda saniyeler kayıtlar için gerekli değildir ve sadece gereksiz yer kapladığı için onları biçim dışı bırakacağız:

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");
    }
}

Imports IronPdf
Friend Class Program
	Public Shared Sub Main(ByVal args() As String)
		Dim duration As New TimeSpan(9, 30, 25)
		Dim employees = New List(Of (name As String, timeSpan As TimeSpan)) From {("Jane Doe", duration), ("John Doe", duration)}
		GenerateWorkLogReport(employees)
	End Sub
	Public Shared Sub GenerateWorkLogReport(ByVal workLogs As List(Of (Employee As String, Duration As TimeSpan)))
		Dim renderer As New ChromePdfRenderer()
		Dim htmlContent = "<h1>Work Log Report</h1><table border='1'><tr><th>Employee</th><th>Duration</th></tr>"
		For Each log In workLogs
			' Custom format string to format the TimeSpan value for display
			Dim formattedDuration As String = log.Duration.ToString("hh\:mm")
			htmlContent &= $"<tr><td>{log.Employee}</td><td>{formattedDuration}</td></tr>"
		Next log
		htmlContent &= "</table>"
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
		pdf.SaveAs("WorkLogReport.pdf")
	End Sub
End Class

Bu örnekte, ToString(@"hh\:mm") yönteminde TimeSpan, özel format dizeleri kullanılarak 09:30 (toplam saat ve dakika) olarak biçimlendirilir. Bu sayede, belgenin okunabilirliğini korumak için TimeSpan'inizin istediğiniz gibi görüntülenmesini sağlayabilirsiniz. Bu aynı zamanda tersine de yapılabilir, bir dizgiyi bir TimeSpan'e ayırarak. Ayırma, belirli bir formata uyan giriş dizelerini ("hh:mm" veya "d.hh:mm" gibi) C#'ın programlı olarak çalışabileceği gerçek bir TimeSpan nesnesine dönüştürür.

Geniş Zaman Aralıklarını Yönetme ve Okunabilirlik için Biçimlendirme

Daha geniş TimeSpan değerleriyle uğraşırken, okunabilirlik için onları biçimlendirmek önemlidir. Örneğin, uzun süreleri daha anlaşılır bir formata dönüştürebilirsiniz, "3 gün, 5 saat" gibi:

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);
        }
    }
}

Imports System

Friend Class Program
	Public Shared Sub Main(ByVal args() As String)
		' Sample data: List of employee names and their work durations (TimeSpan)
		Dim workLogs = New List(Of (Employee As String, Duration As TimeSpan)) From {("Alice", New TimeSpan(5, 30, 0)), ("Bob", New TimeSpan(3, 15, 0)), ("Charlie", New TimeSpan(7, 45, 0))}
		' Create the HTML content for the PDF report
		Dim htmlContent As String = "
            <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
		For Each log In workLogs
			Dim formattedDuration As String = FormatLargeTimeSpan(log.Duration) ' Custom method to format large TimeSpan values
			htmlContent &= $"<tr><td>{log.Employee}</td><td>{formattedDuration}</td></tr>"
		Next log
		' Close the HTML table
		htmlContent &= "</table>"
		' Create a new HtmlToPdf renderer
		Dim renderer As New ChromePdfRenderer()
		' Render the HTML content as a PDF
		Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
		' Save the PDF to a file
		pdf.SaveAs("WorkLogReport.pdf")
	End Sub
	' Custom method to handle the formatting operation
	Private Shared Function FormatLargeTimeSpan(ByVal timeSpan As TimeSpan) As String
		' Check if there are days in the TimeSpan and format accordingly
		If timeSpan.TotalDays >= 1 Then
			Return String.Format("{0} days, {1} hours, {2} minutes", CInt(Math.Truncate(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)
		End If
	End Function
End Class

Bu örnekte, özel FormatLargeTimeSpan yöntemi, büyük TimeSpan değerlerini kolayca okunabilir formatlara dönüştürür, "6 gün, 5 saat, 30 dakika" gibi. TimeSpan değerinin gün içerip içermediğini kontrol eder ve çıkışı buna göre biçimlendirir, bileşik formatlamayı destekleyen yöntemleri kullanarak.

• Toplam süre 24 saati aşarsa, günler çıkarılır ve artakalan saat ve dakikalarla birlikte görüntülenir.
• Bir günden az aralıklar için sadece saat ve dakikalar gösterilir.

Raporlama Uygulamaları için IronPDF'in Ana Faydaları

IronPDF, dize, zaman ve HTML verilerine dayalı dinamik PDF'ler oluşturmadaki sağlam özellikleriyle öne çıkar. IronPDF ile ilgili PDF görevlerinizi yönetmek çok daha kolay hale gelecektir. Temel PDF oluşturma işlemlerinden güvenli PDF şifrelemeye kadar, IronPDF sizi kapsar. Bazı önemli faydalar arasında:

• HTML'den PDF'ye Dönüşüm: HTML içeriğini kolayca PDF'ye çevirin, sayfa düzeni ve tasarımı koruyarak. IronPDF aynı zamanda birçok başka dosya türünü PDF'ye dönüştürme işlemlerini de yürütmektedir, DOCX, görüntü, URL ve ASPX dahil olmak üzere.
• Özelleştirme Seçenekleri: Özel şablonlar ve formatlama ile raporları belirli iş ihtiyaçlarını karşılamak üzere özelleştirin, PDF dosyalarınıza profesyonel görünümde üstbilgi ve altbilgi, bir içindekiler tablosu veya hatta özel arka planlar verin.
• Piksel Mükemmelliğinde PDF'ler: IronPDF'in çağdaş web standartlarını güçlü bir şekilde desteklemesi sayesinde, web içeriğinden oluşturulan PDF'ler bile sürekli piksel mükemmelliğiyle çıkacaktır, markanıza görsel olarak tutarlı yüksek kaliteli PDF belgeleri oluşturun.

.NET ve TimeSpan Biçimlendirme ile Sorunsuz Entegrasyon

IronPDF, geliştiricilerin TimeSpan yapısını etkili bir şekilde kullanmalarına olanak tanıyan .NET uygulamaları ile sorunsuz entegre olur. IronPDF ile biçimlendirilmiş zaman verilerini içeren profesyonel raporlar oluşturabilir ve bu sayede raporlama sürecinizi verimli ve basit hale getirebilirsiniz.