DateTime.Now Eigenschaft
Definition
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 DateTime Objekt ab, das auf das aktuelle Datum und die aktuelle Uhrzeit auf diesem Computer festgelegt ist, ausgedrückt als lokale Uhrzeit.
public:
static property DateTime Now { DateTime get(); };
public static DateTime Now { get; }
static member Now : DateTime
Public Shared ReadOnly Property Now As DateTime
Eigenschaftswert
Ein Objekt, dessen Wert das aktuelle lokale Datum und die aktuelle Uhrzeit ist.
Beispiele
Im folgenden Beispiel werden die Now aktuellen UtcNow lokalen Datums- und Uhrzeitdaten sowie das aktuelle koordinierte (UTC)-Datum und die aktuelle Weltzeit abgerufen. Anschließend werden die Formatierungskonventionen einer Reihe von Kulturen verwendet, um die Zeichenfolgen zusammen mit den Werten ihrer Kind Eigenschaften anzuzeigen.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
DateTime localDate = DateTime.Now;
DateTime utcDate = DateTime.UtcNow;
String[] cultureNames = { "en-US", "en-GB", "fr-FR",
"de-DE", "ru-RU" } ;
foreach (var cultureName in cultureNames) {
var culture = new CultureInfo(cultureName);
Console.WriteLine("{0}:", culture.NativeName);
Console.WriteLine(" Local date and time: {0}, {1:G}",
localDate.ToString(culture), localDate.Kind);
Console.WriteLine(" UTC date and time: {0}, {1:G}\n",
utcDate.ToString(culture), utcDate.Kind);
}
}
}
// The example displays the following output:
// English (United States):
// Local date and time: 6/19/2015 10:35:50 AM, Local
// UTC date and time: 6/19/2015 5:35:50 PM, Utc
//
// English (United Kingdom):
// Local date and time: 19/06/2015 10:35:50, Local
// UTC date and time: 19/06/2015 17:35:50, Utc
//
// français (France):
// Local date and time: 19/06/2015 10:35:50, Local
// UTC date and time: 19/06/2015 17:35:50, Utc
//
// Deutsch (Deutschland):
// Local date and time: 19.06.2015 10:35:50, Local
// UTC date and time: 19.06.2015 17:35:50, Utc
//
// русский (Россия):
// Local date and time: 19.06.2015 10:35:50, Local
// UTC date and time: 19.06.2015 17:35:50, Utc
open System
open System.Globalization
let localDate = DateTime.Now
let utcDate = DateTime.UtcNow
let cultureNames =
[ "en-US"; "en-GB"; "fr-FR"; "de-DE"; "ru-RU" ]
for cultureName in cultureNames do
let culture = CultureInfo cultureName
printfn $"{culture.NativeName}:"
printfn $" Local date and time: {localDate.ToString culture}, {localDate.Kind:G}"
printfn $" UTC date and time: {utcDate.ToString culture}, {utcDate.Kind:G}\n"
// The example displays the following output:
// English (United States):
// Local date and time: 6/19/2015 10:35:50 AM, Local
// UTC date and time: 6/19/2015 5:35:50 PM, Utc
//
// English (United Kingdom):
// Local date and time: 19/06/2015 10:35:50, Local
// UTC date and time: 19/06/2015 17:35:50, Utc
//
// français (France):
// Local date and time: 19/06/2015 10:35:50, Local
// UTC date and time: 19/06/2015 17:35:50, Utc
//
// Deutsch (Deutschland):
// Local date and time: 19.06.2015 10:35:50, Local
// UTC date and time: 19.06.2015 17:35:50, Utc
//
// русский (Россия):
// Local date and time: 19.06.2015 10:35:50, Local
// UTC date and time: 19.06.2015 17:35:50, Utc
Imports System.Globalization
Module Example
Public Sub Main()
Dim localDate = DateTime.Now
Dim utcDate = DateTime.UtcNow
Dim cultureNames() As String = { "en-US", "en-GB", "fr-FR",
"de-DE", "ru-RU" }
For Each cultureName In cultureNames
Dim culture As New CultureInfo(cultureName)
Console.WriteLine("{0}:", culture.NativeName)
Console.WriteLine(" Local date and time: {0}, {1:G}",
localDate.ToString(culture), localDate.Kind)
Console.WriteLine(" UTC date and time: {0}, {1:G}",
utcDate.ToString(culture), utcDate.Kind)
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' English (United States):
' Local date and time: 6/19/2015 10:35:50 AM, Local
' UTC date and time: 6/19/2015 5:35:50 PM, Utc
'
' English (United Kingdom):
' Local date and time: 19/06/2015 10:35:50, Local
' UTC date and time: 19/06/2015 17:35:50, Utc
'
' français (France):
' Local date and time: 19/06/2015 10:35:50, Local
' UTC date and time: 19/06/2015 17:35:50, Utc
'
' Deutsch (Deutschland):
' Local date and time: 19.06.2015 10:35:50, Local
' UTC date and time: 19.06.2015 17:35:50, Utc
'
' русский (Россия):
' Local date and time: 19.06.2015 10:35:50, Local
' UTC date and time: 19.06.2015 17:35:50, Utc
Hinweise
Die Now Eigenschaft gibt einen DateTime Wert zurück, der das aktuelle Datum und die aktuelle Uhrzeit auf dem lokalen Computer darstellt. Beachten Sie, dass es einen Unterschied zwischen einem DateTime Wert gibt, der die Anzahl der Teilstriche darstellt, die seit Mitternacht des 1. Januar 0001 verstrichen sind, und der Zeichenfolgendarstellung dieses DateTime Werts, die einen Datums- und Uhrzeitwert in einem kulturspezifischen Format darstellt. Informationen zum Formatieren von Datums- und Uhrzeitwerten finden Sie in der ToString Methode. Im folgenden Beispiel wird die kurze Datums- und Uhrzeitzeichenfolge in einer Reihe von kulturspezifischen Formaten angezeigt.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
DateTime localDate = DateTime.Now;
String[] cultureNames = { "en-US", "en-GB", "fr-FR",
"de-DE", "ru-RU" };
foreach (var cultureName in cultureNames) {
var culture = new CultureInfo(cultureName);
Console.WriteLine("{0}: {1}", cultureName,
localDate.ToString(culture));
}
}
}
// The example displays the following output:
// en-US: 6/19/2015 10:03:06 AM
// en-GB: 19/06/2015 10:03:06
// fr-FR: 19/06/2015 10:03:06
// de-DE: 19.06.2015 10:03:06
// ru-RU: 19.06.2015 10:03:06
open System
open System.Globalization
let localDate = DateTime.Now
let cultureNames =
[ "en-US"; "en-GB"; "fr-FR"; "de-DE"; "ru-RU" ]
for cultureName in cultureNames do
let culture = CultureInfo cultureName
printfn $"{cultureName}: {localDate.ToString culture}"
// The example displays the following output:
// en-US: 6/19/2015 10:03:06 AM
// en-GB: 19/06/2015 10:03:06
// fr-FR: 19/06/2015 10:03:06
// de-DE: 19.06.2015 10:03:06
// ru-RU: 19.06.2015 10:03:06
Imports System.Globalization
Module Example
Public Sub Main()
Dim localDate = DateTime.Now
Dim cultureNames() As String = { "en-US", "en-GB", "fr-FR",
"de-DE", "ru-RU" }
For Each cultureName In cultureNames
Dim culture As New CultureInfo(cultureName)
Console.WriteLine("{0}: {1}", cultureName,
localDate.ToString(culture))
Next
End Sub
End Module
' The example displays the following output:
' en-US: 6/19/2015 10:03:06 AM
' en-GB: 19/06/2015 10:03:06
' fr-FR: 19/06/2015 10:03:06
' de-DE: 19.06.2015 10:03:06
' ru-RU: 19.06.2015 10:03:06
Die Auflösung dieser Eigenschaft hängt vom Systemzeitgeber ab, der vom zugrunde liegenden Betriebssystem abhängt. Es ist tendenziell zwischen 0,5 und 15 Millisekunden. Daher können wiederholte Aufrufe an die Now Eigenschaft in einem kurzen Zeitintervall, z. B. in einer Schleife, denselben Wert zurückgeben.
Die Now Eigenschaft wird häufig verwendet, um die Leistung zu messen. Aufgrund seiner geringen Auflösung eignet es sich jedoch nicht für die Verwendung als Benchmarking-Tool. Eine bessere Alternative besteht darin, die Stopwatch Klasse zu verwenden.
Ab .NET Framework, Version 2.0, ist der Rückgabewert eine DateTime , deren Kind Eigenschaft zurückgegeben wird DateTimeKind.Local.
Hinweis
Sie können die DateTimeOffset.Now Eigenschaft auch verwenden, um das aktuelle lokale Datum und die aktuelle Uhrzeit abzurufen. Damit kann eine Ortszeit eindeutig als einzelner Zeitpunkt ausgedrückt werden, was wiederum diesen Zeitwert über Computer hinweg portierbar macht.