DateTime.Add(TimeSpan) Metode

Referensi

Definisi

Ruang nama:: System

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: DateTime.cs

Sumber:: DateTime.cs

Sumber:: DateTime.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan yang baru DateTime yang menambahkan nilai yang ditentukan TimeSpan ke nilai instans ini.

public:
 DateTime Add(TimeSpan value);

public DateTime Add (TimeSpan value);

member this.Add : TimeSpan -> DateTime

Public Function Add (value As TimeSpan) As DateTime

Parameter

value: TimeSpan

Interval waktu positif atau negatif.

Mengembalikan

DateTime

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

Pengecualian

ArgumentOutOfRangeException

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

Contoh

Contoh berikut menunjukkan Add metode . Ini menghitung hari dalam seminggu yaitu 36 hari (864 jam) dari saat ini.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );

// Calculate what day of the week is 36 days from this instant.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"

// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

Keterangan

Anda dapat menggunakan Add metode untuk menambahkan lebih dari satu jenis interval waktu (hari, jam, menit, detik, atau milidetik) dalam satu operasi. Perilaku metode ini identik dengan operator penambahan. Struktur ini DateTime juga mendukung metode penambahan khusus (seperti AddDays, , AddHoursdan AddMinutes) untuk setiap interval waktu.

Metode ini Add memperhitungkan tahun lompatan dan jumlah hari dalam sebulan ketika melakukan aritmatika tanggal.

Metode ini tidak mengubah nilai ini DateTime. Sebaliknya, ia mengembalikan yang baru DateTime yang nilainya adalah hasil dari operasi ini. Properti Kind instans baru DateTime sama dengan instans saat ini.

Berlaku untuk