Class Calendar
Namespace: Aspose.Tasks
Assembly: Aspose.Tasks.dll (25.2.0)
מייצג לוח שנה שמשמש בפרויקט.
[ClassInterface(ClassInterfaceType.AutoDual)]
public class 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))
הערות
לוחות שנה משמשים כדי להגדיר שעות עבודה ולא עבודה סטנדרטיות.
לפרויקטים חייב להיות לוח שנה בסיסי אחד. משימות ומשאבים יכולים להיות
לוחות שנה לא בסיסיים משלהם שמתבססים על לוח שנה בסיסי.
מאפיינים
BaseCalendar
מקבל או קובע את לוח השנה הבסיסי שעליו מתבסס לוח שנה זה.
רק רלוונטי אם לוח השנה אינו לוח שנה בסיסי.
public Calendar BaseCalendar { get; set; }
ערך מאפיין
Exceptions
מקבל אובייקט CalendarExceptionCollection.
הקולקציה של החריגים הקשורים ללוח השנה.
public CalendarExceptionCollection Exceptions { get; }
ערך מאפיין
Guid
מקבל את ה-Guid של לוח השנה.
public string Guid { get; }
ערך מאפיין
IsBaseCalendar
מקבל ערך המצביע האם לוח השנה הוא לוח שנה בסיסי.
public bool IsBaseCalendar { get; }
ערך מאפיין
IsBaselineCalendar
מקבל או קובע ערך המצביע האם לוח השנה הוא לוח שנה בסיסי.
public bool IsBaselineCalendar { get; set; }
ערך מאפיין
Name
מקבל או קובע את שם לוח השנה.
public string Name { get; set; }
ערך מאפיין
Uid
מקבל או קובע את המזהה הייחודי של לוח השנה.
public int Uid { get; set; }
ערך מאפיין
WeekDays
מקבל את WeekDaysCollection עבור לוח שנה זה.
הקולקציה של ימי השבוע שמגדירה את לוח השנה.
public WeekDayCollection WeekDays { get; }
ערך מאפיין
WorkWeeks
מקבל את אובייקט WorkWeekCollections.
הקולקציה של שבועות עבודה הקשורים ללוח השנה.
public WorkWeekCollection WorkWeeks { get; }
ערך מאפיין
שיטות
Delete()
מסיר את לוח השנה מהפרויקט.
public void Delete()
Equals(object)
מחזיר ערך המצביע האם מופע זה שווה לאובייקט ספציפי.
public override bool Equals(object obj)
פרמטרים
obj
object
האובייקט להשוואה עם מופע זה.
מחזיר
True אם o הוא לוח שנה שיש לו את ערך ה-Uid זהה למופע זה; אחרת, false.
GetFinishDateByStartAndWork(DateTime, Duration)
מחשב את התאריך שבו כמות העבודה המצוינת תעבור בהתאם ללוח השנה.
public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)
פרמטרים
start
DateTime
תאריך התחלה.
work
Duration
משך העבודה.
מחזיר
תאריך סיום.
GetFinishDateByStartAndWork(DateTime, TimeSpan)
מחשב את התאריך שבו כמות העבודה המצוינת תעבור בהתאם ללוח השנה.
public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)
פרמטרים
start
DateTime
תאריך התחלה.
work
TimeSpan
משך העבודה.
מחזיר
תאריך סיום.
GetHashCode()
מחזיר קוד Hash עבור מופע של המחלקה.
public override int GetHashCode()
מחזיר
קוד Hash עבור אובייקט זה.
GetNextWorkingDayStart(DateTime)
מחשב את תחילת יום העבודה הבא מהתאריך.
public DateTime GetNextWorkingDayStart(DateTime date)
פרמטרים
date
DateTime
התאריך לקבלת תחילת יום העבודה הבא.
מחזיר
תחילת יום העבודה הבא System.DateTime.
GetPreviousWorkingDayEnd(DateTime)
מחשב את סיום יום העבודה הקודם מהתאריך המצויין.
public DateTime GetPreviousWorkingDayEnd(DateTime date)
פרמטרים
date
DateTime
המופע המצויין של מבנה System.DateTime.
מחזיר
סיום יום העבודה הקודם System.DateTime
GetStartDateFromFinishAndDuration(DateTime, Duration)
מחזיר את StartDate על בסיס FinishDate ו-Duration המצוינים.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)
פרמטרים
finish
DateTime
תאריך הסיום המצויין.
duration
Duration
משך העבודה המצויין.
מחזיר
StartDate מחושב.
GetStartDateFromFinishAndDuration(DateTime, TimeSpan)
מחזיר את StartDate על בסיס FinishDate ו-Duration המצוינים.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)
פרמטרים
finish
DateTime
תאריך הסיום המצויין.
duration
TimeSpan
משך העבודה המצויין.
מחזיר
StartDate מחושב.
GetTaskFinishDateFromDuration(Task, TimeSpan)
מחשב את תאריך ושעת סיום המשימה מהתאריך ההתחלתי שלה, חלקים מפוצלים והמשך.
public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)
פרמטרים
task
Task
המשימה לקבלת תאריך הסיום עבורה.
duration
TimeSpan
משך המשימה לפיצול.
מחזיר
תאריך הסיום של המשימה.
הערות
מחזיר DateTime.MinValue אם המשימה היא סיכום, null או אם תאריך ההתחלה שלה לא הוגדר.
GetWorkingHours(DateTime, DateTime)
מחזיר את שעות העבודה עבור התאריכים המצוינים.
public WorkUnit GetWorkingHours(DateTime start, DateTime finish)
פרמטרים
start
DateTime
תאריך התחלה.
finish
DateTime
תאריך סיום.
מחזיר
שעות עבודה.
GetWorkingHours(DateTime)
מחזיר את כמות שעות העבודה בתאריך.
public TimeSpan GetWorkingHours(DateTime dt)
פרמטרים
dt
DateTime
התאריך לקבלת שעות העבודה עבורו.
מחזיר
שעות עבודה.
GetWorkingTimes(DateTime)
מחזיר את Aspose.Tasks.WorkingTimeCollection של שעות עבודה עבור התאריך המצויין.
public WorkingTimeCollection GetWorkingTimes(DateTime dt)
פרמטרים
dt
DateTime
התאריך לקבלת שעות העבודה עבורו.
מחזיר
רשימה של Aspose.Tasks.WorkingTime.
IsDayWorking(DateTime)
קובע האם היום הוא יום עבודה.
public bool IsDayWorking(DateTime dt)
פרמטרים
dt
DateTime
התאריך לבדוק אם הוא יום עבודה.
מחזיר
True אם היום הוא יום עבודה.
Make24HourCalendar(Calendar)
ממיר לוח שנה נתון ללוח שנה של 24 שעות.
לוח שנה של 24 שעות הוא לוח שנה שבו כל יום בשבוע הוא יום עבודה עם שעות עבודה רצופות.
public static Calendar Make24HourCalendar(Calendar calendar)
פרמטרים
calendar
Calendar
לוח שנה להפוך ללוח שנה של 24 שעות.
מחזיר
לוח שנה של 24 שעות.
MakeNightShiftCalendar(Calendar)
ממיר לוח שנה נתון ללוח שנה של משמרת לילה.
public static Calendar MakeNightShiftCalendar(Calendar calendar)
פרמטרים
calendar
Calendar
לוח שנה להפוך ללוח שנה של משמרת לילה.
מחזיר
לוח שנה של משמרת לילה.
MakeStandardCalendar(Calendar)
יוצר לוח שנה סטנדרטי ברירת מחדל.
public static Calendar MakeStandardCalendar(Calendar calendar)
פרמטרים
calendar
Calendar
לוח שנה להפוך ללוח שנה סטנדרטי.
מחזיר
לוח שנה עם 5 ימי עבודה (שני-שישי) עם שעות עבודה 8-12 ו-13-17.