Calendar¶

İş akışı betiklerinde takvim kurallarını dikkate alan tarih hesaplamaları yapar.

Açıklamalar¶

Takvim iş akışı, zamanlamasını gerektiğinde çözümler ve betiğin ömrü boyunca önbelleğe alır. Zamanlama yapılandırılmamışsa proxy boş bir zamanlama kullanır. Tarih girdileri şu türe dönüştürülebilmelidir: DateTimeOffset; geçersiz değerler ve geçersiz süre ya da saat dilimi dizeleri betik hatalarına yol açar.

Özellikler¶

Ön ayarlar¶

• Calendar.StandardCalendar: Standart takvimi şu saatlerle alır: 7/24 saat.
• Calendar.WeekendCalendar: Hafta sonu takvimini şu saatlerle alır: 5/24 saat.

Takvim Sorguları¶

• Calendar.Today: UTC saat dilimindeki geçerli tarih ve saati döndürür.
• Calendar.GetDateTime: Verilen süre belirtilen tarihe eklendikten sonra, takvim kurallarına göre geçerli olan bir sonraki tarih ve saati döndürür.
• Calendar.GetHoursInDay: Belirtilen tarihteki toplam saat sayısını döndürür.
• Calendar.GetToday: Belirtilen saat dilimindeki geçerli tarih ve saati döndürür.

Tarih Aritmetiği¶

• Calendar.Add: Belirtilen sayıda saati bir DateTimeOffset değere ekler ve sonucu döndürür.
• Calendar.AddDays: Belirtilen sayıda günü bir DateTimeOffset değere ekler ve takvim kurallarına göre geçerli olan bir sonraki tarih ve saati döndürür.
• Calendar.AddMonth: Takvim aylarını ekler ve sonucu bu takvimin kapsadığı bir sonraki zamana ayarlar.
• Calendar.AddMonths: Belirtilen sayıda ayı bir DateTimeOffset değere ekler ve sonucu döndürür.
• Calendar.AddTimeSpan: Takvim kurallarını dikkate alarak belirtilen bir süre ekleyip yeni bir DateTimeOffset döndürür.
• Calendar.AddYear: Takvim yıllarını ekler ve sonucu bu takvimin kapsadığı bir sonraki zamana ayarlar.
• Calendar.AddYears: Belirtilen sayıda yılı bir DateTimeOffset değere ekler ve sonucu döndürür.
• Calendar.Subtract: Bir tarih-saat değerini diğerinden çıkarır ve saat cinsinden farkı döndürür.

Asenkron Tarih Aritmetiği¶

• Calendar.AddAsync: Belirtilen sayıda saati bir DateTimeOffset değere asenkron olarak ekler.
• Calendar.AddDaysAsync: Belirtilen sayıda günü bir DateTimeOffset değere asenkron olarak ekler.
• Calendar.AddMonthsAsync: Belirtilen sayıda ayı bir DateTimeOffset değere asenkron olarak ekler.
• Calendar.AddTimeSpanAsync: Belirtilen bir süreyi bir DateTimeOffset değere asenkron olarak ekler.
• Calendar.AddYearsAsync: Belirtilen sayıda yılı bir DateTimeOffset değere asenkron olarak ekler.
• Calendar.SubtractAsync: DateTimeOffset değeri diğerinden çıkarır ve saat cinsinden farkı asenkron olarak döndürür.

Saat Dilimleri¶

• Calendar.ChangeTimeZone: Belirtilen saat dilimi farkına sahip yeni bir DateTimeOffset döndürür.
• Calendar.GetTimeZone: Belirtilen DateTimeOffset değerin saat dilimi bilgilerini döndürür.

Asenkron Saat Dilimleri¶

• Calendar.ChangeTimeZoneAsync: Belirtilen saat dilimi farkına sahip yeni bir DateTimeOffset değeri asenkron olarak döndürür.
• Calendar.GetTimeZoneAsync: Bir DateTimeOffset değerin saat dilimi farkını asenkron olarak döndürür.

Asenkron Takvim Sorguları¶

• Calendar.GetDateTimeAsync: Verilen süre eklendikten sonra, takvim kurallarına göre geçerli olan bir sonraki tarih ve saati döndürür.
• Calendar.GetHoursInDayAsync: Takvimin bir tarihte kapsadığı saat sayısını döndürür.
• Calendar.GetTodayAsync: Belirtilen saat dilimindeki geçerli tarihi asenkron olarak döndürür.

Oluşturma ve Ön Ayarlar¶

• Calendar.GetStandardCalendar: Standart takvimi şu saatlerle alır: 7/24 saat (24 saat, haftada 7 gün).
• Calendar.GetWeekendCalendar: Hafta sonu takvimini şu saatlerle alır: 5/24 saat (24 saat, haftada 5 gün).
• Calendar.Parse: Bir XML dizesinden veya Xml nesnesinden takvim kuralını ayrıştırır ve bir Calendar nesnesi döndürür.