API documentation: the LiturgicalSunday

The LiturgicalSunday is a subtype of the LiturgicalDay.

The following functions generate a LiturgicalSunday or a Vector of LiturgicalSundays for specific Sundays belonging either to a given liturgical year, or to a given year in the civil calendar.

advent

Find a numbered Sunday in Advent in a given liturgical year.

advent(sunday)
advent(sunday, lityr)

Examples

julia> advent(1) 
the first Sunday of Advent, December 3, 2023
julia> advent(1, LiturgicalYear(2023))
the first Sunday of Advent, December 3, 2023

Find a numbered Sunday in Advent in a given year of the civil calendar.

Example

julia> advent(1, 2023)
the first Sunday of Advent, December 3, 2023

advent(sunday, yr)

advent_sundays

Find all Sundays of Advent in a given year of the civil calendar.

Example

julia> advent_sundays(2023)
4-element Vector{Sunday}:
 the first Sunday of Advent, December 3, 2023
 the second Sunday of Advent, December 10, 2023
 the third Sunday of Advent, December 17, 2023
 the fourth Sunday of Advent, December 24, 2023

advent_sundays(yr)

Find all Sundays of Advent in a given liturgical year.

Examples

julia> advent_sundays()
4-element Vector{LiturgicalSunday}:
 the first Sunday of Advent, December 3, 2023
 the second Sunday of Advent, December 10, 2023
 the third Sunday of Advent, December 17, 2023
 the fourth Sunday of Advent, December 24, 2023
 julia> advent_sundays(LiturgicalYear(2023))
4-element Vector{LiturgicalSunday}:
 the first Sunday of Advent, December 3, 2023
 the second Sunday of Advent, December 10, 2023
 the third Sunday of Advent, December 17, 2023
 the fourth Sunday of Advent, December 24, 2023

advent_sundays()
advent_sundays(lityear)

christmas

Find a numbered Sunday of the Christmas season in a given year of the civil calendar.

Example

julia> christmas(1,  2023)
the first Sunday after Christmas Day, December 31, 2023

christmas(sunday, yr)

Find a numbered Sunday of the Christmas season in a given liturgical year.

Examples

julia> christmas(1)
the first Sunday after Christmas Day, December 31, 2023
julia> christmas(1, LiturgicalYear(2023))
the first Sunday after Christmas Day, December 31, 2023

christmas(sunday)
christmas(sunday, lityr)

christmas_sundays

Find all Sundays in the season of Christmas in a given liturgical year.

Examples

julia> christmas_sundays()
1-element Vector{LiturgicalSunday}:
 the first Sunday after Christmas Day, December 31, 2023
 julia> christmas_sundays(LiturgicalYear(2023))
1-element Vector{LiturgicalSunday}:
 the first Sunday after Christmas Day, December 31, 2023

christmas_sundays()
christmas_sundays(lityr)

Find all Sundays in the season of Christmas in a given year of the civil calendar.

Examples

julia> christmas_sundays(2023)
1-element Vector{LiturgicalSunday}:
 the first Sunday after Christmas Day, December 31, 2023

julia christmas_sundays(yr)

epiphany_sundays

Find all Sundays of ordinary time after Epiphany in a given liturgical year.

Examples

julia> epiphany_sundays()
5-element Vector{LiturgicalDay}:
 the first Sunday after the Epiphany, January 7, 2024
 the second Sunday after the Epiphany, January 14, 2024
 the third Sunday after the Epiphany, January 21, 2024
 the fourth Sunday after the Epiphany, January 28, 2024
 the fifth Sunday after the Epiphany, February 4, 2024
julia> epiphany_sundays(LiturgicalYear(2023))
5-element Vector{LiturgicalDay}:
 the first Sunday after the Epiphany, January 7, 2024
 the second Sunday after the Epiphany, January 14, 2024
 the third Sunday after the Epiphany, January 21, 2024
 the fourth Sunday after the Epiphany, January 28, 2024
 the fifth Sunday after the Epiphany, February 4, 2024

epiphany_sundays()
epiphany_sundays(lityr)

Find all Sundays of ordinary time after Epiphany season in a given year of the civil calendar. Omit Transfiguration, for inclusion in list of Commemorations.

Example

julia> epiphany_sundays(LiturgicalYear(2023))
5-element Vector{LiturgicalDay}:
the first Sunday after the Epiphany, January 7, 2024
the second Sunday after the Epiphany, January 14, 2024
the third Sunday after the Epiphany, January 21, 2024
the fourth Sunday after the Epiphany, January 28, 2024
the fifth Sunday after the Epiphany, February 4, 2024

epiphany_sundays(yr)

lent

Find a numbered Sunday of Lent in a given liturgial year.

Examples

julia> lent(1)
the first Sunday in Lent, February 18, 2024
julia> lent(1, LiturgicalYear(2023))
the first Sunday in Lent, February 18, 2024

lent(sunday)
lent(sunday, lityr)

Find a numbered Sunday of Lent in a given year in the civil calendar.

Examples

julia> lent(1, 2024)
the first Sunday in Lent, February 18, 2024

lent(sunday, yr)

lent_season

