offset_happens_before_timespan_starts

timespantools.offset_happens_before_timespan_starts(timespan=None, offset=None, hold=False)

Makes time relation indicating that offset happens before timespan starts.

>>> import abjad

Makes time relation indicating that offset happens before timespan starts:

>>> relation = abjad.timespantools.offset_happens_before_timespan_starts()
>>> f(relation)
abjad.OffsetTimespanTimeRelation(
    inequality=abjad.CompoundInequality(
        [
            abjad.TimespanInequality('offset < timespan.start'),
            ],
        logical_operator='and',
        ),
    )

Makes time relation indicating that offset 1/2 happens before timespan starts:

>>> offset = abjad.Offset(1, 2)
>>> relation = \
...     abjad.timespantools.offset_happens_before_timespan_starts(
...     offset=offset)
>>> f(relation)
abjad.OffsetTimespanTimeRelation(
    inequality=abjad.CompoundInequality(
        [
            abjad.TimespanInequality('offset < timespan.start'),
            ],
        logical_operator='and',
        ),
    offset=abjad.Offset(1, 2),
    )

Makes time relation indicating that offset happens before timespan [2, 8) starts:

>>> timespan = abjad.Timespan(2, 8)
>>> relation = \
...     abjad.timespantools.offset_happens_before_timespan_starts(
...     timespan=timespan)
>>> f(relation)
abjad.OffsetTimespanTimeRelation(
    inequality=abjad.CompoundInequality(
        [
            abjad.TimespanInequality('offset < timespan.start'),
            ],
        logical_operator='and',
        ),
    timespan=abjad.Timespan(
        start_offset=abjad.Offset(2, 1),
        stop_offset=abjad.Offset(8, 1),
        ),
    )

Makes time relation indicating that offset 1/2 happens before timespan [2, 8) starts:

>>> relation = abjad.timespantools.offset_happens_before_timespan_starts(
...     timespan=timespan,
...     offset=offset,
...     hold=True,
...     )
>>> f(relation)
abjad.OffsetTimespanTimeRelation(
    inequality=abjad.CompoundInequality(
        [
            abjad.TimespanInequality('offset < timespan.start'),
            ],
        logical_operator='and',
        ),
    timespan=abjad.Timespan(
        start_offset=abjad.Offset(2, 1),
        stop_offset=abjad.Offset(8, 1),
        ),
    offset=abjad.Offset(1, 2),
    )

Evaluates time relation indicating that offset 1/2 happens before timespan [2, 8) starts:

>>> abjad.timespantools.offset_happens_before_timespan_starts(
...     timespan=timespan,
...     offset=offset,
...     hold=False,
...     )
True

Returns time relation or boolean.