Class Calendar
Namespace: Aspose.Tasks
Assembly: Aspose.Tasks.dll (25.2.0)
Mewakili kalender yang digunakan dalam sebuah proyek.
[ClassInterface(ClassInterfaceType.AutoDual)]
public class Calendar
Pewarisan
Anggota yang Dwarisi
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Contoh
Cara membuat kalender sederhana dari awal.
// buat kalender kosong
Calendar calendar = new Calendar("Kalender Baru");
// menambahkan hari kerja default (8 jam kerja dari 9:00 hingga 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// buat hari kerja baru
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Mengatur waktu kerja. Hanya bagian waktu dari DateTime yang penting
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));
// menambahkan akhir pekan
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));
```````csharp
[VB]
' buat kalender kosong
Dim calendar As Calendar = New Calendar("Kalender Baru")
' menambahkan hari kerja default (8 jam kerja dari 9:00 hingga 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday))
' buat hari kerja baru
Dim myWeekDay As WeekDay = New WeekDay(DayType.Thursday)
' Mengatur waktu kerja. Hanya bagian waktu dari DateTime yang penting
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))
' menambahkan akhir pekan
calendar.Days.Add(New WeekDay(DayType.Saturday))
calendar.Days.Add(New WeekDay(DayType.Sunday))
Keterangan
Kalender digunakan untuk mendefinisikan waktu kerja dan waktu tidak kerja yang standar.
Proyek harus memiliki satu kalender dasar. Tugas dan sumber daya dapat memiliki kalender non-dasar mereka sendiri yang berdasarkan pada kalender dasar.
Properti
BaseCalendar
Mendapatkan atau mengatur kalender dasar yang bergantung pada kalender ini.
Hanya berlaku jika kalender bukan kalender dasar.
public Calendar BaseCalendar { get; set; }
Nilai Properti
Exceptions
Mendapatkan objek CalendarExceptionCollection.
Koleksi pengecualian yang terkait dengan kalender.
public CalendarExceptionCollection Exceptions { get; }
Nilai Properti
Guid
Mendapatkan Guid kalender.
public string Guid { get; }
Nilai Properti
IsBaseCalendar
Mendapatkan nilai yang menunjukkan apakah kalender adalah kalender dasar.
public bool IsBaseCalendar { get; }
Nilai Properti
IsBaselineCalendar
Mendapatkan atau mengatur nilai yang menunjukkan apakah kalender adalah kalender baseline.
public bool IsBaselineCalendar { get; set; }
Nilai Properti
Name
Mendapatkan atau mengatur nama kalender.
public string Name { get; set; }
Nilai Properti
Uid
Mendapatkan atau mengatur pengidentifikasi unik kalender.
public int Uid { get; set; }
Nilai Properti
WeekDays
Mendapatkan WeekDaysCollection untuk kalender ini.
Koleksi hari kerja yang mendefinisikan kalender.
public WeekDayCollection WeekDays { get; }
Nilai Properti
WorkWeeks
Mendapatkan objek WorkWeekCollections.
Koleksi minggu kerja yang terkait dengan kalender.
public WorkWeekCollection WorkWeeks { get; }
Nilai Properti
Metode
Delete()
Menghapus kalender dari proyek.
public void Delete()
Equals(object)
Mengembalikan nilai yang menunjukkan apakah instansi ini sama dengan objek yang ditentukan.
public override bool Equals(object obj)
Parameter
obj
object
Objek untuk dibandingkan dengan instansi ini.
Mengembalikan
True jika o adalah Calendar yang memiliki nilai Uid yang sama dengan instansi ini; jika tidak, false.
GetFinishDateByStartAndWork(DateTime, Duration)
Menghitung tanggal ketika jumlah waktu kerja yang ditentukan akan berlalu sesuai dengan kalender.
public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)
Parameter
start
DateTime
Tanggal mulai.
work
Duration
Durasi kerja.
Mengembalikan
Tanggal selesai.
GetFinishDateByStartAndWork(DateTime, TimeSpan)
Menghitung tanggal ketika jumlah waktu kerja yang ditentukan akan berlalu sesuai dengan kalender.
public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)
Parameter
start
DateTime
Tanggal mulai.
work
TimeSpan
Durasi kerja.
Mengembalikan
Tanggal selesai.
GetHashCode()
Mengembalikan kode hash untuk instansi kelas.
public override int GetHashCode()
Mengembalikan
kode hash untuk objek ini.
GetNextWorkingDayStart(DateTime)
Menghitung hari kerja berikutnya mulai dari tanggal.
public DateTime GetNextWorkingDayStart(DateTime date)
Parameter
date
DateTime
Tanggal untuk mendapatkan awal hari kerja berikutnya.
Mengembalikan
Awal hari kerja berikutnya System.DateTime.
GetPreviousWorkingDayEnd(DateTime)
Menghitung akhir hari kerja sebelumnya dari tanggal yang ditentukan.
public DateTime GetPreviousWorkingDayEnd(DateTime date)
Parameter
date
DateTime
instansi yang ditentukan dari struct System.DateTime.
Mengembalikan
Akhir hari kerja sebelumnya System.DateTime
GetStartDateFromFinishAndDuration(DateTime, Duration)
Mengembalikan StartDate berdasarkan FinishDate dan Durasi yang ditentukan.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)
Parameter
finish
DateTime
Tanggal selesai yang ditentukan.
duration
Duration
Durasi kerja yang ditentukan.
Mengembalikan
StartDate yang dihitung.
GetStartDateFromFinishAndDuration(DateTime, TimeSpan)
Mengembalikan StartDate berdasarkan FinishDate dan Durasi yang ditentukan.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)
Parameter
finish
DateTime
Tanggal selesai yang ditentukan.
duration
TimeSpan
Durasi kerja yang ditentukan.
Mengembalikan
StartDate yang dihitung.
GetTaskFinishDateFromDuration(Task, TimeSpan)
Menghitung tanggal dan waktu selesai tugas dari tanggal mulai, bagian yang terpisah dan durasi.
public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)
Parameter
task
Task
Tugas untuk mendapatkan tanggal selesai.
duration
TimeSpan
Durasi tugas untuk dibagi.
Mengembalikan
Tanggal selesai tugas.
Keterangan
Mengembalikan DateTime.MinValue jika tugas adalah ringkasan, null atau tanggal mulai tidak diatur.
GetWorkingHours(DateTime, DateTime)
Mengembalikan jam kerja untuk tanggal yang ditentukan.
public WorkUnit GetWorkingHours(DateTime start, DateTime finish)
Parameter
start
DateTime
Tanggal mulai.
finish
DateTime
Tanggal selesai.
Mengembalikan
Jam kerja.
GetWorkingHours(DateTime)
Mengembalikan jumlah jam kerja pada tanggal tersebut.
public TimeSpan GetWorkingHours(DateTime dt)
Parameter
dt
DateTime
Tanggal untuk mendapatkan jam kerja.
Mengembalikan
Jam kerja.
GetWorkingTimes(DateTime)
Mengembalikan Aspose.Tasks.WorkingTimeCollection dari waktu kerja untuk tanggal yang ditentukan.
public WorkingTimeCollection GetWorkingTimes(DateTime dt)
Parameter
dt
DateTime
Tanggal untuk mendapatkan waktu kerja.
Mengembalikan
Daftar Aspose.Tasks.WorkingTime.
IsDayWorking(DateTime)
Menentukan apakah hari tersebut adalah hari kerja.
public bool IsDayWorking(DateTime dt)
Parameter
dt
DateTime
Tanggal untuk memeriksa apakah hari tersebut adalah hari kerja.
Mengembalikan
True jika hari tersebut adalah hari kerja.
Make24HourCalendar(Calendar)
Menjadikan Kalender yang diberikan menjadi Kalender 24 Jam.
Kalender 24 Jam adalah Kalender di mana setiap hari dalam seminggu adalah hari kerja dengan jam kerja sepanjang waktu.
public static Calendar Make24HourCalendar(Calendar calendar)
Parameter
calendar
Calendar
Kalender untuk dijadikan Kalender 24 Jam.
Mengembalikan
Kalender 24 Jam.
MakeNightShiftCalendar(Calendar)
Menjadikan Kalender yang diberikan sebagai Kalender Shift Malam.
public static Calendar MakeNightShiftCalendar(Calendar calendar)
Parameter
calendar
Calendar
Kalender untuk dijadikan Kalender Shift Malam.
Mengembalikan
Kalender Shift Malam.
MakeStandardCalendar(Calendar)
Membuat kalender standar default.
public static Calendar MakeStandardCalendar(Calendar calendar)
Parameter
calendar
Calendar
Kalender untuk dijadikan kalender standar.
Mengembalikan
Kalender dengan 5 hari kerja (Senin-Jumat) dengan waktu kerja 8-12 dan 13-17.