DateTime.TimeOfDay Eigenschaft

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTime.cs

Ruft die Tageszeit für diese Instanz ab.

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

public TimeSpan TimeOfDay { get; }

member this.TimeOfDay : TimeSpan

Public ReadOnly Property TimeOfDay As TimeSpan

Eigenschaftswert

TimeSpan

Ein Zeitintervall, das den Bruchteil des Tages darstellt, der seit Mitternacht verstrichen ist.

Beispiele

Im folgenden Beispiel wird der Wert der TimeOfDay Eigenschaft für ein Array von DateTime Werten angezeigt. Sie kontrastiert auch den Rückgabewert mit der Zeichenfolge, die von der Standardformatzeichenfolge "t" in einem zusammengesetzten Formatierungsvorgang zurückgegeben wird.

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

Hinweise

Date Im Gegensatz zur Eigenschaft, die einen DateTime Wert zurückgibt, der ein Datum ohne seine Zeitkomponente darstellt, gibt die Eigenschaft einen TimeSpan Wert zurück, der TimeOfDay die Zeitkomponente eines DateTime Werts darstellt.

Wenn Sie die Tageszeit anzeigen oder die Zeichenfolgendarstellung der Tageszeit eines DateTime Werts abrufen möchten, können Sie stattdessen eine Überladung der Methode aufrufen, die ToString über einen format Parameter verfügt oder das zusammengesetzte Formatierungsfeature mit der Standardformatzeichenfolge "t" oder "T" verwenden.

Weitere Informationen

• TimeSpan