NAME
FindNearestSucceedingRecurrence — Find the nearest recurrence datetime after given one.
SYNOPSIS
FindNearestSucceedingRecurrence TargetDatetime RecurrenceStartDatetime RecurrenceIntervalLength
DESCRIPTION
Return Value
Nearest recurrence datetime after given one.
Arguments
TargetDatetimeDatetime to go off of.
RecurrenceStartDatetimeA datetime that all other recurrences go from.
RecurrenceIntervalLengthHow long between recurrences. See More Info for format.
More Info
Say we have something that happens every so often, perhaps once a week. We call that a recurrence. There is a first recurrence datetime and then there is the amount of time between recurrences. We want to find from some given point (perhaps right now), when the next recurrence will be. This command will return that datetime. (See examples for better understanding.)

Currently, the RecurrenceIntervalLength quantity must be of the form ddddThh:mm:ss, where dddd is four digits for the number of days to add or subtract, hh is two digits for the number of hours, and mm and ss are for minutes and seconds.

The recurrence interval must be positive. If you want to go in a forwardwards direction, then use FindNearestPrecedingRecurrence.


For information regarding exceptions / errors, see here.
EXAMPLES
% FindNearestSucceedingRecurrence {2000-01-02 03:04:05} {2000-01-01 00:00:00} {0001T00:00:00}
2000-01-03 00:00:00
SEE ALSO
FindNearestPrecedingRecurrence, IsDatetimeQuantity
KEYWORDS
datetime