NAME

FindNearestSucceedingRecurrence — Find the nearest recurrence datetime after given one.

SYNOPSIS

DESCRIPTION

Return Value

Nearest recurrence datetime after given one.

Arguments

TargetDatetime | Datetime to go off of. |

RecurrenceStartDatetime | A datetime that all other recurrences go from. |

RecurrenceIntervalLength | How 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

KEYWORDS