DateTime.Today Propiedad

Definición

Obtiene la fecha actual.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

Valor de propiedad

DateTime

Objeto que se ha establecido en la fecha del día, con el componente de hora establecido en 00:00:00.An object that is set to today's date, with the time component set to 00:00:00.

Ejemplos

En el ejemplo siguiente se utiliza la Date propiedad para recuperar la fecha actual.The following example uses the Date property to retrieve the current date. También muestra cómo DateTime se puede dar formato a un valor mediante algunas de las cadenas de formato de fecha y hora estándar.It also illustrates how a DateTime value can be formatted using some of the standard date and time format strings. Tenga en cuenta que la salida generada por la tercera llamada al ToString(String) método usa el especificador de formato g para incluir el componente de hora, que es cero.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

Comentarios

A partir de la versión 2,0 de .NET Framework, el valor devuelto es una DateTime cuya Kind propiedad devuelve Local .Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property returns Local.

Dado que devuelve la fecha actual sin la hora actual, la Today propiedad es adecuada para su uso en aplicaciones que solo funcionan con fechas.Because it returns the current date without the current time, the Today property is suitable for use in applications that work with dates only. Para obtener más información, vea elegir entre DateTime, DateTimeOffset, TimeSpan y TimeZoneInfo.For details, see Choosing Between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo. En cambio, la TimeOfDay propiedad devuelve la hora actual sin la fecha actual y la Now propiedad devuelve la fecha actual y la hora actual.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.

Se aplica a

Consulte también