Element validPeriod (recurring)
Within validPeriod and exceptionPeriod, it is also possible to define fixed recurrence patterns. To specify a recurring time interval, recurringTimePeriodOfDay can be used. If the validity or exception concerns a specific day, week, or month (within the overallStartTime and overallEndTime), recurringDayWeekMonthPeriod may be used. This allows, for example, to specify that the record is only valid on Mondays within the overallPeriod.
The structure is as follows:
Elements
Element recurringTimePeriodOfDay
The element validPeriod contains the optional element recurringTimePeriodOfDay, which can appear multiple times.
Subelementen recurringTimePeriodOfDay
The element recurringTimePeriodOfDay contains two mandatory elements: startTimeOfPeriod and endTimeOfPeriod.
Element startTimeOfPeriod
The start time of the period.
Type: | Mandatory | Domain |
---|---|---|
Time | Ja | 00:00:00Z - 23:59:00Z |
Element endTimeOfPeriod
The end time of the period.
Type: | Mandatory | Domain |
---|---|---|
Time | Ja | 00:00:00Z - 23:59:00Z |
Example
<sit:validity>
<com:validityStatus>definedByValidityTimeSpec</com:validityStatus>
<com:validityTimeSpecification>
<com:overallStartTime>2024-09-02T06:00:00Z</com:overallStartTime>
<com:overallEndTime>2024-09-14T20:00:00Z</com:overallEndTime>
<com:validPeriod>
<com:recurringTimePeriodOfDay>
<com:startTimeOfPeriod>07:00:00Z</com:startTimeOfPeriod>
<com:endTimeOfPeriod>10:00:00Z</com:endTimeOfPeriod>
</com:recurringTimePeriodOfDay>
<com:recurringTimePeriodOfDay>
<com:startTimeOfPeriod>15:00:00Z</com:startTimeOfPeriod>
<com:endTimeOfPeriod>18:00:00Z</com:endTimeOfPeriod>
</com:recurringTimePeriodOfDay>
</com:validPeriod>
</com:validityTimeSpecification>
</sit:validity>
Element recurringDayWeekMonthPeriod
This element contains at least one of the following elements: applicableDay, applicableWeek, and/or applicableMonth. The above elements are only included if they have additional meaning within the overallPeriod.
Note
It is not allowed to have an overallStartTime and overallEndTime that fall on one calendar day and then specify with applicableDay that this is a Tuesday.
Elements
Element applicableDay
The day of the week that is applicable. This element can occur a maximum of 7 times to specify the relevant days of the week.
Type: | Verplicht | Domein |
DayEnum | Nee | monday tuesday wednesday thursday friday saturday sunday |
Element applicableWeek
The week of the month that is applicable. This element can occur a maximum of 5 times to specify the relevant weeks of the month.
Type: | Verplicht | Domein |
WeekOfMonthEnum | Nee | firstWeekOfMonth secondWeekOfMonth thirdWeekOfMonth fourthWeekOfMonth fifthWeekOfMonth |
Element applicableMonth
The month of the year that is applicable. This element can occur a maximum of 12 times to specify the relevant months of the year.
Type: | Verplicht | Domein |
MonthOfYearEnum | Nee | january february march april may june july august september october november december |
Voorbeeld
<sit:validity>
<com:validityStatus>definedByValidityTimeSpec</com:validityStatus>
<com:validityTimeSpecification>
<com:overallStartTime>2025-01-01T00:00:00Z</com:overallStartTime>
<com:overallEndTime>2025-12-31T23:59:59Z</com:overallEndTime>
<com:validPeriod>
<com:recurringDayWeekMonthPeriod>
<com:applicableDay>wednesday</com:applicableDay>
<com:applicableDay>friday</com:applicableDay>
</com:recurringDayWeekMonthPeriod>
<com:recurringDayWeekMonthPeriod>
<com:applicableMonth>july</com:applicableMonth>
<com:applicableMonth>august</com:applicableMonth>
<com:applicableMonth>september</com:applicableMonth>
</com:recurringDayWeekMonthPeriod>
</com:validPeriod>
</com:validityTimeSpecification>
</sit:validity>