DateTime.Today Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá aktuální datum.
public:
static property DateTime Today { DateTime get(); };
public static DateTime Today { get; }
static member Today : DateTime
Public Shared ReadOnly Property Today As DateTime
Hodnota vlastnosti
Objekt nastavený na dnešní datum s časovou komponentou nastavenou na 00:00:00.
Příklady
Následující příklad používá Date vlastnost k načtení aktuálního data. Ukazuje také, jak DateTime lze hodnotu formátovat pomocí některých standardních řetězců formátu data a času. Všimněte si, že výstup vytvořený třetím voláním ToString(String) metody používá specifikátor formátu g k zahrnutí časové komponenty, která je nula.
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
Poznámky
Počínaje rozhraním .NET Framework verze 2.0 je návratová hodnota, DateTime jejíž Kind vlastnost vrací Local.
Vzhledem k tomu, že vrátí aktuální datum bez aktuálního času, Today je vlastnost vhodná pro použití v aplikacích, které pracují pouze s kalendářními daty. Podrobnosti najdete v tématu Volba mezi DateTime, DateTimeOffset, TimeSpan a TimeZoneInfo. Naproti tomu TimeOfDay vlastnost vrátí aktuální čas bez aktuálního data a Now vlastnost vrátí aktuální datum i aktuální čas.