DateTime objetos em C# são fundamentais para trabalhar com datas e horas em aplicações .NET Framework. Eles fornecem um conjunto robusto de funcionalidades para manipular, formatar e comparar datas e horas.
Este artigo tem como objetivo fornecer uma visão abrangente dos objetos DateTime em C#, cobrindo sua criação, manipulação, formatação e casos de uso comuns. Ao final deste artigo, exploraremos também como o IronPDF da Iron Software pode gerar um documento PDF dinamicamente em aplicações C#.
Criar um objeto DateTime em C# é simples. Há vários construtores disponíveis para inicializar um objeto DateTime com diferentes parâmetros:
// Current date and time
DateTime currentDateTime = DateTime.Now;
// Specific date and time
DateTime specificDateTime = new DateTime(2024, 3, 16, 10, 30, 0);
// Date only
DateTime dateOnly = DateTime.Today;
// Date and time in UTC
DateTime utcDateTime = DateTime.UtcNow;' Current date and time
Dim currentDateTime As DateTime = DateTime.Now
' Specific date and time
Dim specificDateTime As New DateTime(2024, 3, 16, 10, 30, 0)
' Date only
Dim dateOnly As DateTime = DateTime.Today
' Date and time in UTC
Dim utcDateTime As DateTime = DateTime.UtcNowDateTimeObjetos DateTime fornecem vários métodos para manipular datas e horas, como adicionar ou subtrair intervalos de tempo, extrair componentes e converter entre fusos horários.
DateTime now = DateTime.Now;
// Adding days
DateTime futureDate = now.AddDays(7);
// Subtracting hours
DateTime pastTime = now.AddHours(-3);
// Getting components
int year = now.Year;
int month = now.Month;
int day = now.Day;
int hour = now.Hour;
int minute = now.Minute;
int second = now.Second;
// Converting between time zones
DateTime utcTime = DateTime.UtcNow;
DateTime localTime = utcTime.ToLocalTime();Dim now As DateTime = DateTime.Now
' Adding days
Dim futureDate As DateTime = now.AddDays(7)
' Subtracting hours
Dim pastTime As DateTime = now.AddHours(-3)
' Getting components
Dim year As Integer = now.Year
Dim month As Integer = now.Month
Dim day As Integer = now.Day
Dim hour As Integer = now.Hour
Dim minute As Integer = now.Minute
Dim second As Integer = now.Second
' Converting between time zones
Dim utcTime As DateTime = DateTime.UtcNow
Dim localTime As DateTime = utcTime.ToLocalTime()DateTimeObjetos DateTime podem ser formatados em strings usando diversos especificadores de formato para representá-los no formato desejado.
DateTime dateTime = DateTime.Now;
// Standard date and time format
string standardFormat = dateTime.ToString("G");
// Custom format
string customFormat = dateTime.ToString("dd/MM/yyyy HH:mm:ss");
// Format for sorting
string sortableFormat = dateTime.ToString("yyyy-MM-ddTHH:mm:ss");Imports System
Dim dateTime As DateTime = DateTime.Now
' Standard date and time format
Dim standardFormat As String = dateTime.ToString("G")
' Custom format
Dim customFormat As String = dateTime.ToString("dd/MM/yyyy HH:mm:ss")
' Format for sorting
Dim sortableFormat As String = dateTime.ToString("yyyy-MM-ddTHH:mm:ss")DateTimeC# fornece operadores de comparação padrão (<, >, <=, >=, ==, !=) que podem ser usados para comparar dois objetos DateTime diretamente. Esses operadores comparam os ticks subjacentes dos objetos DateTime, que representam o número de intervalos de 100 nanossegundos que se passaram desde 1º de janeiro de 0001, às 00:00:00.000 no calendário gregoriano.
Aqui está um exemplo que demonstra o uso de operadores de comparação:
DateTime date1 = DateTime.Now;
DateTime date2 = DateTime.Now.AddDays(1);
if (date1 < date2)
{
Console.WriteLine("date1 is earlier than date2.");
}
else if (date1 > date2)
{
Console.WriteLine("date1 is later than date2.");
}
else
{
Console.WriteLine("date1 is equal to date2.");
}Dim date1 As DateTime = DateTime.Now
Dim date2 As DateTime = DateTime.Now.AddDays(1)
If date1 < date2 Then
Console.WriteLine("date1 is earlier than date2.")
ElseIf date1 > date2 Then
Console.WriteLine("date1 is later than date2.")
Else
Console.WriteLine("date1 is equal to date2.")
End IfDateTime.Compare em C#Além dos operadores de comparação, objetos DateTime também fornecem métodos para comparação dos valores relativos entre esses objetos. Esses métodos oferecem mais flexibilidade e legibilidade em determinados cenários. O método CompareTo() compara dois objetos DateTime e retorna um valor inteiro indicando se um é anterior, posterior ou igual ao outro.
DateTime date1 = DateTime.Now;
DateTime date2 = DateTime.Now.AddDays(1);
int result = date1.CompareTo(date2);
if (result < 0)
{
Console.WriteLine("date1 is earlier than date2.");
}
else if (result > 0)
{
Console.WriteLine("date1 is later than date2.");
}
else
{
Console.WriteLine("date1 is equal to date2.");
}Dim date1 As DateTime = DateTime.Now
Dim date2 As DateTime = DateTime.Now.AddDays(1)
Dim result As Integer = date1.CompareTo(date2)
If result < 0 Then
Console.WriteLine("date1 is earlier than date2.")
ElseIf result > 0 Then
Console.WriteLine("date1 is later than date2.")
Else
Console.WriteLine("date1 is equal to date2.")
End IfDateTime com TolerânciaPara comparar objetos DateTime, especialmente quando lidando com cálculos envolvendo intervalos de tempo, é importante considerar um nível de tolerância devido a possíveis diferenças de precisão.
Isso pode ser alcançado comparando a diferença absoluta entre dois valores DateTime contra um limite de tolerância pré-definido.
class Program
{
public static void Main()
{
DateTime date1 = DateTime.Now;
DateTime date2 = DateTime.Now.AddMilliseconds(10);
TimeSpan tolerance = TimeSpan.FromMilliseconds(5);
bool isEqual = Math.Abs((date1 - date2).TotalMilliseconds) <= tolerance.TotalMilliseconds;
if (isEqual)
{
Console.WriteLine("date1 is considered equal to date2 within the tolerance.");
}
else
{
Console.WriteLine("date1 is not equal to date2 within the tolerance.");
}
}
}Friend Class Program
Public Shared Sub Main()
Dim date1 As DateTime = DateTime.Now
Dim date2 As DateTime = DateTime.Now.AddMilliseconds(10)
Dim tolerance As TimeSpan = TimeSpan.FromMilliseconds(5)
Dim isEqual As Boolean = Math.Abs((date1.Subtract(date2)).TotalMilliseconds) <= tolerance.TotalMilliseconds
If isEqual Then
Console.WriteLine("date1 is considered equal to date2 within the tolerance.")
Else
Console.WriteLine("date1 is not equal to date2 within the tolerance.")
End If
End Sub
End ClassObjetos DateTime em C# podem representar tanto a hora local quanto a Hora Universal Coordenada (UTC). É importante estar atento às conversões de fuso horário, especialmente ao lidar com aplicativos globais.
DateTime localTime = DateTime.Now;
DateTime utcTime = DateTime.UtcNow;
Console.WriteLine("Local Time: " + localTime);
Console.WriteLine("UTC Time: " + utcTime);Dim localTime As DateTime = DateTime.Now
Dim utcTime As DateTime = DateTime.UtcNow
Console.WriteLine("Local Time: " & localTime)
Console.WriteLine("UTC Time: " & utcTime)IronPDF, da Iron Software, é uma biblioteca eficiente e fácil de usar para geração de PDFs. Você pode instalá-lo usando o gerenciador de pacotes NuGet :
Ou a partir do Visual Studio, como mostrado abaixo:
Agora vamos explorar a geração de PDFs para demonstrar um objeto DateTime.
using IronPdf;
class Program
{
static void Main()
{
Console.WriteLine("-----------Iron Software-------------");
// Create a new instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();
// HTML content for the PDF
var content = "<h1> Iron Software is Awesome </h1> Made with IronPDF!";
content += "<h2>Demo Datetime Objects in C#</h2>";
// Current date and time
content += "<h3>Current date and time</h3>";
DateTime currentDateTime = DateTime.Now;
content += $"<p>Current date and time: {currentDateTime:U}</p>";
Console.WriteLine($"Current date and time: {currentDateTime:U}");
// Specific date and time
content += "<h3>Specific date and time</h3>";
DateTime specificDateTime = new DateTime(2024, 3, 16, 10, 30, 0);
content += $"<p>Specific date and time: {specificDateTime:U}</p>";
Console.WriteLine($"Specific date and time: {specificDateTime:U}");
// Date only
content += "<h3>Date Only</h3>";
DateTime dateOnly = DateTime.Today;
content += $"<p>Date only: {dateOnly:U}</p>";
Console.WriteLine($"Date only: {dateOnly:U}");
// Date and time in UTC
content += "<h3>Date and time in UTC</h3>";
DateTime utcDateTime = DateTime.UtcNow;
content += $"<p>Date and time in UTC: {utcDateTime:U}</p>";
Console.WriteLine($"Date and time in UTC: {utcDateTime:U}");
// Compare dates with Operators
content += "<h3>Compare dates with Operators</h3>";
DateTime date1 = DateTime.Now;
DateTime date2 = DateTime.Now.AddDays(1);
content += $"<p>Compare date1 {date1:d}, date2 {date2:d}: {CompareDates(date1, date2)}</p>";
Console.WriteLine($"Compare date1 {date1:U}, date2 {date2:U}: {CompareDates(date1, date2)}");
// Compare dates with Compare Method
content += "<h3>Compare dates with Compare Method</h3>";
content += $"<p>Compare date1 {date1:d}, date2 {date2:d}: {CompareDatesWithCompare(date1, date2)}</p>";
Console.WriteLine($"Compare date1 {date1:U}, date2 {date2:U}: {CompareDatesWithCompare(date1, date2)}");
// Render the content to PDF
var pdf = renderer.RenderHtmlAsPdf(content);
// Save the PDF to the output file
pdf.SaveAs("outputDate.pdf");
}
// Compare two dates using CompareTo method
public static string CompareDatesWithCompare(DateTime date1, DateTime date2)
{
int result = date1.CompareTo(date2);
string resultString;
if (result < 0)
{
resultString = "date1 is earlier than date2.";
Console.WriteLine(resultString);
}
else if (result > 0)
{
resultString = "date1 is later than date2.";
Console.WriteLine(resultString);
}
else
{
resultString = "date1 is equal to date2.";
Console.WriteLine(resultString);
}
return resultString;
}
// Compare two dates using basic comparison operators
public static string CompareDates(DateTime date1, DateTime date2)
{
string result;
if (CheckLessor(date1, date2))
{
result = "date1 is earlier than date2.";
Console.WriteLine(result);
}
else if (CheckGreater(date1, date2))
{
result = "date1 is later than date2.";
Console.WriteLine(result);
}
else
{
result = "date1 is equal to date2.";
Console.WriteLine(result);
}
return result;
}
// Helper method to check if the first date is greater than the second date
public static bool CheckGreater(DateTime date1, DateTime date2)
{
return date1 > date2;
}
// Helper method to check if the first date is less than the second date
public static bool CheckLessor(DateTime date1, DateTime date2)
{
return date1 < date2;
}
}Imports IronPdf
Class Program
Shared Sub Main()
Console.WriteLine("-----------Iron Software-------------")
' Create a new instance of ChromePdfRenderer
Dim renderer = New ChromePdfRenderer()
' HTML content for the PDF
Dim content = "<h1> Iron Software is Awesome </h1> Made with IronPDF!"
content += "<h2>Demo Datetime Objects in C#</h2>"
' Current date and time
content += "<h3>Current date and time</h3>"
Dim currentDateTime As DateTime = DateTime.Now
content += $"<p>Current date and time: {currentDateTime:U}</p>"
Console.WriteLine($"Current date and time: {currentDateTime:U}")
' Specific date and time
content += "<h3>Specific date and time</h3>"
Dim specificDateTime As New DateTime(2024, 3, 16, 10, 30, 0)
content += $"<p>Specific date and time: {specificDateTime:U}</p>"
Console.WriteLine($"Specific date and time: {specificDateTime:U}")
' Date only
content += "<h3>Date Only</h3>"
Dim dateOnly As DateTime = DateTime.Today
content += $"<p>Date only: {dateOnly:U}</p>"
Console.WriteLine($"Date only: {dateOnly:U}")
' Date and time in UTC
content += "<h3>Date and time in UTC</h3>"
Dim utcDateTime As DateTime = DateTime.UtcNow
content += $"<p>Date and time in UTC: {utcDateTime:U}</p>"
Console.WriteLine($"Date and time in UTC: {utcDateTime:U}")
' Compare dates with Operators
content += "<h3>Compare dates with Operators</h3>"
Dim date1 As DateTime = DateTime.Now
Dim date2 As DateTime = DateTime.Now.AddDays(1)
content += $"<p>Compare date1 {date1:d}, date2 {date2:d}: {CompareDates(date1, date2)}</p>"
Console.WriteLine($"Compare date1 {date1:U}, date2 {date2:U}: {CompareDates(date1, date2)}")
' Compare dates with Compare Method
content += "<h3>Compare dates with Compare Method</h3>"
content += $"<p>Compare date1 {date1:d}, date2 {date2:d}: {CompareDatesWithCompare(date1, date2)}</p>"
Console.WriteLine($"Compare date1 {date1:U}, date2 {date2:U}: {CompareDatesWithCompare(date1, date2)}")
' Render the content to PDF
Dim pdf = renderer.RenderHtmlAsPdf(content)
' Save the PDF to the output file
pdf.SaveAs("outputDate.pdf")
End Sub
' Compare two dates using CompareTo method
Public Shared Function CompareDatesWithCompare(date1 As DateTime, date2 As DateTime) As String
Dim result As Integer = date1.CompareTo(date2)
Dim resultString As String
If result < 0 Then
resultString = "date1 is earlier than date2."
Console.WriteLine(resultString)
ElseIf result > 0 Then
resultString = "date1 is later than date2."
Console.WriteLine(resultString)
Else
resultString = "date1 is equal to date2."
Console.WriteLine(resultString)
End If
Return resultString
End Function
' Compare two dates using basic comparison operators
Public Shared Function CompareDates(date1 As DateTime, date2 As DateTime) As String
Dim result As String
If CheckLessor(date1, date2) Then
result = "date1 is earlier than date2."
Console.WriteLine(result)
ElseIf CheckGreater(date1, date2) Then
result = "date1 is later than date2."
Console.WriteLine(result)
Else
result = "date1 is equal to date2."
Console.WriteLine(result)
End If
Return result
End Function
' Helper method to check if the first date is greater than the second date
Public Shared Function CheckGreater(date1 As DateTime, date2 As DateTime) As Boolean
Return date1 > date2
End Function
' Helper method to check if the first date is less than the second date
Public Shared Function CheckLessor(date1 As DateTime, date2 As DateTime) As Boolean
Return date1 < date2
End Function
End ClassA saída a seguir mostra o PDF gerado com objetos DateTime:
DateTime Objects em C# (Como Funciona para Desenvolvedores): Figura 3
O IronPDF requer uma licença de avaliação para funcionar com todas as suas funcionalidades. Forneça um endereço de e-mail para gerar uma chave de licença que será enviada para o seu e-mail.
"IronPdf.LicenseKey": "<Your Key>"Coloque a chave de licença no arquivo AppSettings.json.
Objetos DateTime em C# fornecem uma maneira poderosa de trabalhar com datas e horas em aplicações .NET. Eles oferecem uma ampla gama de funcionalidades para criar, manipular, formatar e comparar valores de data e hora. Compreender como usar efetivamente objetos DateTime é essencial para construir funcionalidades confiáveis e precisas de data e hora em aplicações C#.
Ao aproveitar as capacidades dos objetos DateTime, os desenvolvedores podem garantir que suas aplicações lidem com datas e horas corretamente, independentemente dos requisitos específicos ou cenários que enfrentem.
Seja calculando durações, agendando tarefas ou exibindo datas e horas para os usuários, objetos DateTime desempenham um papel crucial em muitos aspectos da programação C# relacionados ao gerenciamento de data e hora.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronPDF faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa que seu PDF tenha a aparência de HTML, rapidamente.
