Time Period Library for .NET
来自软件开发
这个组件很小，主要是对时间日期，特别是处理时间间隔以及时间范围非常方便。虽然.NET自带了时间日期的部分功能，但可能还不强大。这个组件就是增强版本。详细功能可以看项目主页的介绍。在CodeProject:
http://www.codeproject.com/Articles/168662/Time-Period-Library-for-NET
https://github.com/Giannoudis/TimePeriodLibrary
Install-Package TimePeriodLibrary.NET
示例代码：
public class TestClass
{
// ----------------------------------------------------------------------
public void DaySeekerSample()
{
Day start = new Day(new DateTime(2011, 2, 15));
Console.WriteLine("DaySeeker Start: " + start);
// > DaySeeker Start: Dienstag; 15.02.2011 | 0.23:59
CalendarVisitorFilter filter = new CalendarVisitorFilter();
filter.AddWorkingWeekDays(); // only working days
filter.ExcludePeriods.Add(new Week(2011, 9)); // week #9
Console.WriteLine("DaySeeker Holidays: " + filter.ExcludePeriods[0]);
// > DaySeeker Holidays: w/c 9 2011; 28.02.2011 - 06.03.2011 | 6.23:59
DaySeeker daySeeker = new DaySeeker(filter);
Day day1 = daySeeker.FindDay(start, 3); // same working week
Console.WriteLine("DaySeeker(3): " + day1);
// > DaySeeker(3): Freitag; 18.02.2011 | 0.23:59
Day day2 = daySeeker.FindDay(start, 4); // Saturday -> next Monday
Console.WriteLine("DaySeeker(4): " + day2);
// > DaySeeker(4): Montag; 21.02.2011 | 0.23:59
Day day3 = daySeeker.FindDay(start, 9); // holidays -> next Monday
Console.WriteLine("DaySeeker(9): " + day3);
// > DaySeeker(9): Montag; 07.03.2011 | 0.23:59
} // DaySeekerSample
// ----------------------------------------------------------------------
public void CalendarPeriodCollectorSample()
{
CalendarPeriodCollectorFilter filter = new CalendarPeriodCollectorFilter();
filter.Months.Add(YearMonth.January); // only Januaries
filter.WeekDays.Add(DayOfWeek.Friday); // only Fridays
filter.CollectingHours.Add(new HourRange(8, 18)); // working hours
CalendarTimeRange testPeriod =
new CalendarTimeRange(new DateTime(2010, 1, 1), new DateTime(2011, 12, 31));
Console.WriteLine("Calendar period collector of period: " + testPeriod);
// > Calendar period collector of period:
// 01.01.2010 00:00:00 - 30.12.2011 23:59:59 | 728.23:59
CalendarPeriodCollector collector =
new CalendarPeriodCollector(filter, testPeriod);
collector.CollectHours();
foreach (ITimePeriod period in collector.Periods)
{
Console.WriteLine("Period: " + period);
}
// > Period: 01.01.2010; 08:00 - 17:59 | 0.09:59
// > Period: 08.01.2010; 08:00 - 17:59 | 0.09:59
// > Period: 15.01.2010; 08:00 - 17:59 | 0.09:59
// > Period: 22.01.2010; 08:00 - 17:59 | 0.09:59
// > Period: 29.01.2010; 08:00 - 17:59 | 0.09:59
// > Period: 07.01.2011; 08:00 - 17:59 | 0.09:59
// > Period: 14.01.2011; 08:00 - 17:59 | 0.09:59
// > Period: 21.01.2011; 08:00 - 17:59 | 0.09:59
// > Period: 28.01.2011; 08:00 - 17:59 | 0.09:59
} // CalendarPeriodCollectorSample
public void TimePeriodSubtractorSample()
{
DateTime moment = new DateTime(2012, 1, 29);
TimePeriodCollection sourcePeriods = new TimePeriodCollection { new TimeRange(moment.AddHours(2), moment.AddDays(1)) };
TimePeriodCollection subtractingPeriods = new TimePeriodCollection { new TimeRange(moment.AddHours(6), moment.AddHours(10)), new TimeRange(moment.AddHours(12), moment.AddHours(16)) };
TimePeriodSubtractor<TimeRange> subtractor = new TimePeriodSubtractor<TimeRange>();
ITimePeriodCollection subtractedPeriods =
subtractor.SubtractPeriods(sourcePeriods, subtractingPeriods);
foreach (TimeRange subtractedPeriod in subtractedPeriods)
{
Console.WriteLine("Subtracted Period: {0}", subtractedPeriod);
}
// > Subtracted Period : 29.01.2012 02:00:00 - 06:00:00 | 0.04:00
// > Subtracted Period : 29.01.2012 10:00:00 - 12:00:00 | 0.02:00
// > Subtracted Period : 29.01.2012 16:00:00 - 30.01.2012 00:00:00 | 0.08:00
} // TimePeriodSubtractorSample
public void TimePeriodIntersectorSample()
{
TimePeriodCollection periods = new TimePeriodCollection();
periods.Add(new TimeRange(new DateTime(2011, 3, 01), new DateTime(2011, 3, 10)));
periods.Add(new TimeRange(new DateTime(2011, 3, 05), new DateTime(2011, 3, 15)));
periods.Add(new TimeRange(new DateTime(2011, 3, 12), new DateTime(2011, 3, 18)));
periods.Add(new TimeRange(new DateTime(2011, 3, 20), new DateTime(2011, 3, 24)));
periods.Add(new TimeRange(new DateTime(2011, 3, 22), new DateTime(2011, 3, 28)));
periods.Add(new TimeRange(new DateTime(2011, 3, 24), new DateTime(2011, 3, 26)));
TimePeriodIntersector<TimeRange> periodIntersector =
new TimePeriodIntersector<TimeRange>();
ITimePeriodCollection intersectedPeriods = periodIntersector.IntersectPeriods(periods);
foreach (ITimePeriod intersectedPeriod in intersectedPeriods)
{
Console.WriteLine("Intersected Period: " + intersectedPeriod);
}
// > Intersected Period: 05.03.2011 - 10.03.2011 | 5.00:00
// > Intersected Period: 12.03.2011 - 15.03.2011 | 3.00:00
// > Intersected Period: 22.03.2011 - 26.03.2011 | 4.00:00
} // TimePeriodIntersectorSample
public void TimePeriodCombinerSample()
{
TimePeriodCollection periods = new TimePeriodCollection();
periods.Add(new TimeRange(new DateTime(2011, 3, 01), new DateTime(2011, 3, 10)));
periods.Add(new TimeRange(new DateTime(2011, 3, 04), new DateTime(2011, 3, 08)));
periods.Add(new TimeRange(new DateTime(2011, 3, 15), new DateTime(2011, 3, 18)));
periods.Add(new TimeRange(new DateTime(2011, 3, 18), new DateTime(2011, 3, 22)));
periods.Add(new TimeRange(new DateTime(2011, 3, 20), new DateTime(2011, 3, 24)));
periods.Add(new TimeRange(new DateTime(2011, 3, 26), new DateTime(2011, 3, 30)));
TimePeriodCombiner<TimeRange> periodCombiner = new TimePeriodCombiner<TimeRange>();
ITimePeriodCollection combinedPeriods = periodCombiner.CombinePeriods(periods);
foreach (ITimePeriod combinedPeriod in combinedPeriods)
{
Console.WriteLine("Combined Period: " + combinedPeriod);
}
// > Combined Period: 01.03.2011 - 10.03.2011 | 9.00:00
// > Combined Period: 15.03.2011 - 24.03.2011 | 9.00:00
// > Combined Period: 26.03.2011 - 30.03.2011 | 4.00:00
} // TimePeriodCombinerSample
public void TimeGapCalculatorSample()
{
// simulation of some reservations
TimePeriodCollection reservations = new TimePeriodCollection();
reservations.Add(new Days(2011, 3, 7, 2));
reservations.Add(new Days(2011, 3, 16, 2));
// the overall search range
CalendarTimeRange searchLimits = new CalendarTimeRange(
new DateTime(2011, 3, 4), new DateTime(2011, 3, 21));
// search the largest free time block
ICalendarTimeRange largestFreeTimeBlock =
FindLargestFreeTimeBlock(reservations, searchLimits);
Console.WriteLine("Largest free time: " + largestFreeTimeBlock);
// > Largest free time: 09.03.2011 00:00:00 - 11.03.2011 23:59:59 | 2.23:59
} // TimeGapCalculatorSample
// ----------------------------------------------------------------------
public static ICalendarTimeRange FindLargestFreeTimeBlock(
IEnumerable<ITimePeriod> reservations,
ITimePeriod searchLimits = null, bool excludeWeekends = true)
{
TimePeriodCollection bookedPeriods = new TimePeriodCollection(reservations);
if (searchLimits == null)
{
searchLimits = bookedPeriods; // use boundary of reservations
}
if (excludeWeekends)
{
Week currentWeek = new Week(searchLimits.Start);
Week lastWeek = new Week(searchLimits.End);
do
{
ITimePeriodCollection days = currentWeek.GetDays();
foreach (Day day in days)
{
if (!searchLimits.HasInside(day))
{
continue; // outside of the search scope
}
if (day.DayOfWeek == DayOfWeek.Saturday ||
day.DayOfWeek == DayOfWeek.Sunday)
{
bookedPeriods.Add(day); // // exclude weekend day
}
}
currentWeek = currentWeek.GetNextWeek();
} while (currentWeek.Start < lastWeek.Start);
}
// calculate the gaps using the time calendar as period mapper
TimeGapCalculator<TimeRange> gapCalculator =
new TimeGapCalculator<TimeRange>(new TimeCalendar());
ITimePeriodCollection freeTimes =
gapCalculator.GetGaps(bookedPeriods, searchLimits);
if (freeTimes.Count == 0)
{
return null;
}
freeTimes.SortByDuration(); // move the largest gap to the start
return new CalendarTimeRange(freeTimes[0]);
} // FindLargestFreeTimeBlock
public void DateDiffSample()
{
DateTime date1 = new DateTime(2009, 11, 8, 7, 13, 59);
Console.WriteLine("Date1: {0}", date1);
// > Date1: 08.11.2009 07:13:59
DateTime date2 = new DateTime(2011, 3, 20, 19, 55, 28);
Console.WriteLine("Date2: {0}", date2);
// > Date2: 20.03.2011 19:55:28
DateDiff dateDiff = new DateDiff(date1, date2);
// differences
Console.WriteLine("DateDiff.Years: {0}", dateDiff.Years);
// > DateDiff.Years: 1
Console.WriteLine("DateDiff.Quarters: {0}", dateDiff.Quarters);
// > DateDiff.Quarters: 5
Console.WriteLine("DateDiff.Months: {0}", dateDiff.Months);
// > DateDiff.Months: 16
Console.WriteLine("DateDiff.Weeks: {0}", dateDiff.Weeks);
// > DateDiff.Weeks: 70
Console.WriteLine("DateDiff.Days: {0}", dateDiff.Days);
// > DateDiff.Days: 497
Console.WriteLine("DateDiff.Weekdays: {0}", dateDiff.Weekdays);
// > DateDiff.Weekdays: 71
Console.WriteLine("DateDiff.Hours: {0}", dateDiff.Hours);
// > DateDiff.Hours: 11940
Console.WriteLine("DateDiff.Minutes: {0}", dateDiff.Minutes);
// > DateDiff.Minutes: 716441
Console.WriteLine("DateDiff.Seconds: {0}", dateDiff.Seconds);
// > DateDiff.Seconds: 42986489
// elapsed
Console.WriteLine("DateDiff.ElapsedYears: {0}", dateDiff.ElapsedYears);
// > DateDiff.ElapsedYears: 1
Console.WriteLine("DateDiff.ElapsedMonths: {0}", dateDiff.ElapsedMonths);
// > DateDiff.ElapsedMonths: 4
Console.WriteLine("DateDiff.ElapsedDays: {0}", dateDiff.ElapsedDays);
// > DateDiff.ElapsedDays: 12
Console.WriteLine("DateDiff.ElapsedHours: {0}", dateDiff.ElapsedHours);
// > DateDiff.ElapsedHours: 12
Console.WriteLine("DateDiff.ElapsedMinutes: {0}", dateDiff.ElapsedMinutes);
// > DateDiff.ElapsedMinutes: 41
Console.WriteLine("DateDiff.ElapsedSeconds: {0}", dateDiff.ElapsedSeconds);
// > DateDiff.ElapsedSeconds: 29
// description
Console.WriteLine("DateDiff.GetDescription(1): {0}", dateDiff.GetDescription(1));
// > DateDiff.GetDescription(1): 1 Year
Console.WriteLine("DateDiff.GetDescription(2): {0}", dateDiff.GetDescription(2));
// > DateDiff.GetDescription(2): 1 Year 4 Months
Console.WriteLine("DateDiff.GetDescription(3): {0}", dateDiff.GetDescription(3));
// > DateDiff.GetDescription(3): 1 Year 4 Months 12 Days
Console.WriteLine("DateDiff.GetDescription(4): {0}", dateDiff.GetDescription(4));
// > DateDiff.GetDescription(4): 1 Year 4 Months 12 Days 12 Hours
Console.WriteLine("DateDiff.GetDescription(5): {0}", dateDiff.GetDescription(5));
// > DateDiff.GetDescription(5): 1 Year 4 Months 12 Days 12 Hours 41 Mins
Console.WriteLine("DateDiff.GetDescription(6): {0}", dateDiff.GetDescription(6));
// > DateDiff.GetDescription(6): 1 Year 4 Months 12 Days 12 Hours 41 Mins 29 Secs
} // DateDiffSample
public void BroadcastCalendar()
{
BroadcastYear year = new BroadcastYear(2013);
Console.WriteLine("Broadcast year: " + year);
// > Broadcast year: 2013; 31.12.2012 - 29.12.2013 | 363.23:59
foreach (BroadcastMonth month in year.GetMonths())
{
Console.WriteLine(" Broadcast month: " + month);
foreach (BroadcastWeek week in month.GetWeeks())
{
Console.WriteLine(" Broadcast week: " + week);
}
}
} // BroadcastCalendar
public void FiscalYearNearestDay()
{
ITimeCalendar calendar = new TimeCalendar(new TimeCalendarConfig
{
YearType = YearType.FiscalYear,
YearBaseMonth = YearMonth.September,
FiscalFirstDayOfYear = DayOfWeek.Sunday,
FiscalYearAlignment = FiscalYearAlignment.NearestDay,
FiscalQuarterGrouping = FiscalQuarterGrouping.FourFourFiveWeeks
});
Years years = new Years(2005, 14, calendar);
foreach (Year year in years.GetYears())
{
Console.WriteLine("Fiscal year {0}: {1} - {2}", year.YearValue,
year.Start.ToString("yyyy-MM-dd"), year.End.ToString("yyyy-MM-dd"));
}
} // FiscalYearNearestDay
public void FiscalYearLastDay()
{
ITimeCalendar calendar = new TimeCalendar(new TimeCalendarConfig
{
YearType = YearType.FiscalYear,
YearBaseMonth = YearMonth.September,
FiscalFirstDayOfYear = DayOfWeek.Sunday,
FiscalYearAlignment = FiscalYearAlignment.LastDay,
FiscalQuarterGrouping = FiscalQuarterGrouping.FourFourFiveWeeks
});
Years years = new Years(2005, 14, calendar);
foreach (Year year in years.GetYears())
{
Console.WriteLine("Fiscal year {0}: {1} - {2}", year.YearValue,
year.Start.ToString("yyyy-MM-dd"), year.End.ToString("yyyy-MM-dd"));
}
} // FiscalYearLastDay
public void CalendarWeekSample()
{
DateTime testDate = new DateTime(2019, 1, 9);
// .NET calendar week
TimeCalendar calendar = new TimeCalendar();
Console.WriteLine("Calendar Week of {0}: {1}", testDate.ToShortDateString(),
new Week(testDate, calendar).WeekOfYear);
// > Calendar Week of 31.12.2007: 53
// ISO 8601 calendar week
TimeCalendar calendarIso8601 = new TimeCalendar(
new TimeCalendarConfig { YearWeekType = YearWeekType.Iso8601 });
Console.WriteLine("ISO 8601 Week of {0}: {1}", testDate.ToShortDateString(),
new Week(testDate, calendarIso8601).WeekOfYear);
// > ISO 8601 Week of 31.12.2007: 1
} // CalendarWeekSample
// ----------------------------------------------------------------------
public bool IntersectsYear(DateTime start, DateTime end, int year)
{
return new Year(year).IntersectsWith(new TimeRange(start, end));
} // IntersectsYear
// ----------------------------------------------------------------------
public void GetDaysOfPastQuarter(DateTime moment,
out DateTime firstDay, out DateTime lastDay)
{
TimeCalendar calendar = new TimeCalendar(
new TimeCalendarConfig { YearBaseMonth = YearMonth.October });
Quarter quarter = new Quarter(moment, calendar);
Quarter pastQuarter = quarter.GetPreviousQuarter();
firstDay = pastQuarter.FirstDayStart;
lastDay = pastQuarter.LastDayStart;
} // GetDaysOfPastQuarter
// ----------------------------------------------------------------------
public DateTime GetFirstDayOfWeek(DateTime moment)
{
return new Week(moment).FirstDayStart;
} // GetFirstDayOfWeek
// ----------------------------------------------------------------------
public bool IsInCurrentWeek(DateTime test)
{
return new Week().HasInside(test);
} // IsInCurrentWeek
public void YearStartSample()
{
TimeCalendar calendar = new TimeCalendar(
new TimeCalendarConfig { YearBaseMonth = YearMonth.February });
Years years = new Years(2012, 2, calendar); // 2012-2013
Console.WriteLine("Quarters of Years (February): {0}", years);
// > Quarters of Years (February): 2012 - 2014; 01.02.2012 - 31.01.2014 | 730.23:59
foreach (Year year in years.GetYears())
{
foreach (Quarter quarter in year.GetQuarters())
{
Console.WriteLine("Quarter: {0}", quarter);
}
}
// > Quarter: Q1 2012; 01.02.2012 - 30.04.2012 | 89.23:59
// > Quarter: Q2 2012; 01.05.2012 - 31.07.2012 | 91.23:59
// > Quarter: Q3 2012; 01.08.2012 - 31.10.2012 | 91.23:59
// > Quarter: Q4 2012; 01.11.2012 - 31.01.2013 | 91.23:59
// > Quarter: Q1 2013; 01.02.2013 - 30.04.2013 | 88.23:59
// > Quarter: Q2 2013; 01.05.2013 - 31.07.2013 | 91.23:59
// > Quarter: Q3 2013; 01.08.2013 - 31.10.2013 | 91.23:59
// > Quarter: Q4 2013; 01.11.2013 - 31.01.2014 | 91.23:59
} // YearStartSample
public void FiscalYearTimePeriodsSample()
{
DateTime moment = new DateTime(2011, 8, 15);
FiscalTimeCalendar fiscalCalendar = new FiscalTimeCalendar();
Console.WriteLine("Fiscal Year Periods of {0}:", moment.ToShortDateString());
// > Fiscal Year Periods of 15.08.2011:
Console.WriteLine("Year : {0}", new Year(moment, fiscalCalendar));
Console.WriteLine("Halfyear : {0}", new Halfyear(moment, fiscalCalendar));
Console.WriteLine("Quarter : {0}", new Quarter(moment, fiscalCalendar));
// > Year : FY2010; 01.10.2010 - 30.09.2011 | 364.23:59
// > Halfyear : FHY2 2010; 01.04.2011 - 30.09.2011 | 182.23:59
// > Quarter : FQ4 2010; 01.07.2011 - 30.09.2011 | 91.23:59
} // FiscalYearTimePeriodsSample
public void YearQuartersSample()
{
Year year = new Year(2012);
ITimePeriodCollection quarters = year.GetQuarters();
Console.WriteLine("Quarters of Year: {0}", year);
// > Quarters of Year: 2012; 01.01.2012 - 31.12.2012 | 365.23:59
foreach (Quarter quarter in quarters)
{
Console.WriteLine("Quarter: {0}", quarter);
}
// > Quarter: Q1 2012; 01.01.2012 - 31.03.2012 | 90.23:59
// > Quarter: Q2 2012; 01.04.2012 - 30.06.2012 | 90.23:59
// > Quarter: Q3 2012; 01.07.2012 - 30.09.2012 | 91.23:59
// > Quarter: Q4 2012; 01.10.2012 - 31.12.2012 | 91.23:59
} // YearQuartersSample
public void CalendarYearTimePeriodsSample()
{
DateTime moment = new DateTime(2011, 8, 15);
Console.WriteLine("Calendar Periods of {0}:", moment.ToShortDateString());
// > Calendar Periods of 15.08.2011:
Console.WriteLine("Year : {0}", new Year(moment));
Console.WriteLine("Halfyear : {0}", new Halfyear(moment));
Console.WriteLine("Quarter : {0}", new Quarter(moment));
Console.WriteLine("Month : {0}", new Month(moment));
Console.WriteLine("Week : {0}", new Week(moment));
Console.WriteLine("Day : {0}", new Day(moment));
Console.WriteLine("Hour : {0}", new Hour(moment));
// > Year : 2011; 01.01.2011 - 31.12.2011 | 364.23:59
// > Halfyear : HY2 2011; 01.07.2011 - 31.12.2011 | 183.23:59
// > Quarter : Q3 2011; 01.07.2011 - 30.09.2011 | 91.23:59
// > Month : August 2011; 01.08.2011 - 31.08.2011 | 30.23:59
// > Week : w/c 33 2011; 15.08.2011 - 21.08.2011 | 6.23:59
// > Day : Montag; 15.08.2011 - 15.08.2011 | 0.23:59
// > Hour : 15.08.2011; 00:00 - 00:59 | 0.00:59
} // CalendarYearTimePeriodsSample
public void FiscalYearSample()
{
FiscalTimeCalendar calendar = new FiscalTimeCalendar(); // use fiscal periods
DateTime moment1 = new DateTime(2006, 9, 30);
Console.WriteLine("Fiscal Year of {0}: {1}", moment1.ToShortDateString(),
new Year(moment1, calendar).YearName);
// > Fiscal Year of 30.09.2006: FY2005
Console.WriteLine("Fiscal Quarter of {0}: {1}", moment1.ToShortDateString(),
new Quarter(moment1, calendar).QuarterOfYearName);
// > Fiscal Quarter of 30.09.2006: FQ4 2005
DateTime moment2 = new DateTime(2006, 10, 1);
Console.WriteLine("Fiscal Year of {0}: {1}", moment2.ToShortDateString(),
new Year(moment2, calendar).YearName);
// > Fiscal Year of 01.10.2006: FY2006
Console.WriteLine("Fiscal Quarter of {0}: {1}", moment1.ToShortDateString(),
new Quarter(moment2, calendar).QuarterOfYearName);
// > Fiscal Quarter of 30.09.2006: FQ1 2006
} // FiscalYearSample
public class FiscalTimeCalendar : TimeCalendar
{
// ----------------------------------------------------------------------
public FiscalTimeCalendar()
: base(
new TimeCalendarConfig
{
YearBaseMonth = YearMonth.October, // October year base month
YearWeekType = YearWeekType.Iso8601, // ISO 8601 week numbering
YearType = YearType.FiscalYear // treat years as fiscal years
})
{
} // FiscalTimeCalendar
} // class FiscalTimeCalendar
public void TimePeriodMapperSample()
{
TimeCalendar timeCalendar = new TimeCalendar();
CultureInfo ci = CultureInfo.InvariantCulture;
DateTime start = new DateTime(2011, 3, 1, 13, 0, 0);
DateTime end = new DateTime(2011, 3, 1, 14, 0, 0);
Console.WriteLine("Original start: {0}",
start.ToString("HH:mm:ss.fffffff", ci));
// > Original start: 13:00:00.0000000
Console.WriteLine("Original end: {0}",
end.ToString("HH:mm:ss.fffffff", ci));
// > Original end: 14:00:00.0000000
Console.WriteLine("Mapping offset start: {0}", timeCalendar.StartOffset);
// > Mapping offset start: 00:00:00
Console.WriteLine("Mapping offset end: {0}", timeCalendar.EndOffset);
// > Mapping offset end: -00:00:00.0000001
Console.WriteLine("Mapped start: {0}",
timeCalendar.MapStart(start).ToString("HH:mm:ss.fffffff", ci));
// > Mapped start: 13:00:00.0000000
Console.WriteLine("Mapped end: {0}",
timeCalendar.MapEnd(end).ToString("HH:mm:ss.fffffff", ci));
// > Mapped end: 13:59:59.9999999
} // TimePeriodMapperSample
public void TimePeriodChainSample()
{
TimePeriodChain timePeriods = new TimePeriodChain();
DateTime now = ClockProxy.Clock.Now;
DateTime testDay = new DateTime(2010, 7, 23);
// --- add ---
timePeriods.Add(new TimeBlock(
TimeTrim.Hour(testDay, 8), Duration.Hours(2)));
timePeriods.Add(new TimeBlock(now, Duration.Hours(1, 30)));
timePeriods.Add(new TimeBlock(now, Duration.Hour));
Console.WriteLine("TimePeriodChain.Add(): " + timePeriods);
// > TimePeriodChain.Add(): Count = 3; 23.07.2010 08:00:00 - 12:30:00 | 0.04:30
foreach (ITimePeriod timePeriod in timePeriods)
{
Console.WriteLine("Item: " + timePeriod);
}
// > Item: 23.07.2010 08:00:00 - 10:00:00 | 02:00:00
// > Item: 23.07.2010 10:00:00 - 11:30:00 | 01:30:00
// > Item: 23.07.2010 11:30:00 - 12:30:00 | 01:00:00
// --- insert ---
timePeriods.Insert(2, new TimeBlock(now, Duration.Minutes(45)));
Console.WriteLine("TimePeriodChain.Insert(): " + timePeriods);
// > TimePeriodChain.Insert(): Count = 4; 23.07.2010 08:00:00 - 13:15:00 | 0.05:15
foreach (ITimePeriod timePeriod in timePeriods)
{
Console.WriteLine("Item: " + timePeriod);
}
// > Item: 23.07.2010 08:00:00 - 10:00:00 | 02:00:00
// > Item: 23.07.2010 10:00:00 - 11:30:00 | 01:30:00
// > Item: 23.07.2010 11:30:00 - 12:15:00 | 00:45:00
// > Item: 23.07.2010 12:15:00 - 13:15:00 | 01:00:00
} // TimePeriodChainSample
public void TimePeriodCollectionSample()
{
TimePeriodCollection timePeriods = new TimePeriodCollection();
DateTime testDay = new DateTime(2010, 7, 23);
// --- items ---
timePeriods.Add(new TimeRange(TimeTrim.Hour(testDay, 8),
TimeTrim.Hour(testDay, 11)));
timePeriods.Add(new TimeBlock(TimeTrim.Hour(testDay, 10), Duration.Hours(3)));
timePeriods.Add(new TimeRange(TimeTrim.Hour(testDay, 16, 15),
TimeTrim.Hour(testDay, 18, 45)));
timePeriods.Add(new TimeRange(TimeTrim.Hour(testDay, 14),
TimeTrim.Hour(testDay, 15, 30)));
Console.WriteLine("TimePeriodCollection: " + timePeriods);
// > TimePeriodCollection: Count = 4; 23.07.2010 08:00:00 - 18:45:00 | 0.10:45
Console.WriteLine("TimePeriodCollection.Items");
foreach (ITimePeriod timePeriod in timePeriods)
{
Console.WriteLine("Item: " + timePeriod);
}
// > Item: 23.07.2010 08:00:00 - 11:00:00 | 03:00:00
// > Item: 23.07.2010 10:00:00 - 13:00:00 | 03:00:00
// > Item: 23.07.2010 16:15:00 - 18:45:00 | 02:30:00
// > Item: 23.07.2010 14:00:00 - 15:30:00 | 01:30:00
// --- intersection by moment ---
DateTime intersectionMoment = new DateTime(2010, 7, 23, 10, 30, 0);
ITimePeriodCollection momentIntersections =
timePeriods.IntersectionPeriods(intersectionMoment);
Console.WriteLine("TimePeriodCollection.IntesectionPeriods of " +
intersectionMoment);
// > TimePeriodCollection.IntesectionPeriods of 23.07.2010 10:30:00
foreach (ITimePeriod momentIntersection in momentIntersections)
{
Console.WriteLine("Intersection: " + momentIntersection);
}
// > Intersection: 23.07.2010 08:00:00 - 11:00:00 | 03:00:00
// > Intersection: 23.07.2010 10:00:00 - 13:00:00 | 03:00:00
// --- intersection by period ---
TimeRange intersectionPeriod =
new TimeRange(TimeTrim.Hour(testDay, 9),
TimeTrim.Hour(testDay, 14, 30));
ITimePeriodCollection periodIntersections =
timePeriods.IntersectionPeriods(intersectionPeriod);
Console.WriteLine("TimePeriodCollection.IntesectionPeriods of " +
intersectionPeriod);
// > TimePeriodCollection.IntesectionPeriods
// of 23.07.2010 09:00:00 - 14:30:00 | 0.05:30
foreach (ITimePeriod periodIntersection in periodIntersections)
{
Console.WriteLine("Intersection: " + periodIntersection);
}
// > Intersection: 23.07.2010 08:00:00 - 11:00:00 | 03:00:00
// > Intersection: 23.07.2010 10:00:00 - 13:00:00 | 03:00:00
// > Intersection: 23.07.2010 14:00:00 - 15:30:00 | 01:30:00
} // TimePeriodCollectionSample
public void TimeIntervalSample()
{
// --- time interval 1 ---
TimeInterval timeInterval1 = new TimeInterval(
new DateTime(2011, 5, 8),
new DateTime(2011, 5, 9));
Console.WriteLine("TimeInterval1: " + timeInterval1);
// > TimeInterval1: [08.05.2011 - 09.05.2011] | 1.00:00
// --- time interval 2 ---
TimeInterval timeInterval2 = new TimeInterval(
timeInterval1.End,
timeInterval1.End.AddDays(1));
Console.WriteLine("TimeInterval2: " + timeInterval2);
// > TimeInterval2: [09.05.2011 - 10.05.2011] | 1.00:00
// --- relation ---
Console.WriteLine("Relation: " + timeInterval1.GetRelation(timeInterval2));
// > Relation: EndTouching
Console.WriteLine("Intersection: " +
timeInterval1.GetIntersection(timeInterval2));
// > Intersection: [09.05.2011]
timeInterval1.EndEdge = IntervalEdge.Open;
Console.WriteLine("TimeInterval1: " + timeInterval1);
// > TimeInterval1: [08.05.2011 - 09.05.2011) | 1.00:00
timeInterval2.StartEdge = IntervalEdge.Open;
Console.WriteLine("TimeInterval2: " + timeInterval2);
// > TimeInterval2: (09.05.2011 - 10.05.2011] | 1.00:00
// --- relation ---
Console.WriteLine("Relation: " + timeInterval1.GetRelation(timeInterval2));
// > Relation: Before
Console.WriteLine("Intersection: " +
timeInterval1.GetIntersection(timeInterval2));
// > Intersection:
} // TimeIntervalSample
public void TimeBlockSample()
{
// --- time block ---
TimeBlock timeBlock = new TimeBlock(
new DateTime(2011, 2, 22, 11, 0, 0),
new TimeSpan(2, 0, 0));
Console.WriteLine("TimeBlock: " + timeBlock);
// > TimeBlock: 22.02.2011 11:00:00 - 13:00:00 | 02:00:00
// --- modification ---
timeBlock.Start = new DateTime(2011, 2, 22, 15, 0, 0);
Console.WriteLine("TimeBlock.Start: " + timeBlock);
// > TimeBlock.Start: 22.02.2011 15:00:00 - 17:00:00 | 02:00:00
timeBlock.Move(new TimeSpan(1, 0, 0));
Console.WriteLine("TimeBlock.Move(1 hour): " + timeBlock);
// > TimeBlock.Move(1 hour): 22.02.2011 16:00:00 - 18:00:00 | 02:00:00
// --- previous/next ---
Console.WriteLine("TimeBlock.GetPreviousPeriod(): " +
timeBlock.GetPreviousPeriod());
// > TimeBlock.GetPreviousPeriod(): 22.02.2011 14:00:00 - 16:00:00 | 02:00:00
Console.WriteLine("TimeBlock.GetNextPeriod(): " + timeBlock.GetNextPeriod());
// > TimeBlock.GetNextPeriod(): 22.02.2011 18:00:00 - 20:00:00 | 02:00:00
Console.WriteLine("TimeBlock.GetNextPeriod(+1 hour): " +
timeBlock.GetNextPeriod(new TimeSpan(1, 0, 0)));
// > TimeBlock.GetNextPeriod(+1 hour): 22.02.2011 19:00:00 - 21:00:00 | 02:00:00
Console.WriteLine("TimeBlock.GetNextPeriod(-1 hour): " +
timeBlock.GetNextPeriod(new TimeSpan(-1, 0, 0)));
// > TimeBlock.GetNextPeriod(-1 hour): 22.02.2011 17:00:00 - 19:00:00 | 02:00:00
} // TimeBlockSample
// ----------------------------------------------------------------------
public void TimeRangeSample()
{
// --- time range 1 ---
TimeRange timeRange1 = new TimeRange(
new DateTime(2011, 2, 22, 14, 0, 0),
new DateTime(2011, 2, 22, 18, 0, 0));
Console.WriteLine("TimeRange1: " + timeRange1);
// > TimeRange1: 22.02.2011 14:00:00 - 18:00:00 | 04:00:00
// --- time range 2 ---
TimeRange timeRange2 = new TimeRange(
new DateTime(2011, 2, 22, 15, 0, 0),
new TimeSpan(2, 0, 0));
Console.WriteLine("TimeRange2: " + timeRange2);
// > TimeRange2: 22.02.2011 15:00:00 - 17:00:00 | 02:00:00
// --- time range 3 ---
TimeRange timeRange3 = new TimeRange(
new DateTime(2011, 2, 22, 16, 0, 0),
new DateTime(2011, 2, 22, 21, 0, 0));
Console.WriteLine("TimeRange3: " + timeRange3);
// > TimeRange3: 22.02.2011 16:00:00 - 21:00:00 | 05:00:00
// --- relation ---
Console.WriteLine("TimeRange1.GetRelation( TimeRange2 ): " +
timeRange1.GetRelation(timeRange2));
// > TimeRange1.GetRelation( TimeRange2 ): Enclosing
Console.WriteLine("TimeRange1.GetRelation( TimeRange3 ): " +
timeRange1.GetRelation(timeRange3));
// > TimeRange1.GetRelation( TimeRange3 ): EndInside
Console.WriteLine("TimeRange3.GetRelation( TimeRange2 ): " +
timeRange3.GetRelation(timeRange2));
// > TimeRange3.GetRelation( TimeRange2 ): StartInside
// --- intersection ---
Console.WriteLine("TimeRange1.GetIntersection( TimeRange2 ): " +
timeRange1.GetIntersection(timeRange2));
// > TimeRange1.GetIntersection( TimeRange2 ):
// 22.02.2011 15:00:00 - 17:00:00 | 02:00:00
Console.WriteLine("TimeRange1.GetIntersection( TimeRange3 ): " +
timeRange1.GetIntersection(timeRange3));
// > TimeRange1.GetIntersection( TimeRange3 ):
// 22.02.2011 16:00:00 - 18:00:00 | 02:00:00
Console.WriteLine("TimeRange3.GetIntersection( TimeRange2 ): " +
timeRange3.GetIntersection(timeRange2));
// > TimeRange3.GetIntersection( TimeRange2 ):
// 22.02.2011 16:00:00 - 17:00:00 | 01:00:00
} // TimeRangeSample
}
