Bagikan melalui

DateTimeOffset.Add(TimeSpan) Metode

  • Referensi

Definisi

Ruang nama:
System
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll
Sumber:
DateTimeOffset.cs
Sumber:
DateTimeOffset.cs
Sumber:
DateTimeOffset.cs

Mengembalikan objek baru DateTimeOffset yang menambahkan interval waktu tertentu ke nilai instans ini.

public:
 DateTimeOffset Add(TimeSpan timeSpan);
public DateTimeOffset Add (TimeSpan timeSpan);
member this.Add : TimeSpan -> DateTimeOffset
Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Parameter

timeSpan
TimeSpan

Objek TimeSpan yang mewakili interval waktu positif atau negatif.

Mengembalikan

DateTimeOffset

Objek yang nilainya adalah jumlah tanggal dan waktu yang diwakili oleh objek saat ini DateTimeOffset dan interval waktu yang diwakili oleh timeSpan.

Pengecualian

ArgumentOutOfRangeException

Nilai yang DateTimeOffset dihasilkan kurang dari DateTimeOffset.MinValue.

-atau-

Nilai yang DateTimeOffset dihasilkan lebih besar dari DateTimeOffset.MaxValue.

Contoh

Contoh berikut membuat array TimeSpan objek yang mewakili waktu penerbangan antar tujuan. Metode Add kemudian menambahkan waktu ini ke DateTimeOffset objek yang mewakili waktu lepas landas awal penerbangan. Hasilnya mencerminkan waktu kedatangan terjadwal di setiap tujuan.

DateTimeOffset takeOff = new DateTimeOffset(2007, 6, 1, 7, 55, 0,
                             new TimeSpan(-5, 0, 0));
DateTimeOffset currentTime = takeOff;
TimeSpan[] flightTimes = new TimeSpan[]
                  {new TimeSpan(2, 25, 0), new TimeSpan(1, 48, 0)};
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.",
                  takeOff);
for (int ctr = flightTimes.GetLowerBound(0);
     ctr <= flightTimes.GetUpperBound(0); ctr++)
{
   currentTime = currentTime.Add(flightTimes[ctr]);
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime);
}

let takeOff = DateTimeOffset(2007, 6, 1, 7, 55, 0, TimeSpan(-5, 0, 0))
let mutable currentTime = takeOff
let flightTimes = [| TimeSpan(2, 25, 0); TimeSpan(1, 48, 0) |]
printfn $"Takeoff is scheduled for {takeOff:d} at {takeOff:T}."
                
for i = 0 to flightTimes.Length - 1 do
    currentTime <- currentTime.Add flightTimes[i]
    printfn $"Destination #{i + 1} at {currentTime}."

Dim takeOff As New DateTimeOffset(#6/1/2007 7:55AM#, _
                                  New TimeSpan(-5, 0, 0))
Dim currentTime As DateTimeOffset = takeOff
Dim flightTimes() As TimeSpan = New TimeSpan() _
                  {New TimeSpan(2, 25, 0), New TimeSpan(1, 48, 0)}
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.", _
                  takeOff)
For ctr As Integer = flightTimes.GetLowerBound(0) To _
                     flightTimes.GetUpperBound(0)
   currentTime = currentTime.Add(flightTimes(ctr))
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime)
Next

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 DateTimeOffset juga mendukung metode penambahan khusus (seperti AddDays, , AddHoursdan AddMinutes) untuk setiap interval waktu.

Catatan

Metode ini mengembalikan objek baru DateTimeOffset . Ini tidak mengubah nilai objek saat ini dengan menambahkan timeSpan ke tanggal dan waktunya.

Metode Add ini tidak memengaruhi nilai properti objek Offset saat iniDateTimeOffset.

DateTimeOffset Karena objek tidak mewakili tanggal dan waktu dalam zona waktu tertentu, Add metode tidak mempertimbangkan aturan penyesuaian zona waktu tertentu ketika melakukan aritmatika tanggal dan waktu.

timeSpan Jika parameter adalah null, metode ini mengembalikan nilai objek asli DateTimeOffset yang tidak berubah.

Berlaku untuk

Lihat juga