/
Copy of timeBand
Document toolboxDocument toolbox

Copy of timeBand

Owned by Jason Andrew
Sept 20, 2023

Code Block

<band>
    <timeBandID>?</timeBandID>
    <start>?</start>
    <end>?</end>
</band>


Definition

The name given to a segment of time that can be supplied to filter out certain appointments further and to modify the start and end times of the offers returned

 timeBandID, start, and the end is used to generate a (notional) filter band, FilterStartTime to FilterEndTime. FilterStartTime starts if supplied, or, if not, timeBandID.StartTime if timeBandID is provided, or, if not, the start of the day. Similarly, FilterEndTime ends if supplied or, if not, timeBandID.EndTime, if provided, or, if not, the end of the day. Because jobs can span midnight, the FilterEndTime can appear before FilterStartTime, interpreted as being on the next day.

If the filter band is outside the initially generated offer (i.e., there’s no overlap between them), the submission isn’t returned. If FilterStartTime is within an offered appointment, i.e., it is between the initially-generated values of PromStartTime and PromEndTime (see later in this section). Promstarttime will be changed to FilterStartTime before returning that offer. Similarly, if FilterEndTime is within the appointment, then PromEndTime will be altered to FilterEndTime.

Note: An initially-generated offer can never be lengthened by application of the filter band, only shortened.


Fields


Field

Type

Description

timeBandIDtimeBandIDis the name of a time band that can be supplied to filter out certain appointments further and to modify the start and end times of the offers returned



start



spTime

Date and time formats for the Webservices follow the UTC standard:

Datatype

Web Service Format

Date

CCYY-MM-DD

Time

HH:mm

DateTime

CCYY-MM-DDTHH:mm

end

spTime

The day and time that the appointment returns will stop being applied to the select time band. The date and time format for the web services follows the UTC standards.

(See Start above).