DateTime.TimeOfDay Propriedade

public:
 property TimeSpan TimeOfDay { TimeSpan get(); };

public TimeSpan TimeOfDay { get; }

member this.TimeOfDay : TimeSpan

Public ReadOnly Property TimeOfDay As TimeSpan

Valor de Propriedade

Um intervalo de tempo que representa a fração do dia que decorreu desde a meia-noite.

Exemplos

O exemplo seguinte mostra o valor da TimeOfDay propriedade para um array de DateTime valores. Também contrasta o valor de retorno com a cadeia devolvida pela cadeia de formato padrão "t" numa operação de formatação composta.

using System;

public class Example
{
   public static void Main()
   {
      DateTime[] dates = { DateTime.Now,
                           new DateTime(2013, 9, 14, 9, 28, 0),
                           new DateTime(2011, 5, 28, 10, 35, 0),
                           new DateTime(1979, 12, 25, 14, 30, 0) };
      foreach (var date in dates) {
         Console.WriteLine("Day: {0:d} Time: {1:g}", date.Date, date.TimeOfDay);
         Console.WriteLine("Day: {0:d} Time: {0:t}\n", date);
      }
   }
}
// The example displays output like the following:
//    Day: 7/25/2012 Time: 10:08:12.9713744
//    Day: 7/25/2012 Time: 10:08 AM
//
//    Day: 9/14/2013 Time: 9:28:00
//    Day: 9/14/2013 Time: 9:28 AM
//
//    Day: 5/28/2011 Time: 10:35:00
//    Day: 5/28/2011 Time: 10:35 AM
//
//    Day: 12/25/1979 Time: 14:30:00
//    Day: 12/25/1979 Time: 2:30 PM

open System

let dates = 
   [ DateTime.Now
     DateTime(2013, 9, 14, 9, 28, 0)
     DateTime(2011, 5, 28, 10, 35, 0)
     DateTime(1979, 12, 25, 14, 30, 0) ]

for date in dates do
   printfn $"Day: {date.Date:d} Time: {date.TimeOfDay:g}"
   printfn $"Day: {date:d} Time: {date:t}\n"

// The example displays output like the following:
//    Day: 7/25/2012 Time: 10:08:12.9713744
//    Day: 7/25/2012 Time: 10:08 AM
//
//    Day: 9/14/2013 Time: 9:28:00
//    Day: 9/14/2013 Time: 9:28 AM
//
//    Day: 5/28/2011 Time: 10:35:00
//    Day: 5/28/2011 Time: 10:35 AM
//
//    Day: 12/25/1979 Time: 14:30:00
//    Day: 12/25/1979 Time: 2:30 PM

Module Example
   Public Sub Main()
      Dim dates() As Date = { Date.Now, 
                              New DateTime(2013, 9, 14, 9, 28, 0),
                              New DateTime(2011, 5, 28, 10, 35, 0),
                              New DateTime(1979, 12, 25, 14, 30, 0) }
      For Each dat In dates
         Console.WriteLine("Day: {0:d} Time: {1:g}", dat.Date, dat.TimeOfDay)
         Console.WriteLine("Day: {0:d} Time: {0:t}", dat)
         Console.WriteLine()
      Next                              
   End Sub
End Module
' The example displays output like the following:
'    Day: 7/25/2012 Time: 10:08:12.9713744
'    Day: 7/25/2012 Time: 10:08 AM
'    
'    Day: 9/14/2013 Time: 9:28:00
'    Day: 9/14/2013 Time: 9:28 AM
'    
'    Day: 5/28/2011 Time: 10:35:00
'    Day: 5/28/2011 Time: 10:35 AM
'    
'    Day: 12/25/1979 Time: 14:30:00
'    Day: 12/25/1979 Time: 2:30 PM

Observações

Ao contrário da Date propriedade, que devolve um DateTime valor que representa uma data sem o seu componente temporal, a TimeOfDay propriedade devolve um TimeSpan valor que representa o componente temporal de um DateTime valor.

Se quiser mostrar a hora do dia ou recuperar a representação da cadeia da hora do dia de um DateTime valor, pode em vez disso chamar uma sobrecarga do ToString método que tem um format parâmetro ou usar a funcionalidade de formatação composta com a cadeia de formato padrão "t" ou "T".

Ver também

• TimeSpan