Language

DateTime.AddDays(Double) メソッド

定義

名前空間:
System
アセンブリ:
mscorlib.dll, System.Runtime.dll
アセンブリ:
netstandard.dll, System.Runtime.dll
アセンブリ:
System.Runtime.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.dll
ソース:
DateTime.cs
ソース:
DateTime.cs
ソース:
DateTime.cs
ソース:
DateTime.cs
ソース:
DateTime.cs

このインスタンスの値に指定した日数を加算する新しい DateTime を返します。

public:
 DateTime AddDays(double value);
public DateTime AddDays(double value);
member this.AddDays : double -> DateTime
Public Function AddDays (value As Double) As DateTime

パラメーター

value
Double

整数と小数部の日数。 valueパラメーターには、負または正の値を指定できます。

返品

DateTime

このインスタンスで表される日付と時刻と、 valueで表される日数の合計を値とするオブジェクト。

例外

ArgumentOutOfRangeException

結果の DateTime が DateTime.MinValue より小さいか 、DateTime.MaxValue より大きい。

例

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

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

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

適用対象

こちらもご覧ください