DateTime.Today Свойство

Определение

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

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

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

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

Примеры

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

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
open System

// Get the current date.
let thisDay = DateTime.Today
// Display the date in the default (general) format.
printfn $"{thisDay}\n"
// Display the date in a variety of formats.
printfn $"{thisDay:d}"
printfn $"{thisDay:D}"
printfn $"{thisDay: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.

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

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

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