No namespace System temos uma estrutura chamada System.DateTime. Para realizar operações com valores de data e hora utilizamos os campos, propriedades e métodos desta estrutura. A estrutura System.DateTime é bastante flexível. Só para se ter uma idéia, existem sete construtores diferentes para este estrutura.

Vamos apresentar um exemplo onde utilizamos os principais construtores da estrutura System.DateTime. Considere o exemplo da Listagem 5.4

using System;

class ex4cap5
{
                   // Exemplo 4 - Capítulo 5.
                   // Construtores de System.DateTime.
                   // Por: Júlio Battisti
                   // MCP, MCP+I, MCSE, MCSE+I, MCSE, MCDBA

 public static void Main()
 {

 // Utilização de diversos construtores de System.DateTime.

 DateTime constrex1 = new DateTime(2001,7,21);
                   DateTime constrex2 = new DateTime(0);
                   DateTime constrex3 = new DateTime(2001,7,21,16,30,45);
   
                   //Exibição dos resultados
                 

 Console.WriteLine("****************************************");
                   Console.WriteLine("DATA E HORA ATUAIS           -> {0}",DateTime.Now);
                   Console.WriteLine("CONSTRUTOR -dia,mês,ano      -> {0}",constrex1);
                   Console.WriteLine("CONSTRUTOR -milisegundos     -> {0}",constrex2);
                   Console.WriteLine("CONSTRUTOR -d,m,a,h,min,seg  -> {0}",constrex3); 
                   Console.WriteLine("****************************************");

 }
}

Listagem 5.4 – Construtores de System.DateTime – ex4cap5.cs

Digite o exemplo da listagem 5.4 e salve o mesmo em um arquivo chamado ex4cap5.cs, na pasta C:\ExCsharp\cap5. Compile e execute o exemplo da listagem 5.4. Você obterá os resultados indicados na Figura 5.4.

Figura 5.4 Executando o programa ex4cap5.exe.

Neste exemplo utilizamos os três construtores mais utilizados. Observe o código a seguir:

 DateTime constrex1 = new DateTime(2001,7,21);

Neste exemplo estamos utilizando um construtor onde são passados três valores: ano, mês e dia. Os valores para hora, minuto e segundo são inicializados com zero, conforme pode ser confirmado na Figura 5.4.

 DateTime constrex2 = new DateTime(0);

Neste exemplo utilizamos um construtor onde passamos, com único parâmetro, o número de milisegundos a partir da menor data suportada pelo Framework .NET. Como passamos um valor zero, o mesmo irá exibir a menor data possível, que conforme podemos confirmar pela saída do programa, é: 1/1/0001 00:00:00.

 DateTime constrex3 = new DateTime(2001,7,21,16,30,45);

Neste exemplo utilizamos um construtor onde são passados seis valores: ano, mês, dia, hora, minuto e segundo.

Campos da estrutura System.DateTime.

A estrutura DateTime tem dois campos:

• DateTime.MaxValue: Este campo retorna o valor da maior data/hora suportada pela estrutura DateTime. O valor retornado é: 31/12/9999 23:59:59, para o sistema de Data/Hora do Brasil.
• DateTime.MinValue: Este campo retorna o valor da menor data/hora suportada pela estrutura DateTime. O valor retornado é: 1/1/0001 00:00:00, para o sistema de Data/Hora do Brasil.

Propriedades da estrutura System.DateTime.

Na Tabela 5.1 temos a descrição das propriedades da estrutura System.DateTime:

Tabela 5.1 Propriedades da estrutura System.DateTime

Vamos apresentar um exemplo onde utilizamos as propriedades da estrutura System.DateTime.

Considere o exemplo da Listagem 5.5

using System;

class ex5cap5
{
                   // Exemplo 5 - Capítulo 5.
                   // Propriedades de System.Date.
                   // Por: Júlio Battisti
                   // MCP, MCP+I, MCSE, MCSE+I, MCSE, MCDBA

 public static void Main()
 {

 // Utilização de diversos construtores de System.DateTime.

 DateTime constrex1 = DateTime.Now;
                     
                   //Exibição dos resultados
                 

 Console.WriteLine("****************************************");
                   Console.WriteLine("HORA DO SISTEMA                 	-> {0}",constrex1.Hour);
                   Console.WriteLine("MINUTO DO SISTEMA               -> {0}",constrex1.Minute);
                   Console.WriteLine("SEGUNDOS DO SISTEMA          -> {0}",constrex1.Second);
                   Console.WriteLine("ANO DO SISTEMA                   	-> {0}",constrex1.Year);
                   Console.WriteLine("MÊS DO SISTEMA                   	-> {0}",constrex1.Month);
                   Console.WriteLine("DIA DO SISTEMA                   	-> {0}",constrex1.Day);
                   Console.WriteLine("DATA COMPLETA 		-> {0}",constrex1.Date);
                   Console.WriteLine("DIA DA SEMANA               -> {0}",constrex1.DayOfWeek);
                   Console.WriteLine("DIA DO ANO                       -> {0}",constrex1.DayOfYear);

 }
}                 

Listagem 5.5 – Propriedades de System.DateTime – ex5cap5.cs

Digite o exemplo da listagem 5.5 e salve o mesmo em um arquivo chamado ex5cap5.cs, na pasta C:\ExCsharp\cap5. Compile e execute o exemplo da listagem 5.5. Você obterá os resultados indicados na Figura 5.5.

Figura 5.5 Executando o programa ex5cap5.exe.