Class Calendar

Namespace: Aspose.Tasks
Assembly: Aspose.Tasks.dll (25.2.0)

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

[ClassInterface(ClassInterfaceType.AutoDual)]
public class Calendar

الوراثة

object ← Calendar

الأعضاء الموروثة

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

أمثلة

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

// إنشاء تقويم فارغ
Calendar 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));

csharp [VB] ’ إنشاء تقويم فارغ Dim calendar As 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))

## ملاحظات

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

## الخصائص

### <a id="Aspose_Tasks_Calendar_BaseCalendar"></a> BaseCalendar

يحصل أو يحدد التقويم الأساسي الذي يعتمد عليه هذا التقويم.  
ينطبق فقط إذا لم يكن التقويم تقويمًا أساسيًا.

```csharp
public Calendar BaseCalendar { get; set; }

قيمة الخاصية

Calendar

Exceptions

يحصل على كائن CalendarExceptionCollection.
مجموعة الاستثناءات المرتبطة بالتقويم.

public CalendarExceptionCollection Exceptions { get; }

قيمة الخاصية

CalendarExceptionCollection

Guid

يحصل على Guid الخاص بالتقويم.

public string Guid { get; }

قيمة الخاصية

string

IsBaseCalendar

يحصل على قيمة تشير إلى ما إذا كان التقويم تقويمًا أساسيًا.

public bool IsBaseCalendar { get; }

قيمة الخاصية

bool

IsBaselineCalendar

يحصل أو يحدد قيمة تشير إلى ما إذا كان التقويم تقويمًا أساسيًا.

public bool IsBaselineCalendar { get; set; }

قيمة الخاصية

bool

Name

يحصل أو يحدد اسم التقويم.

public string Name { get; set; }

قيمة الخاصية

string

Uid

يحصل أو يحدد المعرف الفريد للتقويم.

public int Uid { get; set; }

قيمة الخاصية

int

WeekDays

يحصل على WeekDaysCollection لهذا التقويم.
مجموعة أيام الأسبوع التي تحدد التقويم.

public WeekDayCollection WeekDays { get; }

قيمة الخاصية

WeekDayCollection

WorkWeeks

يحصل على كائن WorkWeekCollections.
مجموعة أسابيع العمل المرتبطة بالتقويم.

public WorkWeekCollection WorkWeeks { get; }

قيمة الخاصية

WorkWeekCollection

الطرق

Delete()

يتم إزالة التقويم من المشروع.

public void Delete()

Equals(object)

يعيد قيمة تشير إلى ما إذا كانت هذه الحالة مساوية لكائن محدد.

public override bool Equals(object obj)

المعلمات

obj object

الكائن الذي سيتم مقارنته مع هذه الحالة.

العائدات

bool

True إذا كان o هو تقويم له نفس قيمة Uid مثل هذه الحالة؛ خلاف ذلك، false.

GetFinishDateByStartAndWork(DateTime, Duration)

يحسب التاريخ الذي سيمر فيه مقدار العمل المحدد وفقًا للتقويم.

public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)

المعلمات

start DateTime

تاريخ البدء.

work Duration

مدة العمل.

العائدات

DateTime

تاريخ الانتهاء.

GetFinishDateByStartAndWork(DateTime, TimeSpan)

يحسب التاريخ الذي سيمر فيه مقدار العمل المحدد وفقًا للتقويم.

public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)

المعلمات

start DateTime

تاريخ البدء.

work TimeSpan

مدة العمل.

العائدات

DateTime

تاريخ الانتهاء.

GetHashCode()

يعيد رمز تجزئة لحالة الفئة.

public override int GetHashCode()

العائدات

int

رمز تجزئة لهذا الكائن.

GetNextWorkingDayStart(DateTime)

يحسب بداية يوم العمل التالي من التاريخ.

public DateTime GetNextWorkingDayStart(DateTime date)

المعلمات

date DateTime

التاريخ للحصول على بداية يوم العمل التالي.

العائدات

DateTime

بداية يوم العمل التالي System.DateTime.

GetPreviousWorkingDayEnd(DateTime)

يحسب نهاية يوم العمل السابق من التاريخ المحدد.

public DateTime GetPreviousWorkingDayEnd(DateTime date)

المعلمات

date DateTime

الحالة المحددة من بنية System.DateTime.

العائدات

DateTime

نهاية يوم العمل السابق System.DateTime.

GetStartDateFromFinishAndDuration(DateTime, Duration)

يعيد StartDate بناءً على FinishDate وDuration المحددين.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)

المعلمات

finish DateTime

تاريخ الانتهاء المحدد.

duration Duration

مدة العمل المحددة.

العائدات

DateTime

StartDate المحسوب.

GetStartDateFromFinishAndDuration(DateTime, TimeSpan)

يعيد StartDate بناءً على FinishDate وDuration المحددين.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)

المعلمات

finish DateTime

تاريخ الانتهاء المحدد.

duration TimeSpan

مدة العمل المحددة.

العائدات

DateTime

StartDate المحسوب.

GetTaskFinishDateFromDuration(Task, TimeSpan)

يحسب تاريخ ووقت انتهاء المهمة من تاريخ بدايتها، والأجزاء المنقسمة، والمدة.

public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)

المعلمات

task Task

المهمة للحصول على تاريخ الانتهاء لها.

duration TimeSpan

مدة المهمة التي سيتم تقسيمها.

العائدات

DateTime

تاريخ انتهاء المهمة.

ملاحظات

يعيد DateTime.MinValue إذا كانت المهمة ملخصًا، أو null، أو لم يتم تعيين تاريخ البدء لها.

GetWorkingHours(DateTime, DateTime)

يعيد ساعات العمل للتواريخ المحددة.

public WorkUnit GetWorkingHours(DateTime start, DateTime finish)

المعلمات

start DateTime

تاريخ البدء.

finish DateTime

تاريخ الانتهاء.

العائدات

WorkUnit

ساعات العمل.

GetWorkingHours(DateTime)

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

public TimeSpan GetWorkingHours(DateTime dt)

المعلمات

dt DateTime

التاريخ للحصول على ساعات العمل له.

العائدات

TimeSpan

ساعات العمل.

GetWorkingTimes(DateTime)

يعيد Aspose.Tasks.WorkingTimeCollection لأوقات العمل للتاريخ المحدد.

public WorkingTimeCollection GetWorkingTimes(DateTime dt)

المعلمات

dt DateTime

التاريخ للحصول على أوقات العمل له.

العائدات

WorkingTimeCollection

قائمة من Aspose.Tasks.WorkingTime.

IsDayWorking(DateTime)

يحدد ما إذا كان اليوم هو يوم عمل.

public bool IsDayWorking(DateTime dt)

المعلمات

dt DateTime

التاريخ للتحقق مما إذا كان اليوم هو يوم عمل.

العائدات

bool

True إذا كان اليوم هو يوم عمل.

Make24HourCalendar(Calendar)

يجعل التقويم المحدد تقويمًا يعمل على مدار 24 ساعة.
تقويم 24 ساعة هو تقويم يكون فيه كل يوم من الأسبوع يوم عمل بساعات عمل مستمرة.

public static Calendar Make24HourCalendar(Calendar calendar)

المعلمات

calendar Calendar

التقويم لجعله تقويم 24 ساعة.

العائدات

Calendar

تقويم 24 ساعة.

MakeNightShiftCalendar(Calendar)

يجعل التقويم المحدد تقويمًا لوردية الليل.

public static Calendar MakeNightShiftCalendar(Calendar calendar)

المعلمات

calendar Calendar

التقويم لجعله تقويم وردية الليل.

العائدات

Calendar

تقويم وردية الليل.

MakeStandardCalendar(Calendar)

ينشئ تقويمًا قياسيًا افتراضيًا.

public static Calendar MakeStandardCalendar(Calendar calendar)

المعلمات

calendar Calendar

التقويم لجعله تقويمًا قياسيًا.

العائدات

Calendar

تقويم يحتوي على 5 أيام عمل (من الاثنين إلى الجمعة) مع أوقات عمل من 8-12 و13-17.