Ga naar inhoud

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:

image

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>
Ga terug naar de vorige pagina