DateTime.AddDays(Double) メソッド

public:
 DateTime AddDays(double value);

public DateTime AddDays (double value);

member this.AddDays : double -> DateTime

Public Function AddDays (value As Double) As DateTime

パラメーター

戻り値

このインスタンスで表された日付と時刻に value で表された日数を加算した値を保持するオブジェクト。

例外

例

次の例では、 メソッドを AddDays 使用して、現在の日付から 36 日後の曜日を決定します。

using namespace System;

int main()
{
   // Calculate what day of the week is 36 days from this instant.
   DateTime today = System::DateTime::Now;
   DateTime answer = today.AddDays( 36 );
   Console::WriteLine("Today: {0:dddd}", today);
   Console::WriteLine("36 days from today: {0:dddd}", answer);
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

open System

let today = DateTime.Now
let answer = today.AddDays 36
printfn $"Today: {today:dddd}"
printfn $"36 days from today: {answer:dddd}"


// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

using System;

class Class1
{
    static void Main()
    {
        DateTime today = DateTime.Now;
        DateTime answer = today.AddDays(36);
        Console.WriteLine("Today: {0:dddd}", today);
        Console.WriteLine("36 days from today: {0:dddd}", answer);
    }
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

Class Class1
   Public Shared Sub Main()
      Dim today As System.DateTime
      Dim answer As System.DateTime

      today = System.DateTime.Now
      answer = today.AddDays(36)

      Console.WriteLine("Today: {0:dddd}", today)
      Console.WriteLine("36 days from today: {0:dddd}", answer)
   End Sub
End Class
' The example displays output like the following:
'       Today: Wednesday
'       36 days from today: Thursday

注釈

このメソッドでは、この DateTimeの値は変更されません。 代わりに、この操作の結果である値を持つ新しい DateTime が返されます。

の value 小数部は、1 日の小数部です。 たとえば、4.5 は 4 日、12 時間、0 分、0 秒、0 ミリ秒、0 ティックに相当します。

.NET 6 以前のバージョンでは、 value パラメーターは最も近いミリ秒に丸められます。 .NET 7 以降のバージョンでは、 パラメーターのvalue完全なDouble有効桁数が使用されます。 ただし、浮動小数点演算の本質的な不正確さが原因で、結果の精度は異なります。

メソッドでは AddDays 、日付の算術演算を実行するときに、閏年と月の日数が考慮されます。

適用対象

こちらもご覧ください

• Double