DateTime.AddDays(Double) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

DateTime.cs

Mengembalikan baru DateTime yang menambahkan jumlah hari yang ditentukan ke nilai instans ini.

public:
 DateTime AddDays(double value);

public DateTime AddDays (double value);

member this.AddDays : double -> DateTime

Public Function AddDays (value As Double) As DateTime

Parameter

value

Double

Sejumlah hari utuh dan pecahan. Parameternya value bisa negatif atau positif.

Mengembalikan

DateTime

Objek yang nilainya adalah jumlah tanggal dan waktu yang diwakili oleh instans ini dan jumlah hari yang diwakili oleh value.

Pengecualian

ArgumentOutOfRangeException

DateTime Hasilnya kurang dari DateTime.MinValue atau lebih besar dari DateTime.MaxValue.

Contoh

Contoh berikut menggunakan AddDays metode untuk menentukan hari dalam seminggu 36 hari setelah tanggal saat ini.

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

Keterangan

Metode ini tidak mengubah nilai ini DateTime. Sebaliknya, ia mengembalikan yang baru DateTime yang nilainya adalah hasil dari operasi ini.

Bagian pecahan adalah value bagian pecahan dari sehari. Misalnya, 4,5 setara dengan 4 hari, 12 jam, 0 menit, 0 detik, 0 milidetik, dan 0 kutu.

Dalam .NET 6 dan versi yang lebih lama, parameter dibulatkan value ke milidetik terdekat. Di .NET 7 dan versi yang lebih baru, presisi value penuh Double parameter digunakan. Namun, karena impresi matematika floating point yang melekat, presisi yang dihasilkan akan bervariasi.

Metode ini AddDays memperhitungkan tahun kampung dan jumlah hari dalam sebulan ketika melakukan aritmatika tanggal.

Lihat juga

• Double