AddTimeSpan¶

Takvim kurallarını dikkate alarak belirtilen süreyi ekleyip DateTimeOffset yeni bir değer döndürür.

myCalendar.AddTimeSpan(dateTime: DateTimeOffset, duration: string):DateTimeOffset

Parametreler¶

DateTimeOffset dateTime
Sürenin ekleneceği temel DateTimeOffset değer.

string duration
Eklenecek süre, "d.hh:mm:ss" biçiminde veya ISO-8601 süre biçimindedir.

Döndürür¶

Takvim kurallarını dikkate alarak toplama işleminin sonucunu temsil eden yeni bir DateTimeOffset değer.

Notlar¶

Bu yöntem, verilen süreyi iş saatleri cinsinden ekler. Yalnızca süreyi eklemeniz ve bir sonraki iş tarihini ve saatini bulmanız gerekiyorsa bunun yerine Calendar.GetDateTime yöntemini kullanın.

ISO-8601 süre biçimine ek olarak bu yöntem, zaman aralıkları için başlangıç ve bitiş belirteçlerini de destekler:

BD: Günün başlangıcı
DE: Günün sonu
MB: Ayın başlangıcı
ME: Ayın sonu
YB: Yılın başlangıcı
YE: Yılın sonu

Örnekler:

P2BY: Geçerli tarihe 2 yıl ekler ve yılın başlangıcına geri döner.
P1M2BD: Geçerli tarihe 1 ay ve 2 gün ekler ve günün başlangıcına geri döner.
P1M2ED: Geçerli tarihe 1 ay ve 2 gün ekler ve günün sonuna ilerler.

İş saati kurallarını kullanarak ISO-8601 süresi ekleme¶

// Adds 1 month, 1 day, and 2 hours
var newDate = $Calendar.StandardCalendar.AddTimeSpan($Calendar.Today, 'P1M1DT2H');

Gün-saat-dakika-saniye biçimini kullanarak zaman aralığı ekleme¶

// Adds 1 day, 2 hours, 30 minutes, and 45 seconds to the current time.
var newDate = $Calendar.StandardCalendar.AddTimeSpan($Calendar.Today, '1.02:30:45');

Warning

Bu yöntem süreyi iş saatleri cinsinden ekler ve süreyi eklerken iş günü olmayan tarihleri atlayabilir.

İş saatlerinin sonuç saatini nasıl değiştirdiğini görün¶

var nextDate = $Calendar.AddTimeSpan(DateTimeOffset.parse('2023-02-08T17:00'), 'PT2H');
// nextDate will be set to '2020-02-09T10:00'

Eşdeğer süre biçimlerini karşılaştırın¶

var newDate = $Calendar.StandardCalendar.AddTimeSpan($Calendar.Today, '1.02:30:45');
var newDate = $Calendar.StandardCalendar.AddTimeSpan($Calendar.Today, 'P1DT2H');