API documentation: schedule of readings

Published

May 3, 2024

Note

In determining readings for days in the liturgical year, Lectionary.jl does not attempt to take account of transferal of the readings for a feast to another day. For example, feasts that fall on a Sunday or during Holy Week are normally transferred to a suitable following time.

Type

Readings

A set of readings for a single liturgy.

Functions

readings

Find all readings in RCL for a given liturgical year.

readings(; ...)
readings(lityr; as_urn, track, service)

Find readings in RCL for a given day in a given liturgical year.

readings(theday; ...)
readings(theday, lityr; as_urn, track, service)

Find readings in RCL for a given day in a given year of the civil calendar.

readings(theday; ...)
readings(theday, yr; as_urn, service, track)

reading1

Find first reading (normally Old Testament) from the assigned readings for a liturgy.

Example

julia> rdgs = readings(christmas_day())
Readings("Isaiah 9.2-9.7", "Titus 2.11-2.14", "Luke 2.1-1.14 ;  Luke 2.1-2.20", "Psalm 96")
julia> reading1(rdgs)
1-element Vector{Vector{String}}:
 ["Isaiah 9.2-9.7"]

reading1(rdg; as_urn)

Find first reading (normally Old Testament) for a given day.

Example

julia> reading1(christmas_day())
1-element Vector{Vector{String}}:
 ["Isaiah 9.2-9.7"]


julia reading1(theday; as_urn)

reading2

Find second reading (normally New Testament) from the assigned readings for a liturgy.

Example

julia> rdgs = readings(christmas_day())
Readings("Isaiah 9.2-9.7", "Titus 2.11-2.14", "Luke 2.1-1.14 ;  Luke 2.1-2.20", "Psalm 96")
julia> reading2(rdgs)
1-element Vector{Vector{String}}:
 ["Titus 2.11-2.14"]

reading2(rdg; as_urn)

Find second reading (normally New Testament) for a given day.

Example

julia> reading2(christmas_day())
1-element Vector{Vector{String}}:
 ["Titus 2.11-2.14"]]


julia reading2(theday; as_urn)

psalm

Find Psalm selection from the assigned readings for a liturgy.

Example

julia> rdgs = readings(christmas_day())
Readings("Isaiah 9.2-9.7", "Titus 2.11-2.14", "Luke 2.1-1.14 ;  Luke 2.1-2.20", "Psalm 96")
julia> gospel(rdgs)
1-element Vector{Vector{String}}:
 ["Psalm 96"]

psalm(rdg; as_urn)

Find second reading (normally New Testament) for a given day.

Example

julia> psalm(christmas_day())
1-element Vector{Vector{String}}:
 ["Psalm 96"]


julia psalm(theday; as_urn)

gospel

Find Gospel selection from the assigned readings for a liturgy.

Example

julia> rdgs = readings(christmas_day())
Readings("Isaiah 9.2-9.7", "Titus 2.11-2.14", "Luke 2.1-1.14 ;  Luke 2.1-2.20", "Psalm 96")
julia> gospel(rdgs)
2-element Vector{Vector{String}}:
 ["Luke 2.1-1.14"]
 ["Luke 2.1-2.20"]

gospel(rdg; as_urn)

Find second reading (normally New Testament) for a given day.

Example

julia> gospel(christmas_day())
2-element Vector{Vector{String}}:
 ["Luke 2.1-1.14"]
 ["Luke 2.1-2.20"]


julia gospel(theday; as_urn)

precedence

Priority of a commemoration. Lower values override higher values in determining which of two sets of readings to prefer.

Examples

precedence(comm)

Priority of an ordinary day.

Examples

julia> dec25 = OtherDay(Date(2023,12,25))
December 25, 2023, Monday following the fourth Sunday of Advent
julia> xmas = christmas_day()
Christmas Day, December 25, 2023
julia> precedence(xmas) <  precedence(dec25)
true

precedence(other)