DateTimeOffset.UtcNow Eigenschaft

Referenz

Definition

Namespace:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft ein DateTimeOffset-Objekt ab, dessen Datum und Uhrzeit auf die aktuelle UTC (Coordinated Universal Time)-Datums- und Uhrzeitangabe festgelegt und dessen Offset Zero ist.

public:
 static property DateTimeOffset UtcNow { DateTimeOffset get(); };

public static DateTimeOffset UtcNow { get; }

static member UtcNow : DateTimeOffset

Public Shared ReadOnly Property UtcNow As DateTimeOffset

Eigenschaftswert

DateTimeOffset

Ein Objekt, dessen Datum und Uhrzeit die aktuelle Coordinated Universal Time (UTC) ist und dessen Offset Zero ist.

Beispiele

Das folgende Beispiel veranschaulicht die Beziehung zwischen koordinierter Weltzeit (UTC) und Lokaler Zeit.

DateTimeOffset localTime = DateTimeOffset.Now;
DateTimeOffset utcTime = DateTimeOffset.UtcNow;

Console.WriteLine("Local Time:          {0}", localTime.ToString("T"));
Console.WriteLine("Difference from UTC: {0}", localTime.Offset.ToString());
Console.WriteLine("UTC:                 {0}", utcTime.ToString("T"));
// If run on a particular date at 1:19 PM, the example produces
// the following output:
//    Local Time:          1:19:43 PM
//    Difference from UTC: -07:00:00
//    UTC:                 8:19:43 PM

let localTime = DateTimeOffset.Now
let utcTime = DateTimeOffset.UtcNow

printfn $"Local Time:          {localTime:T}"
printfn $"Difference from UTC: {localTime.Offset}"
printfn $"UTC:                 {utcTime:T}"

// If run on a particular date at 1:19 PM, the example produces
// the following output:
//    Local Time:          1:19:43 PM
//    Difference from UTC: -07:00:00
//    UTC:                 8:19:43 PM

Dim localTime As DateTimeOffset = DateTimeOffset.Now
Dim utcTime As DateTimeOffset = DateTimeOffset.UtcNow

Console.WriteLine("Local Time:          {0}", localTime.ToString("T"))
Console.WriteLine("Difference from UTC: {0}", localTime.Offset.ToString())
Console.WriteLine("UTC:                 {0}", utcTime.ToString("T"))
' If run on a particular date at 1:19 PM, the example produces
' the following output:
'    Local Time:          1:19:43 PM
'    Difference from UTC: -07:00:00
'    UTC:                 8:19:43 PM

Hinweise

Die UtcNow Eigenschaft berechnet die aktuelle koordinierte Weltzeit (UTC) basierend auf der Uhrzeit des lokalen Systems und einem Offset, der durch die Zeitzone des lokalen Systems definiert wird.

Die Genauigkeit der Millisekundenkomponente der aktuellen UTC-Zeit hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher sowie unter Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 – 15 Millisekunden.

Gilt für:

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Freigeben über