AddTimeSpan¶

Belirtilen bir süre ekleyerek takvim kurallarını dikkate alan yeni bir DateTimeOffset döndürür.

myCalendar.AddTimeSpan(dateTime: DateTimeOffset, duration: string):DateTimeOffset (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çiminde olmalıdır.

Döndürür¶

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

Açıklamalar¶

Bu yöntem, verilen süreyi çalışma saatleri içinde ekler. Yalnızca süreyi ekleyip 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 alır.
P1M2BD: Geçerli tarihe 1 ay ve 2 gün ekler ve günün başlangıcına geri alır.
P1M2ED: Geçerli tarihe 1 ay ve 2 gün ekler ve günün sonuna ileri alır.

Çalışma 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 çalışma saatleri içinde ekler ve ekleme sırasında iş günü olmayan tarihleri atlayabilir.

Çalışma 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');