Class Calendar

اسم الفضاء : Aspose.Tasks تجميع: Aspose.Tasks.dll (25.4.0)

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

[ClassInterface(ClassInterfaceType.AutoDual)]
public class Calendar : ICalendar

Inheritance

object ← Calendar

Implements

ICalendar

الأعضاء الموروثين

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

Examples

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

// create empty calendar
Calendar calendar = new Calendar("New calendar");
// adds default working days (8 working hours from 9:00 to 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// create new new working day
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Sets working time. Only time part of DateTime is important
    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));
// adds weekend
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));

[VB]
       ' create empty calendar
       Dim calendar As Calendar =  New Calendar("New calendar")
       ' adds default working days (8 working hours from 9:00 to 17:00)
       calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday))
       calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday))
       calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday))
       ' create new new working day
       Dim myWeekDay As WeekDay =  New WeekDay(DayType.Thursday)
       ' Sets working time. Only time part of DateTime is important
           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))
       ' adds weekend
       calendar.Days.Add(New WeekDay(DayType.Saturday))
       calendar.Days.Add(New WeekDay(DayType.Sunday))

Remarks

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

Properties

BaseCalendar

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

public Calendar BaseCalendar { get; set; }

قيمة الممتلكات

Calendar

Exceptions

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

public CalendarExceptionCollection Exceptions { get; }

قيمة الممتلكات

CalendarExceptionCollection

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

Methods

Delete()

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

public void Delete()

Equals(الموضوع)

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

public override bool Equals(object obj)

Parameters

obj object

موضوع مقارنة مع هذه الحالة.

Returns

bool

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

GetFinishDateByStartAndWork(تاريخ، مدة)

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

public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)

Parameters

start DateTime

تاريخ البدء

work Duration

مدة العمل .

Returns

DateTime

انتهاء الموعد

GetFinishDateByStartAndWork(التاريخ، TimeSpan)

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

public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)

Parameters

start DateTime

تاريخ البدء

work TimeSpan

مدة العمل .

Returns

DateTime

انتهاء الموعد

GetHashCode()

إرجاع رمز الهاش على سبيل المثال من الصف.

public override int GetHashCode()

Returns

int

كود هاتش لهذا الكائن.

GetIntersectionCalendar(الجدول الزمني، التقويم)

يحصل على Aspose.Tasks.مثل التقويم الذي يمكن استخدامه لإجراء الحسابات على مفترق طرق الجدول الزمني للعمل من 2 تقويمي.

public static ICalendar GetIntersectionCalendar(Calendar calendar1, Calendar calendar2)

Parameters

calendar1 Calendar

التقويم الأول

calendar2 Calendar

التقويم الثاني

Returns

ICalendar

تطبيق واجهة ICalendar.

Exceptions

ArgumentNullException

عندما يكون أي من الحجج صفر.

GetNextWorkingDayStart(DateTime)

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

public DateTime GetNextWorkingDayStart(DateTime date)

Parameters

date DateTime

يبدأ موعد الوصول إلى يوم العمل التالي.

Returns

DateTime

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

GetPreviousWorkingDayEnd(DateTime)

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

public DateTime GetPreviousWorkingDayEnd(DateTime date)

Parameters

date DateTime

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

Returns

DateTime

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

GetStartDateFromFinishAndDuration(تاريخ، مدة)

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

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)

Parameters

finish DateTime

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

duration Duration

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

Returns

DateTime

تاريخ بدء الحساب.

GetStartDateFromFinishAndDuration(التاريخ، TimeSpan)

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

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)

Parameters

finish DateTime

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

duration TimeSpan

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

Returns

DateTime

تاريخ بدء الحساب.

GetTaskFinishDateFromDuration(المهمة، TimeSpan)

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

public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)

Parameters

task Task

المهمة لحساب موعد الانتهاء.

duration TimeSpan

مدة الحساب.

Returns

DateTime

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

Remarks

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

GetWorkingHours(تاريخ، تاريخ، تاريخ)

الوحدة العملية العودة - بدء و انتهاء و مدة ساعات العمل لفترة الزمن المحددة.

public WorkUnit GetWorkingHours(DateTime start, DateTime finish)

Parameters

start DateTime

تاريخ بدء الفجوة.

finish DateTime

انتهاء الموعد النهائي للفترة.

Returns

WorkUnit

الحالة Aspose.Tasks.WorkUnit فئة تحتوي على بدء ونهاية ومدة ساعات العمل.

GetWorkingHours(DateTime)

إرجاع عدد ساعات العمل في التاريخ المحدد.

public TimeSpan GetWorkingHours(DateTime dt)

Parameters

dt DateTime

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

Returns

TimeSpan

ساعات العمل في الموعد المحدد.

GetWorkingTimes(DateTime)

العودة Aspose.Tasks.WorkingTimeمجموعة ساعات العمل للتواريخ المحددة.

public WorkingTimeCollection GetWorkingTimes(DateTime dt)

Parameters

dt DateTime

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

Returns

WorkingTimeCollection

مجموعة من WL29_.WorkingTime الحالات.

IsDayWorking(DateTime)

تحديد ما إذا كان اليوم المحدد هو يوم عمل حسب التقويم.

public bool IsDayWorking(DateTime dt)

Parameters

dt DateTime

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

Returns

bool

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

Make24HourCalendar(Calendar)

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

public static Calendar Make24HourCalendar(Calendar calendar)

Parameters

calendar Calendar

تقويم لإنشاء تقويم 24 ساعة من.

Returns

Calendar

تقويم 24 ساعة

MakeNightShiftCalendar(Calendar)

يخلق تقويمًا معينًا كقويم تغيير ليلي.

public static Calendar MakeNightShiftCalendar(Calendar calendar)

Parameters

calendar Calendar

تقويم لإنشاء تقويم تغيير الليل.

Returns

Calendar

تقويم التغيير الليلي

MakeStandardCalendar(Calendar)

إنشاء التقويم القياسي الافتراضي.

public static Calendar MakeStandardCalendar(Calendar calendar)

Parameters

calendar Calendar

التقويم لتصنيع التقويم القياسي من.

Returns

Calendar

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