DateTime.Today Propiedad

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

Obtiene la fecha actual.

public:
 static property DateTime Today { DateTime get(); };
public static DateTime Today { get; }
static member 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.

Ejemplos

En el ejemplo siguiente se usa la Date propiedad para recuperar la fecha actual. También se muestra cómo se puede dar formato a un DateTime valor mediante algunas de las cadenas de formato estándar de fecha y hora. 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.

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

Comentarios

A partir de la versión 2.0 de .NET Framework, el valor devuelto es una DateTime cuya Kind propiedad devuelve 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. Para obtener más información, vea Elegir entre DateTime, DateTimeOffset, TimeSpan y 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.

Se aplica a

Consulte también