View source code
Display the source code in std/datetime.d from which this page was generated on
github.
Improve this page
Quickly fork, edit online, and submit a pull request for this page.
Requires a signed-in GitHub account. This works well for small changes.
If you'd like to make larger changes you may want to consider using
local clone.
Page wiki
View or edit the community-maintained wiki page associated with this page.
std.datetime.interval.span
- multiple declarations
- Function Interval.span
- Function Interval.span
- Function Interval.span
Function Interval.span
Returns an interval
that covers from the earliest time point of two
intervals up to (but not including) the latest time point of two
intervals.
Prototype
Interval span( Interval interval ) const pure;
Parameters
Name | Description |
---|---|
interval | The interval to create a span together with this interval . |
Throws
DateTimeException
if either interval
is empty
.
Examples
assert(Interval!Date(Date(1996, 1, 2), Date(2012, 3, 1)).span( Interval!Date(Date(1990, 7, 6), Date(1991, 1, 8))) == Interval!Date(Date(1990, 7 , 6), Date(2012, 3, 1))); assert(Interval!Date(Date(1996, 1, 2), Date(2012, 3, 1)).span( Interval!Date(Date(2012, 3, 1), Date(2013, 5, 7))) == Interval!Date(Date(1996, 1 , 2), Date(2013, 5, 7)));
Function Interval.span
Returns an interval
that covers from the earliest time point of two
intervals up to (but not including) the latest time point of two
intervals.
Prototype
PosInfInterval!TP span( PosInfInterval!TP interval ) const pure;
Parameters
Name | Description |
---|---|
interval | The interval to create a span together with this interval . |
Throws
DateTimeException
if this interval
is empty
.
Examples
assert(Interval!Date(Date(1996, 1, 2), Date(2012, 3, 1)).span( PosInfInterval!Date(Date(1990, 7, 6))) == PosInfInterval!Date(Date(1990, 7 , 6))); assert(Interval!Date(Date(1996, 1, 2), Date(2012, 3, 1)).span( PosInfInterval!Date(Date(2050, 1, 1))) == PosInfInterval!Date(Date(1996, 1 , 2)));
Function Interval.span
Returns an interval
that covers from the earliest time point of two
intervals up to (but not including) the latest time point of two
intervals.
Prototype
NegInfInterval!TP span( NegInfInterval!TP interval ) const pure;
Parameters
Name | Description |
---|---|
interval | The interval to create a span together with this interval . |
Throws
DateTimeException
if this interval
is empty
.
Examples
assert(Interval!Date(Date(1996, 1, 2), Date(2012, 3, 1)).span( NegInfInterval!Date(Date(1602, 5, 21))) == NegInfInterval!Date(Date(2012, 3 , 1))); assert(Interval!Date(Date(1996, 1, 2), Date(2012, 3, 1)).span( NegInfInterval!Date(Date(2013, 1, 12))) == NegInfInterval!Date(Date(2013, 1 , 12)));
Authors
Jonathan M Davis and Kato Shoichi