DateTime.Today Свойство

Определение

Возвращает текущую дату.Gets the current date.

public:
 static property DateTime Today { DateTime get(); };
public static DateTime Today { get; }
member this.Today : DateTime
Public Shared ReadOnly Property Today As DateTime

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

Объект, которому присвоена сегодняшняя дата, с компонентом времени, равным 00:00:00.An object that is set to today's date, with the time component set to 00:00:00.

Примеры

В следующем примере свойство Date используется для получения текущей даты.The following example uses the Date property to retrieve the current date. Также показано, как можно отформатировать DateTime значение с помощью некоторых строк стандартного формата даты и времени.It also illustrates how a DateTime value can be formatted using some of the standard date and time format strings. Обратите внимание, что результат, полученный третьим вызовом метода ToString(String), использует описатель формата g для включения компонента времени, который равен нулю.Note that the output produced by the third call to the ToString(String) method uses the g format specifier to include the time component, which is zero.

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
Module modMain
   Public Sub Main()
      ' Get the current date.
      Dim thisDay As DateTime = 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"))
   End Sub
End Module
' 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.Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property returns Local.

Поскольку она возвращает текущую дату без текущего времени, свойство Today подходит для использования в приложениях, работающих только с датами.Because it returns the current date without the current time, the Today property is suitable for use in applications that work with dates only. Дополнительные сведения см. в разделе Выбор между DateTime, DateTimeOffset, TimeSpan и TimeZoneInfo.For details, see Choosing Between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo. Напротив, свойство TimeOfDay возвращает текущее время без текущей даты, а свойство Now возвращает как текущую, так и текущее время.In contrast, the TimeOfDay property returns the current time without the current date, and the Now property returns both the current date and the current time.

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

Дополнительно