DateTime.Date DateTime.Date DateTime.Date DateTime.Date Property

Definizione

Ottiene il componente di data dell'istanza.Gets the date component of this instance.

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

Valore della proprietà

Nuovo oggetto con la medesima data dell'istanza e il valore dell'ora impostato sulla mezzanotte (00.00.00).A new object with the same date as this instance, and the time value set to 12:00:00 midnight (00:00:00).

Esempi

Nell'esempio seguente viene utilizzata Date la proprietà per estrarre il componente relativo alla DateTime data di un valore con il relativo componente ora impostato su zero (o 0:00:00 o mezzanotte).The following example uses the Date property to extract the date component of a DateTime value with its time component set to zero (or 0:00:00, or midnight). Viene inoltre illustrato che, a seconda della stringa di formato utilizzata per la visualizzazione del DateTime valore, il componente ora può continuare a essere visualizzato nell'output formattato.It also illustrates that, depending on the format string used when displaying the DateTime value, the time component can continue to appear in formatted output.

using namespace System;

void main()
{
   DateTime^ date1 = gcnew DateTime(2008, 6, 1, 7, 47, 0);
   Console::WriteLine(date1->ToString());
   
   // Get date-only portion of date, without its time.
   DateTime dateOnly = date1->Date;
   // Display date using short date string.
   Console::WriteLine(dateOnly.ToString("d"));
   // Display date using 24-hour clock.
   Console::WriteLine(dateOnly.ToString("g"));
   Console::WriteLine(dateOnly.ToString(L"MM/dd/yyyy HH:mm"));   
}
// The example displays the following output to the console:
//       6/1/2008 7:47:00 AM
//       6/1/2008
//       6/1/2008 12:00 AM
//       06/01/2008 00:00
using System;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2008, 6, 1, 7, 47, 0);
      Console.WriteLine(date1.ToString());
      
      // Get date-only portion of date, without its time.
      DateTime dateOnly = date1.Date;
      // Display date using short date string.
      Console.WriteLine(dateOnly.ToString("d"));
      // Display date using 24-hour clock.
      Console.WriteLine(dateOnly.ToString("g"));
      Console.WriteLine(dateOnly.ToString("MM/dd/yyyy HH:mm"));   
   }
}
// The example displays output like the following output:
//       6/1/2008 7:47:00 AM
//       6/1/2008
//       6/1/2008 12:00 AM
//       06/01/2008 00:00
Module Example
   Public Sub Main()
      Dim date1 As Date = #6/1/2008 7:47AM#
      Console.WriteLine(date1.ToString())
      
      ' Get date-only portion of date, without its time.
      Dim dateOnly As Date = date1.Date
      ' Display date using short date string.
      Console.WriteLine(dateOnly.ToString("d"))
      ' Display date using 24-hour clock.
      Console.WriteLine(dateOnly.ToString("g"))
      Console.WriteLine(dateOnly.ToString("MM/dd/yyyy HH:mm"))   
   End Sub
End Module
' The example displays output like the following:
'       6/1/2008 7:47:00 AM                     
'       6/1/2008
'       6/1/2008 12:00 AM
'       06/01/2008 00:00

Commenti

Il valore della Kind proprietà del valore restituito DateTime è uguale a quello dell'istanza corrente.The value of the Kind property of the returned DateTime value is the same as that of the current instance.

Poiché il DateTime tipo rappresenta sia le date che le ore in un unico tipo, è importante evitare di interpretare erroneamente una data restituita Date dalla proprietà come data e ora.Because the DateTime type represents both dates and times in a single type, it is important to avoid misinterpreting a date returned by the Date property as a date and time.

Si applica a