Class Calendar

Calendar class

يمثل التقويم المستخدم في مشروع .

public class Calendar

الخصائص

اسموصف
BaseCalendar { get; set; }الحصول على أو تعيين التقويم الأساسي الذي يعتمد عليه هذا التقويم. ينطبق فقط إذا لم يكن التقويم تقويمًا أساسيًا .
Exceptions { get; }الحصول على كائن CalendarExceptionCollection . مجموعة الاستثناءات المرتبطة بالتقويم.
IsBaseCalendar { get; }يحصل على قيمة تشير إلى ما إذا كان التقويم تقويمًا أساسيًا .
IsBaselineCalendar { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان التقويم تقويمًا أساسيًا .
Name { get; set; }الحصول على أو تحديد اسم التقويم .
Uid { get; set; }الحصول على أو تحديد المعرف الفريد للتقويم.
WeekDays { get; }الحصول على مجموعة أيام الأسبوع لهذا التقويم . مجموعة أيام الأسبوع التي تحدد التقويم.
WorkWeeks { get; }Gets WorkWeekCollections object. مجموعة أسابيع العمل المرتبطة بالتقويم.

طُرق

اسموصف
static Make24HourCalendar(Calendar)جعل التقويم المحدد 24 ساعة. تقويم 24 ساعة هو تقويم يعمل فيه كل يوم من أيام الأسبوع بساعات عمل على مدار الساعة .
static MakeNightShiftCalendar(Calendar)إنشاء تقويم معين كتقويم نوبة ليلية .
static MakeStandardCalendar(Calendar)إنشاء تقويم قياسي افتراضي .
Delete()إزالة التقويم من المشروع .
override Equals(object)إرجاع قيمة تشير إلى ما إذا كان هذا المثيل يساوي كائنًا محددًا.
GetFinishDateByStartAndWork(DateTime, Duration)حساب التاريخ الذي يمر فيه المقدار المحدد من وقت العمل وفقًا للتقويم.
GetFinishDateByStartAndWork(DateTime, TimeSpan)حساب التاريخ الذي يمر فيه المقدار المحدد من وقت العمل وفقًا للتقويم.
override GetHashCode()إرجاع رمز تجزئة لمثيل الفئة.
GetNextWorkingDayStart(DateTime)يبدأ حساب يوم العمل التالي من التاريخ.
GetPreviousWorkingDayEnd(DateTime)حساب نهاية تاريخ العمل السابق من التاريخ المحدد.
GetStartDateFromFinishAndDuration(DateTime, Duration)إرجاع تاريخ البدء بناءً على تاريخ الانتهاء والمدة المحددين.
GetStartDateFromFinishAndDuration(DateTime, TimeSpan)إرجاع تاريخ البدء بناءً على تاريخ الانتهاء والمدة المحددين.
GetTaskFinishDateFromDuration(Task, TimeSpan)حساب تاريخ انتهاء المهمة ووقتها من تاريخ البدء والأجزاء المنقسمة والمدة.
GetWorkingHours(DateTime)إرجاع مقدار ساعات العمل في التاريخ.
GetWorkingHours(DateTime, DateTime)إرجاع ساعات العمل للتواريخ المحددة.
GetWorkingTimes(DateTime)عوائدWorkingTimeCollection من أوقات العمل في التاريخ المحدد.
IsDayWorking(DateTime)لتحديد ما إذا كان اليوم هو يوم عمل.

ملاحظات

يتم استخدام التقويمات لتحديد أوقات العمل وأوقات غير العمل القياسية. يجب أن يكون للمشروعات تقويم أساسي واحد. يمكن أن تحتوي المهام والموارد على التقويمات غير الأساسية الخاصة بها والتي تستند إلى تقويم أساسي.

أمثلة

كيفية إنشاء تقويم بسيط من البداية .

[C#]
// إنشاء تقويم فارغ
Calendar calendar = new Calendar("New calendar");
// يضيف أيام العمل الافتراضية (8 ساعات عمل من 9:00 إلى 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// إنشاء يوم عمل جديد
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// يعين وقت العمل. فقط جزء الوقت من DateTime مهم
    WorkingTime wt1 = new WorkingTime();
    wt1.FromTime = new DateTime(1, 1, 1, 6, 0, 0, 0);
    wt1.ToTime = new DateTime(1, 1, 1, 12, 0, 0, 0);
    WorkingTime wt2 = new WorkingTime();
    wt2.FromTime = new DateTime(1, 1, 1, 14, 0, 0, 0);
    wt2.ToTime = new DateTime(1, 1, 1, 18, 0, 0, 0);
    myWeekDay.WorkingTimes.Add(wt1);
    myWeekDay.WorkingTimes.Add(wt2);
    myWeekDay.DayWorking = true;
calendar.Days.Add(myWeekDay);
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Friday));
// يضيف عطلة نهاية الأسبوع
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));

[VB]
' إنشاء تقويم فارغ
Dim calendar As Calendar =  New Calendar("New calendar")
' إضافة أيام عمل افتراضية (8 ساعات عمل من 9:00 إلى 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday))
' إنشاء يوم عمل جديد
Dim myWeekDay As WeekDay =  New WeekDay(DayType.Thursday)
' يحدد وقت العمل. فقط جزء الوقت من DateTime مهم
    Dim wt1 As WorkingTime =  New WorkingTime()
    wt1.FromTime = New DateTime(1, 1, 1, 6, 0, 0, 0)
    wt1.ToTime = New DateTime(1, 1, 1, 12, 0, 0, 0)
    Dim wt2 As WorkingTime =  New WorkingTime()
    wt2.FromTime = New DateTime(1, 1, 1, 14, 0, 0, 0)
    wt2.ToTime = New DateTime(1, 1, 1, 18, 0, 0, 0)
    myWeekDay.WorkingTimes.Add(wt1)
    myWeekDay.WorkingTimes.Add(wt2)
    myWeekDay.DayWorking = True
calendar.Days.Add(myWeekDay)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Friday))
' يضيف عطلة نهاية الأسبوع
calendar.Days.Add(New WeekDay(DayType.Saturday))
calendar.Days.Add(New WeekDay(DayType.Sunday))

أنظر أيضا

Enum CalculationType Class CalendarCollection