Element validPeriod (recurring)
Binnen validPeriod en exceptionPeriod is het ook mogelijk om vaste terugkeerpatronen vast te leggen. Om een terugkerend tijdsinterval aan te geven kan recurringTimePeriodOfDay worden gebruikt. Indien de geldigheid of uitzondering een vaste dag, week of maand betreft (binnen de geldigheid van overallStartTime en overallEndTime), mag gebruik gemaakt worden van recurringDayWeekMonthPeriod. Hiermee is het bijvoorbeeld mogelijk om aan te geven dat het betreffende record binnen de overallPeriod alleen op maandag geldig is.
De structuur is als volgt:
Elementen
Element recurringTimePeriodOfDay
Het element validPeriod bevat het optionele element recurringTimePeriodOfDay, welke meerdere keren voor mag komen.
Subelementen recurringTimePeriodOfDay
Het element recurringTimePeriodOfDay bevat de twee verplichte elementen startTimeOfPeriod en endTimeOfPeriod.
Element startTimeOfPeriod
Het starttijdstip van de periode.
Type: | Verplicht | Domein |
---|---|---|
Time | Ja | 00:00:00Z - 23:59:00Z |
Element endTimeOfPeriod
Het eindtijdstip moment van de periode.
Type: | Verplicht | Domein |
---|---|---|
Time | Ja | 00:00:00Z - 23:59:00Z |
Voorbeeld
<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
Dit element bevat minimaal 1 van de volgende elementen, applicableDay, applicableWeek en/of applicableMonth. Bovenstaande elementen worden alleen opgenomen als deze aanvullende betekenis hebben binnen de overallPeriod.
Note
Het is dus niet toegestaan een overallStartTime en overallEndTime te hebben die op één kalenderdag liggen en vervolgens ook met applicableDay aan te geven dat dit een dinsdag is.
Elementen
Element applicableDay
De dag van de week die van toepassing is. Dit element kan maximaal 7 keer voorkomen, om de relevante dagen in de week aan te geven.
Type: | Verplicht | Domein |
DayEnum | Nee | monday tuesday wednesday thursday friday saturday sunday |
Element applicableWeek
De week in de maand die van toepassing is. Dit element kan maximaal 5 keer voorkomen, om de relevante weken van de maand aan te geven
Type: | Verplicht | Domein |
WeekOfMonthEnum | Nee | firstWeekOfMonth secondWeekOfMonth thirdWeekOfMonth fourthWeekOfMonth fifthWeekOfMonth |
Element applicableMonth
De maand in het jaar die van toepassing is. Dit element kan maximaal 12 keer voorkomen, om de relevante maanden van een jaar aan te geven.
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>