DateTime.Today DateTime.Today DateTime.Today DateTime.Today Property

定義

現在の日付を取得します。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

プロパティ値

今日の日付を表すオブジェクト (ただし、時刻部分は 00:00:00)。An object that is set to today's date, with the time component set to 00:00:00.

次の例では、Dateプロパティを現在の日付を取得します。The following example uses the Date property to retrieve the current date. 示されている方法、DateTime値は、標準の日付と時刻の書式指定文字列の一部を使用して書式設定できます。It also illustrates how a DateTime value can be formatted using some of the standard date and time format strings. 3 番目の呼び出しによって、出力が生成されることに注意してください、ToString(String)メソッドでは、g 書式指定子を使用して、時刻部分には、0 が含まれます。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

注釈

以降、.NET Framework version 2.0 では、戻り値は、DateTimeKindプロパティが返すLocalします。Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property returns Local.

現在の時刻のない現在の日付を返すため、Todayプロパティは日付のみを操作するアプリケーションでの使用に適しています。Because it returns the current date without the current time, the Today property is suitable for use in applications that work with dates only. 詳細については、次を参照してください。選択の間で DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfoします。For details, see Choosing Between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo. これに対し、TimeOfDayプロパティは、現在の日付を使用せず、現在の時刻を返します、Nowプロパティは、現在の日付と現在の時刻の両方を返します。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.

適用対象

こちらもご覧ください