DateTime.Today プロパティ

定義

現在の日付を取得します。

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

プロパティ値

DateTime

今日の日付を表すオブジェクト (ただし、時刻部分は 00:00:00)。

次の例では、プロパティを使用して Date 、現在の日付を取得します。 また、 DateTime 標準の日時書式指定文字列を使用して値を書式設定する方法についても説明します。 メソッドの3番目の呼び出しによって生成される出力では、 ToString(String) g 書式指定子を使用して、時間部分 (0) を指定します。

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 バージョン2.0 以降、戻り値は、 DateTime Kind プロパティがを返すを返し Local ます。

現在の日付が返されるので、この Today プロパティは、日付のみを使用するアプリケーションでの使用に適しています。 詳細については、「 DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け」を参照してください。 これに対して、プロパティは現在の TimeOfDay 日付を除く現在の時刻を返し、 Now プロパティは現在の日付と現在の時刻の両方を返します。

適用対象

こちらもご覧ください