Прочитать на английском

Поделиться через


DateTime.Today Свойство

Определение

Возвращает текущую дату.

C#
public static DateTime Today { get; }

Значение свойства

Объект, которому присвоена сегодняшняя дата, с компонентом времени, равным 00:00:00.

Примеры

В следующем примере свойство используется Date для получения текущей даты. В нем также показано, как DateTime можно отформатировать значение с помощью некоторых стандартных строк формата даты и времени. Обратите внимание, что выходные данные, полученные при третьем вызове ToString(String) метода, используют описатель формата g для включения компонента времени, который равен нулю.

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

Комментарии

Начиная с платформа .NET Framework версии 2.0, возвращаемым значением DateTime является , свойство которого Kind возвращает Local.

Так как оно возвращает текущую дату без текущего Today времени, свойство подходит для использования в приложениях, которые работают только с датами. Дополнительные сведения см. в разделе Выбор между DateTime, DateTimeOffset, TimeSpan и TimeZoneInfo. В отличие от этого, TimeOfDay свойство возвращает текущее время без текущей даты, а Now свойство возвращает как текущую дату, так и текущее время.

Применяется к

Продукт Версии
.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

См. также раздел