DateTime.Today Właściwość

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

DateTime.cs

Pobiera bieżącą datę.

public:
 static property DateTime Today { DateTime get(); };

public static DateTime Today { get; }

static member Today : DateTime

Public Shared ReadOnly Property Today As DateTime

Wartość właściwości

DateTime

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.

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

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ę.

Zobacz też

• Now
• TimeOfDay