DateTime.Today Właściwość

Definicja

Pobiera bieżącą datę.

C#
public static DateTime Today { get; }

Wartość właściwości

Obiekt, który jest ustawiony na bieżącą datę, ze składnikiem godziny ustawionym na 00:00:00.

Przykłady

W poniższym przykładzie użyto Date właściwości , aby pobrać bieżącą datę. Ilustruje również sposób DateTime formatowania wartości przy użyciu niektórych standardowych ciągów formatu daty i godziny. Należy pamiętać, że dane wyjściowe generowane przez trzecie wywołanie ToString(String) metody używa specyfikatora formatu g do uwzględnienia składnika czasu, który jest zerowy.

C#
using System;

public class Example
{
   public static void Main()
   {
      // Get the current date.
      DateTime thisDay = DateTime.Today;
      // Display the date in the default (general) format.
      Console.WriteLine(thisDay.ToString());
      Console.WriteLine();
      // Display the date in a variety of formats.
      Console.WriteLine(thisDay.ToString("d"));
      Console.WriteLine(thisDay.ToString("D"));
      Console.WriteLine(thisDay.ToString("g"));
   }
}
// The example displays output similar to the following:
//    5/3/2012 12:00:00 AM
//
//    5/3/2012
//    Thursday, May 03, 2012
//    5/3/2012 12:00 AM

Uwagi

Począwszy od .NET Framework w wersji 2.0, zwracana wartość jest właściwościąDateTime, której Kind właściwość zwraca wartość Local.

Ponieważ zwraca bieżącą datę bez bieżącej godziny, Today właściwość jest odpowiednia do użycia w aplikacjach, które działają tylko z datami. Aby uzyskać szczegółowe informacje, zobacz Wybieranie między wartościami DateTime, DateTimeOffset, TimeSpan i TimeZoneInfo. TimeOfDay Natomiast właściwość zwraca bieżącą godzinę bez bieżącej daty, a Now właściwość zwraca zarówno bieżącą datę, jak i bieżącą godzinę.

Dotyczy

Produkt Wersje
.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 1.1, 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

Zobacz też