.Net C # utility for working with intervals, such as time periods. The utility allows you to find intersections of periods, exclude periods, etc.
For simplicity, the examples use integer ranges. However, the utility supports not only integers, you can use the utility to work with time periods or decimal, or float, etc.
var intervalA = new Interval<int>(3, 6);
var intervalB = new Interval<int>(4, 8);
var isEquals = intervalA == intervalB;
// => false
3 6
|--------------|
4 8
|-------------------|var intervalA = new Interval<int>(null, 4);
var intervalB = new Interval<int>(null, 4);
var isEquals = intervalA == intervalB;
// => true
4
--------------------|
4
--------------------|var interval = new Interval<int>(3, 6);
var intervalUtil = new IntervalUtil();
var isInRange = intervalUtil.InRange(interval, 4);
// => true
3 6
|--------------|
4
|var interval = new Interval<int>(null, 6);
var intervalUtil = new IntervalUtil();
var isInRange = intervalUtil.InRange(interval, 6, includeEnds:true);
// => true
6
------------------------------|
6
|var intervalA = new Interval<int>(3, 6);
var intervalB = new Interval<int>(1, 4);
var intervalUtil = new IntervalUtil();
var res = intervalUtil.Exclude(intervalA, intervalB);
// => [4,6]
3 6
|--------------|
1 4
|--------------|
Result
4 6
|---------|var intervalA = new Interval<int>(3, null);
var intervalB = new Interval<int>(4, 5);
var intervalUtil = new IntervalUtil();
var res = intervalUtil.Exclude(intervalA, intervalB)
// => [3,4], [5,null]
3
|----------------------------------
4 5
|----|
Result
3 4 5
|----| |------------------------var intervalsA = new[] { new Interval<int>(1, 5), new Interval<int>(7, 10) };
var intervalsB =
new[] { new Interval<int>(0, 2), new Interval<int>(3, 5), new Interval<int>(8, 9) };
var intervalUtil = new IntervalUtil();
var res = intervalUtil.Exclude(intervalsA, intervalsB);
// => [2,3], [7,8], [9,10]
1 5 7 10
|-------------------| |--------------|
0 2 3 5 8 9
|---------| |---------| |----|
Result
2 3 7 8 9 10
|----| |----| |----|var intervalA = new Interval<int>(0, 3);
var intervalB = new Interval<int>(2, 4);
var intervalUtil = new IntervalUtil();
var res = intervalUtil.Intersection(intervalA, intervalB);
// => [2,3]
0 3
|--------------|
2 4
|---------|
Result
2 3
|----|var arrayOfArrays = new[] {
new[] { new Interval<int>(2,5), new Interval<int>(7, 9) },
new[] { new Interval<int>(0,3), new Interval<int>(4, 6), new Interval<int>(7, 10) },
new[] { new Interval<int>(1,4), new Interval<int>(5, 8) },
};
var intervalUtil = new IntervalUtil();
var res = intervalUtil.Intersections(arrayOfArrays);
// => [2,3], [7,8]
2 5 7 9
|--------------| |---------|
0 3 4 6 7 10
|--------------| |---------| |--------------|
1 4 5 8
|--------------| |--------------|
Result
2 3 7 8
|----| |----|