Compartilhar via


DateTime.TimeOfDay Propriedade

Definição

Obtém a hora do dia para esta instância.

public:
 property TimeSpan TimeOfDay { TimeSpan get(); };
public TimeSpan TimeOfDay { get; }
member this.TimeOfDay : TimeSpan
Public ReadOnly Property TimeOfDay As TimeSpan

Valor da propriedade

TimeSpan

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

Exemplos

O exemplo a seguir exibe o valor da TimeOfDay propriedade para uma matriz de DateTime valores. Ele também contrasta o valor de retorno com a cadeia de caracteres retornada pela cadeia de caracteres de formato padrão "t" em uma 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
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

Comentários

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

Se você quiser exibir a hora do dia ou recuperar a representação da cadeia de caracteres da hora do dia de um DateTime valor, poderá chamar uma sobrecarga do ToString método que tem um format parâmetro ou usar o recurso de formatação composta com a cadeia de caracteres de formato padrão "t" ou "t".

Aplica-se a

Confira também