Find a vector of all liturgical days with assigned readings in Lent of a given liturgical year.

Examples

julia> lent_season()
14-element Vector{LiturgicalDay}:
 The First Day of Lent or Ash Wednesday in 2024
 the first Sunday in Lent, February 18, 2024
 the second Sunday in Lent, February 25, 2024
 the third Sunday in Lent, March 3, 2024
 the fourth Sunday in Lent, March 10, 2024
 the fifth Sunday in Lent, March 17, 2024
 Palm Sunday, March 24, 2024
 The Annunciation in 2024
 Monday of Holy Week in 2024
 Tuesday of Holy Week in 2024
 Wednesday of Holy Week in 2024
 Holy Thursday in 2024
 Good Friday in 2024
 Holy Saturday in 2024
 julia> lent_season(LiturgicalYear(2023)) == lent_season()
 true

lent_season()
lent_season(lityr)

palm_sunday

Construct Palm Sunday for a given liturgical year.

Examples

julia> palm_sunday()
Palm Sunday, March 24, 2024
julia> palm_sunday(LiturgicalYear(2023))
Palm Sunday, March 24, 2024

palm_sunday()
palm_sunday(lityr)

Construct Palm Sunday for a given year in the civil calendar.

Example

julia> palm_sunday(2024)
Palm Sunday, March 24, 2024

palm_sunday(yr)

easter_sunday

Construct Easter in a given liturgical year.

Examples

julia> easter_sunday()
Easter Day, March 31, 2024
julia> easter_sunday(LiturgicalYear(2023))
Easter Day, March 31, 2024

easter_sunday()
easter_sunday(lityr)

Construct Easter in a given year of the civil calendar.

Example

julia> easter_sunday(2024)
Easter Day, March 31, 2024

easter_sunday(yr)

eastertide

Find a vector of all liturgical days with assigned readings in Eastertide of a given liturgical year.

Examples

julia> eastertide()
9-element Vector{LiturgicalDay}:
 Easter Day, March 31, 2024
 the second Sunday of Easter, April 7, 2024
 the third Sunday of Easter, April 14, 2024
 the fourth Sunday of Easter, April 21, 2024
 the fifth Sunday of Easter, April 28, 2024
 the sixth Sunday of Easter, May 5, 2024
 Ascension Day in 2024
 the seventh Sunday of Easter, May 12, 2024
 the day of Pentecost, May 19, 2024
julia> eastertide(LiturgicalYear(2023)) == eastertide()
true

eastertide()
eastertide(lityr)

Find a numbered Sunday of Easter season in a given liturgical year.

Examples

julia> eastertide(2)
the second Sunday of Easter, April 7, 2024
julia> eastertide(2, LiturgicalYear(2023))
the second Sunday of Easter, April 7, 2024

eastertide(sunday)
eastertide(sunday, lityr)

Find a numbered Sunday of Easter season in a given year of the civil calendar.

Examples

julia> eastertide(2, 2024)
the second Sunday of Easter, April 7, 2024

eastertide(sunday, yr)

easter_sundays

Find all Sundays following Easter in the Easter season of given liturgical year.

Examples

julia> easter_sundays()
6-element Vector{LiturgicalSunday}:
 the second Sunday of Easter, April 7, 2024
 the third Sunday of Easter, April 14, 2024
 the fourth Sunday of Easter, April 21, 2024
 the fifth Sunday of Easter, April 28, 2024
 the sixth Sunday of Easter, May 5, 2024
 the seventh Sunday of Easter, May 12, 2024
 julia> easter_sundays(LiturgicalYear(2023))
6-element Vector{LiturgicalSunday}:
 the second Sunday of Easter, April 7, 2024
 the third Sunday of Easter, April 14, 2024
 the fourth Sunday of Easter, April 21, 2024
 the fifth Sunday of Easter, April 28, 2024
 the sixth Sunday of Easter, May 5, 2024
 the seventh Sunday of Easter, May 12, 2024 

easter_sundays()
easter_sundays(lityr)

Find all Sundays following Easter in the Easter season of given year in the civil calendar.

Examples

julia> easter_sundays(2024)
6-element Vector{LiturgicalSunday}:
 the second Sunday of Easter, April 7, 2024
 the third Sunday of Easter, April 14, 2024
 the fourth Sunday of Easter, April 21, 2024
 the fifth Sunday of Easter, April 28, 2024
 the sixth Sunday of Easter, May 5, 2024
 the seventh Sunday of Easter, May 12, 2024
 julia> easter_sundays(LiturgicalYear(2023)) 

easter_sundays(yr)

pentecost_day

Find the Sunday of Pentecost in a given liturgical year.

Examples

julia> pentecost_day()
the day of Pentecost, May 19, 2024
julia> pentecost_day(LiturgicalYear(2023))
the day of Pentecost, May 19, 2024

pentecost_day()
pentecost_day(lityr)

Find the Sunday of Pentecost in a year of the civil calendar.

Example

julia> pentecost_day(2024)
the day of Pentecost, May 19, 2024

pentecost_day(yr)

trinity

Find Trinity Sunday in a given liturgical year.

Examples

