Module Contents

ifcopenshell.api.sequence.add_work_time.add_work_time(file, work_calendar=None, time_type='WorkingTimes') None

Add either working times or holiday times to a calendar

A calendar defines when work occurs by defining working times and holiday times. First, the working times are defined, then the holidays may override the working times. For this reason, holidays are also known as exception times. For example, you might define the working times as every Monday to Friday, then define a few holidays in the year, such as the 1st of January. If the 1st of January is on a weekday, it will override the work time.

  • work_calendar (ifcopenshell.entity_instance) – The IfcWorkCalendar to add the work or holiday time definition to.

  • time_type (str) – Either WorkingTimes or ExceptionTimes, depending on what you want to define.


The newly created IfcWorkTime

Return type:



# Let's create a new calendar.
calendar = ifcopenshell.api.run("sequence.add_work_calendar", model)

# Let's start defining the times that we work during the week.
work_time = ifcopenshell.api.run("sequence.add_work_time", model,
    work_calendar=calendar, time_type="WorkingTimes")

# We create a weekly recurrence
pattern = ifcopenshell.api.run("sequence.assign_recurrence_pattern", model,
    parent=work_time, recurrence_type="WEEKLY")

# State that we work from weekdays 1 to 5 (i.e. Monday to Friday)
ifcopenshell.api.run("sequence.edit_recurrence_pattern", model,
    recurrence_pattern=pattern, attributes={"WeekdayComponent": [1, 2, 3, 4, 5]})

# Let's set some holidays
holidays = ifcopenshell.api.run("sequence.add_work_time", model,
    work_calendar=calendar, time_type="ExceptionTimes")

# We create a yearly recurrence
pattern = ifcopenshell.api.run("sequence.assign_recurrence_pattern", model,
    parent=work_time, recurrence_type="YEARLY_BY_DAY_OF_MONTH")

# The holiday is every 1st of January
ifcopenshell.api.run("sequence.edit_recurrence_pattern", model,
    recurrence_pattern=pattern, attributes={"DayComponent": [1], "MonthComponent": [1]})