$Calendar¶

Alana özgü takvim kurallarını kullanan varsayılan takvim iş akışı örneğini sağlar.

1

const $Calendar: Calendar;

Açıklamalar¶

$Calendar geçerli tarih ve saati almak, tarih ve saat aritmetiği (toplama ve çıkarma) işlemlerini gerçekleştirmek ve saat dilimi dönüşümlerini yönetmek için kullanılır.

$Calendar hem istemci tarafı hem de sunucu tarafı betiklerde kullanılabilir. Sunucu tarafı betiklerde hem eşzamanlı hem de eşzamansız yöntemler desteklenir. Ancak istemci tarafı betikler, doğaları gereği eşzamansız olduklarından yalnızca eşzamansız yöntemlerle sınırlıdır.

$Calendar varsayılan olarak alanadı takvim kurallarını kullanır. Belirli takvim uygulamaları için Calendar.StandardCalendar veya Calendar.WeekendCalendar nesnelerine bakın.

Gün eklemeye yönelik sunucu tarafı örneği:

Örnek¶

1
2

// Gets the date and time one day from now.
var currentDate = $Calendar.AddDays(DateTimeOffset.now, 1);

Gün eklemeye yönelik istemci tarafı örneği (eşzamansız):

Örnek¶

1
2

// Adds 2 days to the current date and time asynchronously.
var newDate = await $Calendar.AddDaysAsync(DateTimeOffset.now, 2);

Özellikler¶

Ön ayarlar¶

• $Calendar.StandardCalendar: Saatleri 7/24 olan standart takvimi alır.
• $Calendar.WeekendCalendar: Saatleri 5/24 olan hafta sonu takvimini alır.

Takvim Sorguları¶

• $Calendar.Today: Geçerli tarih ve saati UTC olarak döndürür.
• $Calendar.GetDateTime: Belirtilen tarihe verilen süre 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: Bir DateTimeOffset değerine belirtilen sayıda saat ekler ve sonucu döndürür.
• $Calendar.AddDays: Bir DateTimeOffset değerine belirtilen sayıda gün 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: Bir DateTimeOffset değerine belirtilen sayıda ay ekler ve sonucu döndürür.
• $Calendar.AddTimeSpan: Takvim kurallarını dikkate alarak belirtilen süreyi 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: Bir DateTimeOffset değerine belirtilen sayıda yıl 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: Bir DateTimeOffset değerine eşzamansız olarak belirtilen sayıda saat ekler.
• $Calendar.AddDaysAsync: Bir DateTimeOffset değerine eşzamansız olarak belirtilen sayıda gün ekler.
• $Calendar.AddMonthsAsync: Bir DateTimeOffset değerine eşzamansız olarak belirtilen sayıda ay ekler.
• $Calendar.AddTimeSpanAsync: Bir DateTimeOffset değerine eşzamansız olarak belirtilen zaman aralığını ekler.
• $Calendar.AddYearsAsync: Bir DateTimeOffset değerine eşzamansız olarak belirtilen sayıda yıl ekler.
• $Calendar.SubtractAsync: Bir DateTimeOffset değerini diğerinden çıkarır ve saat cinsinden farkı eşzamansız olarak döndürür.

Saat Dilimleri¶

• $Calendar.ChangeTimeZone: Belirtilen saat dilimi farkını içeren yeni bir DateTimeOffset döndürür.
• $Calendar.GetTimeZone: Belirtilen DateTimeOffset değerinin saat dilimi bilgilerini döndürür.

Asenkron Saat Dilimleri¶

• $Calendar.ChangeTimeZoneAsync: Belirtilen saat dilimi farkını içeren yeni bir DateTimeOffset eşzamansız olarak döndürür.
• $Calendar.GetTimeZoneAsync: Bir DateTimeOffset değerinin saat dilimi farkını eşzamansız 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: Bu takvimin bir tarihte kapsadığı saat sayısını döndürür.
• $Calendar.GetTodayAsync: Belirtilen saat dilimindeki geçerli tarihi eşzamansız olarak döndürür.

Oluşturma ve Ön Ayarlar¶

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