julia> trinity()
Trinity Sunday, May 26, 2024
julia> trinity(LiturgicalYear(2023))
Trinity Sunday, May 26, 2024

trinity()
trinity(lityr)

Find Trinity Sunday in a given year of the civil calendar.

Example

julia> trinity(2024)
Trinity Sunday, May 26, 2024

trinity(yr)

pentecost

Find a numbered Sunday in ordinary time after Pentecost in a given liturgical year.

Examples

julia> pentecost(3)
the third Sunday after Pentecost, June 9, 2024
julia> pentecost(3, LiturgicalYear(2023))
the third Sunday after Pentecost, June 9, 2024

pentecost(sunday)
pentecost(sunday, lityr)

Find a numbered Sunday in ordinary time after Pentecost in a given year of the civil calendar.

Example

julia> pentecost(3,2024)
the third Sunday after Pentecost, June 9, 2024

pentecost(sunday, yr)

pentecost_sundays

In a given liturgical year, find all Sundays in ordinary time after Pentecost.

Examples

julia> pentecost_season()
26-element Vector{LiturgicalSunday}:
 the second Sunday after Pentecost, June 2, 2024
 the third Sunday after Pentecost, June 9, 2024
 the fourth Sunday after Pentecost, June 16, 2024
 the fifth Sunday after Pentecost, June 23, 2024
 the sixth Sunday after Pentecost, June 30, 2024
 the seventh Sunday after Pentecost, July 7, 2024
 the eighth Sunday after Pentecost, July 14, 2024
 the ninth Sunday after Pentecost, July 21, 2024
 the tenth Sunday after Pentecost, July 28, 2024
 the eleventh Sunday after Pentecost, August 4, 2024
 ⋮
 the nineteenth Sunday after Pentecost, September 29, 2024
 the twentieth Sunday after Pentecost, October 6, 2024
 the twenty-first Sunday after Pentecost, October 13, 2024
 the twenty-second Sunday after Pentecost, October 20, 2024
 the twenty-third Sunday after Pentecost, October 27, 2024
 the twenty-fourth Sunday after Pentecost, November 3, 2024
 the twenty-fifth Sunday after Pentecost, November 10, 2024
 the twenty-sixth Sunday after Pentecost, November 17, 2024
 the twenty-seventh Sunday after Pentecost, November 24, 2024
 julia> pentecost_season(LiturgicalYear(2023))
26-element Vector{LiturgicalSunday}:
 the second Sunday after Pentecost, June 2, 2024
 the third Sunday after Pentecost, June 9, 2024
 the fourth Sunday after Pentecost, June 16, 2024
 the fifth Sunday after Pentecost, June 23, 2024
 the sixth Sunday after Pentecost, June 30, 2024
 the seventh Sunday after Pentecost, July 7, 2024
 the eighth Sunday after Pentecost, July 14, 2024
 the ninth Sunday after Pentecost, July 21, 2024
 the tenth Sunday after Pentecost, July 28, 2024
 the eleventh Sunday after Pentecost, August 4, 2024
 ⋮
 the nineteenth Sunday after Pentecost, September 29, 2024
 the twentieth Sunday after Pentecost, October 6, 2024
 the twenty-first Sunday after Pentecost, October 13, 2024
 the twenty-second Sunday after Pentecost, October 20, 2024
 the twenty-third Sunday after Pentecost, October 27, 2024
 the twenty-fourth Sunday after Pentecost, November 3, 2024
 the twenty-fifth Sunday after Pentecost, November 10, 2024
 the twenty-sixth Sunday after Pentecost, November 17, 2024
 the twenty-seventh Sunday after Pentecost, November 24, 2024

julia pentecost*sundays() pentecost*sundays(lityr)

In a given year in the civil calendar, find all Sundays in ordinary time after Pentecost.

Example

julia> pentecost_season(2024)
26-element Vector{LiturgicalSunday}:
 the second Sunday after Pentecost, June 2, 2024
 the third Sunday after Pentecost, June 9, 2024
 the fourth Sunday after Pentecost, June 16, 2024
 the fifth Sunday after Pentecost, June 23, 2024
 the sixth Sunday after Pentecost, June 30, 2024
 the seventh Sunday after Pentecost, July 7, 2024
 the eighth Sunday after Pentecost, July 14, 2024
 the ninth Sunday after Pentecost, July 21, 2024
 the tenth Sunday after Pentecost, July 28, 2024
 the eleventh Sunday after Pentecost, August 4, 2024
 ⋮
 the nineteenth Sunday after Pentecost, September 29, 2024
 the twentieth Sunday after Pentecost, October 6, 2024
 the twenty-first Sunday after Pentecost, October 13, 2024
 the twenty-second Sunday after Pentecost, October 20, 2024
 the twenty-third Sunday after Pentecost, October 27, 2024
 the twenty-fourth Sunday after Pentecost, November 3, 2024
 the twenty-fifth Sunday after Pentecost, November 10, 2024
 the twenty-sixth Sunday after Pentecost, November 17, 2024
 the twenty-seventh Sunday after Pentecost, November 24, 2024

pentecost_sundays(yr)