hours_open.txt

A structured way of describing the days and hours that a place such as a Office or PollingLocation is open, or that an event such as an Election is happening.

Tag Data Type Required? Repeats? Description Error Handling
Schedule Schedule Required Repeats Defines a block of days and hours that a place will be open. At least one valid Schedule must be present for HoursOpen to be valid. If no valid Schedule is present, the implementation is required to ignore the HoursOpen element.

Schedule

A sub-portion of the schedule. This describes a range of days, along with one or more set of open and close times for those days, as well as the options describing whether or not appointments are necessary or possible.

Tag Data Type Required? Repeats? Description Error Handling
Hours Hours Optional Repeats Blocks of hours in the date range in which the place is open. If the element is invalid or not present, then the implementation is required to ignore it.
IsOnlyByAppointment xs:boolean Optional Single If true, the place is only open during the specified time window with an appointment. If the field is invalid or not present, then the implementation is required to ignore it.
IsOrByAppointment xs:boolean Optional Single If true, the place is open during the hours specified time window and may also be open with an appointment. If the field is invalid or not present, then the implementation is required to ignore it.
IsSubjectToChange xs:boolean Optional Single If true, the place should be open during the specified time window, but may be subject to change. People should contact prior to arrival to confirm hours are still accurate. If the field is invalid or not present, then the implementation is required to ignore it.
StartDate xs:date Optional Single The date at which this collection of start and end times and options begin. If the field is invalid or not present, then the implementation is required to ignore it.
EndDate xs:date Optional Single The date at which this collection of start and end times and options end. If the field is invalid or not present, then the implementation is required to ignore it.

Hours

The open and close time for this place. All times must be fully specified, including a timezone offset from UTC.

Tag Data Type Required? Repeats? Description Error Handling
StartTime TimeWithZone Optional Single The time at which this place opens. If the element is invalid or not present, then the implementation is required to ignore it.
EndTime TimeWithZone Optional Single The time at which this place closes. If the element is invalid or not present, then the implementation is required to ignore it.

TimeWithZone

A string pattern restricting the value to a time with an included offset from UTC. The pattern is

(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]|(24:00:00))(Z|[+-]((0[0-9]|1[0-3]):[0-5][0-9]|14:00))

1
2
start_time,end_time,is_only_by_appointment,is_or_by_appointment,is_subject_to_change,start_date,end_date,id
06:00:00-05:00,19:00:00-05:00,,,,2013-11-05,2013-11-05,hours0001