DateTime.Today Proprietà

Definizione

Ottiene la data corrente.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

Valore della proprietà

Oggetto che è impostato sulla data corrente, con il componente ora impostato su 00.00.00.An object that is set to today's date, with the time component set to 00:00:00.

Esempi

Nell'esempio seguente viene utilizzata la proprietà Date per recuperare la data corrente.The following example uses the Date property to retrieve the current date. Viene inoltre illustrato come un valore DateTime può essere formattato utilizzando alcune delle stringhe di formato di data e ora standard.It also illustrates how a DateTime value can be formatted using some of the standard date and time format strings. Si noti che l'output prodotto dalla terza chiamata al metodo ToString(String) usa l'identificatore di formato g per includere il componente ora, che è zero.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

Commenti

A partire dalla versione .NET Framework 2,0, il valore restituito è un DateTime la cui proprietà Kind restituisce Local.Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property returns Local.

Poiché restituisce la data corrente senza l'ora corrente, la proprietà Today è adatta per l'utilizzo in applicazioni che utilizzano solo date.Because it returns the current date without the current time, the Today property is suitable for use in applications that work with dates only. Per informazioni dettagliate, vedere scelta tra DateTime, DateTimeOffset, TimeSpan e TimeZoneInfo.For details, see Choosing Between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo. Al contrario, la proprietà TimeOfDay restituisce l'ora corrente senza la data corrente e la proprietà Now restituisce sia la data corrente che l'ora corrente.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.

Si applica a

Vedi anche