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("New calendar");
// روزهای کاری پیش‌فرض را اضافه می‌کند (۸ ساعت کاری از ۹:۰۰ تا ۱۷:۰۰)
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("New calendar")
       ' روزهای کاری پیش‌فرض را اضافه می‌کند (۸ ساعت کاری از ۹:۰۰ تا ۱۷:۰۰)
       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))

توضیحات

تقویم‌ها برای تعریف زمان‌های کاری و غیرکاری استاندارد استفاده می‌شوند. پروژه‌ها باید یک تقویم پایه داشته باشند. وظایف و منابع می‌توانند تقویم‌های غیرپایه خود را داشته باشند که بر اساس یک تقویم پایه هستند.

ویژگی‌ها

BaseCalendar

تقویم پایه‌ای که این تقویم به آن وابسته است را دریافت یا تنظیم می‌کند. فقط در صورتی که تقویم یک تقویم پایه نباشد، قابل استفاده است.

public Calendar BaseCalendar { get; set; }

مقدار ویژگی

Calendar

Exceptions

شی CalendarExceptionCollection را دریافت می‌کند. مجموعه‌ای از استثنائات که با تقویم مرتبط است.

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

مجموعه WeekDays برای این تقویم را دریافت می‌کند. مجموعه‌ای از روزهای هفته که تقویم را تعریف می‌کند.

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 یک Calendar باشد که مقدار 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)

تاریخ شروع را بر اساس تاریخ پایان و مدت زمان مشخص شده برمی‌گرداند.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)

پارامترها

finish DateTime

تاریخ پایان مشخص شده.

duration Duration

مدت زمان کار مشخص شده.

برمی‌گرداند

DateTime

تاریخ شروع محاسبه شده.

GetStartDateFromFinishAndDuration(DateTime, TimeSpan)

تاریخ شروع را بر اساس تاریخ پایان و مدت زمان مشخص شده برمی‌گرداند.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)

پارامترها

finish DateTime

تاریخ پایان مشخص شده.

duration TimeSpan

مدت زمان کار مشخص شده.

برمی‌گرداند

DateTime

تاریخ شروع محاسبه شده.

GetTaskFinishDateFromDuration(Task, TimeSpan)

تاریخ و زمان پایان وظیفه را از تاریخ شروع، بخش‌های تقسیم شده و مدت زمان آن محاسبه می‌کند.

public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)

پارامترها

task Task

وظیفه‌ای که باید تاریخ پایان آن را دریافت کند.

duration TimeSpan

مدت زمان وظیفه برای تقسیم.

برمی‌گرداند

DateTime

تاریخ پایان وظیفه.

توضیحات

اگر وظیفه خلاصه، null باشد یا تاریخ شروع آن تنظیم نشده باشد، DateTime.MinValue را برمی‌گرداند.

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)

یک تقویم داده شده را به یک تقویم ۲۴ ساعته تبدیل می‌کند. تقویم ۲۴ ساعته تقویمی است که هر روز هفته با ساعات کاری شبانه‌روزی کار می‌کند.

public static Calendar Make24HourCalendar(Calendar calendar)

پارامترها

calendar Calendar

تقویمی که باید به تقویم ۲۴ ساعته تبدیل شود.

برمی‌گرداند

Calendar

تقویم ۲۴ ساعته.

MakeNightShiftCalendar(Calendar)

یک تقویم داده شده را به عنوان تقویم شیفت شب تبدیل می‌کند.

public static Calendar MakeNightShiftCalendar(Calendar calendar)

پارامترها

calendar Calendar

تقویمی که باید به تقویم شیفت شب تبدیل شود.

برمی‌گرداند

Calendar

تقویم شیفت شب.

MakeStandardCalendar(Calendar)

تقویم استاندارد پیش‌فرض را ایجاد می‌کند.

public static Calendar MakeStandardCalendar(Calendar calendar)

پارامترها

calendar Calendar

تقویمی که باید از آن تقویم استاندارد ایجاد شود.

برمی‌گرداند

Calendar

تقویمی با ۵ روز کاری (دوشنبه تا جمعه) با ساعات کاری ۸-۱۲ و ۱۳-۱۷.