Class Calendar
Namespace: Aspose.Tasks
Assembly: Aspose.Tasks.dll (25.2.0)
Đại diện cho một lịch sử dụng trong một dự án.
[ClassInterface(ClassInterfaceType.AutoDual)]
public class CalendarKế thừa
Các thành viên kế thừa
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Ví dụ
Cách tạo lịch đơn giản từ đầu.
// tạo lịch trống
Calendar calendar = new Calendar("Lịch mới");
// thêm các ngày làm việc mặc định (8 giờ làm việc từ 9:00 đến 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// tạo ngày làm việc mới
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Thiết lập thời gian làm việc. Chỉ phần thời gian của DateTime là quan trọng
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));
// thêm cuối tuần
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));csharp [VB] ’ tạo lịch trống Dim calendar As Calendar = New Calendar(“Lịch mới”) ’ thêm các ngày làm việc mặc định (8 giờ làm việc từ 9:00 đến 17:00) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday)) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday)) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday)) ’ tạo ngày làm việc mới Dim myWeekDay As WeekDay = New WeekDay(DayType.Thursday) ’ Thiết lập thời gian làm việc. Chỉ phần thời gian của DateTime là quan trọng 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)) ’ thêm cuối tuần calendar.Days.Add(New WeekDay(DayType.Saturday)) calendar.Days.Add(New WeekDay(DayType.Sunday))
## Nhận xét
Lịch được sử dụng để xác định thời gian làm việc và không làm việc tiêu chuẩn.
Các dự án phải có một lịch cơ bản. Các nhiệm vụ và tài nguyên có thể có
các lịch không phải cơ bản riêng dựa trên một lịch cơ bản.
## Thuộc tính
### <a id="Aspose_Tasks_Calendar_BaseCalendar"></a> BaseCalendar
Lấy hoặc thiết lập lịch cơ bản mà lịch này phụ thuộc vào.
Chỉ áp dụng nếu lịch không phải là lịch cơ bản.
```csharp
public Calendar BaseCalendar { get; set; }Giá trị thuộc tính
Exceptions
Lấy đối tượng CalendarExceptionCollection.
Bộ sưu tập các ngoại lệ liên quan đến lịch.
public CalendarExceptionCollection Exceptions { get; }Giá trị thuộc tính
Guid
Lấy Guid của lịch.
public string Guid { get; }Giá trị thuộc tính
IsBaseCalendar
Lấy giá trị cho biết liệu lịch có phải là lịch cơ bản hay không.
public bool IsBaseCalendar { get; }Giá trị thuộc tính
IsBaselineCalendar
Lấy hoặc thiết lập giá trị cho biết liệu lịch có phải là lịch cơ bản hay không.
public bool IsBaselineCalendar { get; set; }Giá trị thuộc tính
Name
Lấy hoặc thiết lập tên của lịch.
public string Name { get; set; }Giá trị thuộc tính
Uid
Lấy hoặc thiết lập định danh duy nhất của lịch.
public int Uid { get; set; }Giá trị thuộc tính
WeekDays
Lấy WeekDaysCollection cho lịch này.
Bộ sưu tập các ngày trong tuần xác định lịch.
public WeekDayCollection WeekDays { get; }Giá trị thuộc tính
WorkWeeks
Lấy đối tượng WorkWeekCollections.
Bộ sưu tập các tuần làm việc liên quan đến lịch.
public WorkWeekCollection WorkWeeks { get; }Giá trị thuộc tính
Phương thức
Delete()
Xóa lịch khỏi dự án.
public void Delete()Equals(object)
Trả về giá trị cho biết liệu thể hiện này có bằng một đối tượng được chỉ định hay không.
public override bool Equals(object obj)Tham số
obj object
Đối tượng để so sánh với thể hiện này.
Trả về
True nếu o là một Calendar có giá trị Uid giống như thể hiện này; ngược lại, false.
GetFinishDateByStartAndWork(DateTime, Duration)
Tính toán ngày khi lượng thời gian làm việc được chỉ định sẽ trôi qua theo lịch.
public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)Tham số
start DateTime
Ngày bắt đầu.
work Duration
Thời gian làm việc.
Trả về
Ngày kết thúc.
GetFinishDateByStartAndWork(DateTime, TimeSpan)
Tính toán ngày khi lượng thời gian làm việc được chỉ định sẽ trôi qua theo lịch.
public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)Tham số
start DateTime
Ngày bắt đầu.
work TimeSpan
Thời gian làm việc.
Trả về
Ngày kết thúc.
GetHashCode()
Trả về mã băm cho thể hiện của lớp.
public override int GetHashCode()Trả về
mã băm cho đối tượng này.
GetNextWorkingDayStart(DateTime)
Tính toán ngày làm việc tiếp theo bắt đầu từ ngày.
public DateTime GetNextWorkingDayStart(DateTime date)Tham số
date DateTime
Ngày để lấy ngày làm việc tiếp theo.
Trả về
Ngày làm việc tiếp theo System.DateTime.
GetPreviousWorkingDayEnd(DateTime)
Tính toán ngày làm việc trước đó kết thúc từ ngày được chỉ định.
public DateTime GetPreviousWorkingDayEnd(DateTime date)Tham số
date DateTime
thể hiện được chỉ định của cấu trúc System.DateTime.
Trả về
Ngày làm việc trước đó bắt đầu System.DateTime
GetStartDateFromFinishAndDuration(DateTime, Duration)
Trả về StartDate dựa trên FinishDate và Duration được chỉ định.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)Tham số
finish DateTime
Ngày kết thúc được chỉ định.
duration Duration
Thời gian làm việc được chỉ định.
Trả về
Calculated StartDate.
GetStartDateFromFinishAndDuration(DateTime, TimeSpan)
Trả về StartDate dựa trên FinishDate và Duration được chỉ định.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)Tham số
finish DateTime
Ngày kết thúc được chỉ định.
duration TimeSpan
Thời gian làm việc được chỉ định.
Trả về
Calculated StartDate.
GetTaskFinishDateFromDuration(Task, TimeSpan)
Tính toán ngày và giờ kết thúc của nhiệm vụ từ ngày bắt đầu, các phần đã phân chia và thời gian.
public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)Tham số
task Task
Nhiệm vụ để lấy ngày kết thúc.
duration TimeSpan
Thời gian của nhiệm vụ để phân chia.
Trả về
Ngày kết thúc của nhiệm vụ.
Nhận xét
Trả về DateTime.MinValue nếu nhiệm vụ là tổng hợp, null hoặc ngày bắt đầu của nó không được thiết lập.
GetWorkingHours(DateTime, DateTime)
Trả về giờ làm việc cho các ngày được chỉ định.
public WorkUnit GetWorkingHours(DateTime start, DateTime finish)Tham số
start DateTime
Ngày bắt đầu.
finish DateTime
Ngày kết thúc.
Trả về
Giờ làm việc.
GetWorkingHours(DateTime)
Trả về số giờ làm việc tại ngày.
public TimeSpan GetWorkingHours(DateTime dt)Tham số
dt DateTime
Ngày để lấy giờ làm việc.
Trả về
Giờ làm việc.
GetWorkingTimes(DateTime)
Trả về Aspose.Tasks.WorkingTimeCollection của các thời gian làm việc cho ngày được chỉ định.
public WorkingTimeCollection GetWorkingTimes(DateTime dt)Tham số
dt DateTime
Ngày để lấy thời gian làm việc.
Trả về
Danh sách Aspose.Tasks.WorkingTime.
IsDayWorking(DateTime)
Xác định xem ngày có phải là ngày làm việc hay không.
public bool IsDayWorking(DateTime dt)Tham số
dt DateTime
Ngày để kiểm tra xem có phải là ngày làm việc hay không.
Trả về
True nếu ngày là ngày làm việc.
Make24HourCalendar(Calendar)
Biến một Lịch cho trước thành Lịch 24 giờ.
Lịch 24 giờ là một Lịch mà mọi ngày trong tuần đều làm việc với giờ làm việc liên tục.
public static Calendar Make24HourCalendar(Calendar calendar)Tham số
calendar Calendar
Lịch để biến thành Lịch 24 giờ.
Trả về
Lịch 24 giờ.
MakeNightShiftCalendar(Calendar)
Biến một Lịch cho trước thành Lịch ca đêm.
public static Calendar MakeNightShiftCalendar(Calendar calendar)Tham số
calendar Calendar
Lịch để biến thành Lịch ca đêm.
Trả về
Lịch ca đêm.
MakeStandardCalendar(Calendar)
Tạo lịch tiêu chuẩn mặc định.
public static Calendar MakeStandardCalendar(Calendar calendar)Tham số
calendar Calendar
Lịch để biến thành lịch tiêu chuẩn.
Trả về
Lịch với 5 ngày làm việc (Thứ Hai - Thứ Sáu) với thời gian làm việc từ 8-12 và 13-17.
