API documentation: liturgical years, seasons, and days

Published

May 2, 2024

The liturgical year and seasons

Types

LiturgicalYear

A specific liturgical year.

Examples

julia> LiturgicalYear()
2023-2024

julia> LiturgicalYear(2023)
2023-2024

julia> using Dates
julia> LiturgicalYear(Date(2024, 4, 1))
2023-2024

Construct a LiturgicalYear from a specified Date, or default to constructing the liturgical year from today’s date.

LiturgicalYear()
LiturgicalYear(dt)

Functions for working with liturgical years

liturgical_year

Find the correct liturgical year for a given date in the civil calendar.

Examples

julia> liturgical_year()
2023-2024
julia> liturgical_year(Date(2024,4,1))
2023-2024
liturgical_year()
liturgical_year(dt)

Find correct liturgical year for a given liturgical day.

Example

julia> liturgical_year(christmas_day())
2023-2024
liturgical_year(litday)

lectionary_year

Find lectionary year cycle for a given liturgical year.

Example

julia> ly = LiturgicalYear()
2023-2024
julia> lectionary_year(ly)
'B': ASCII/Unicode U+0042 (category Lu: Letter, uppercase)
lectionary_year()
lectionary_year(lityr)

Find lectionary year cycle for the liturgical year begining in a given year of the civil calendar.

Example

julia> lectionary_year(2023)
'B': ASCII/Unicode U+0042 (category Lu: Letter, uppercase)
lectionary_year(yr)

daily_office_year

Find daily office year cycle for a given liturgical year.

Example

julia> ly = LiturgicalYear()
2023-2024
julia> daily_office_year(ly)
2
daily_office_year()
daily_office_year(lityr)

Find daily office year cycle for the liturgical year beginning in a given year in the civil calendar.

Example

julia> daily_office_year(2023)
2
daily_office_year(yr)

date_range

Find range of dates in the civil calendar for a liturgical year.

Examples

julia> date_range()
Date("2023-12-03"):Day(1):Date("2024-11-30")

julia> ly = LiturgicalYear()
2023-2024
julia> date_range(ly)
Date("2023-12-03"):Day(1):Date("2024-11-30")
date_range()
date_range(yr)

kalendar

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

Examples

julia> kalendar() |> typeof
Vector{LiturgicalDay} (alias for Array{LiturgicalDay, 1})
julia> kalendar() |> length
69

julia> ly = LiturgicalYear(2023)
2023-2024

julia> kalendar(ly) |> typeof
Vector{LiturgicalDay} (alias for Array{LiturgicalDay, 1})

julia> kalendar(ly) |> length
69

kalendar(; ...)
kalendar(lityr; src)

sundays

Find Sundays in a given liturgical year.

Examples

sundays()
sundays(lityear)

principal_feasts

Find the principal feasts for a given liturgical year. These seven feasts have priority over all other days in the liturgical calendar.

Examples

julia> principal_feasts()
7-element Vector{LiturgicalDay}:
 Christmas Day in 2023
 The Epiphany in 2024
 Easter Day in 2024
 Ascension Day in 2024
 The Day of Pentecost in 2024
 Trinity Sunday in 2024
 All Saints' Day in 2024
 julia> principal_feasts(LiturgicalYear(2023))
7-element Vector{LiturgicalDay}:
 Christmas Day in 2023
 The Epiphany in 2024
 Easter Day in 2024
 Ascension Day in 2024
 The Day of Pentecost in 2024
 Trinity Sunday in 2024
 All Saints' Day in 2024
principal_feasts()
principal_feasts(lityear)

holy_days

For a given liturgical year, find the other seventeen major feasts and fasts defined in the BCP pp. 16-17 but not included in the principal feasts found by the principal_feasts function.

Examples


julia> holy_days()
17-element Vector{Commemoration}:
 Christmas Day in 2023
 The Holy Name in 2024
 The Epiphany in 2024
 The Presentation in 2024
 The Annunciation in 2024
 The Visitation in 2024
 Holy Cross Day in 2024
 All Saints' Day in 2024
 Ascension Day in 2024
 Thanksgiving Day in 2024
 The First Day of Lent or Ash Wednesday 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> holy_days(LiturgicalYear(2023))
17-element Vector{Commemoration}:
 Christmas Day in 2023
 The Holy Name in 2024
 The Epiphany in 2024
 The Presentation in 2024
 The Annunciation in 2024
 The Visitation in 2024
 Holy Cross Day in 2024
 All Saints' Day in 2024
 Ascension Day in 2024
 Thanksgiving Day in 2024
 The First Day of Lent or Ash Wednesday 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 holy*days(; ...) holy*days(lityear; src)

Functions for working with liturgical seasons

advent_season

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

Examples

julia> advent_season()
4-element Vector{LiturgicalDay}:
 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_season(LiturgicalYear(2023))
 4-element Vector{LiturgicalDay}:
  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_season()
advent_season(lityr)

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)

christmastide

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

Examples

julia> christmastide()
4-element Vector{LiturgicalDay}:
 Christmas Day in 2023
 the first Sunday after Christmas Day, December 31, 2023
 The Holy Name in 2024
 The Epiphany in 2024
 julia> christmastide(LiturgicalYear(2023))
4-element Vector{LiturgicalDay}:
 Christmas Day in 2023
 the first Sunday after Christmas Day, December 31, 2023
 The Holy Name in 2024
 The Epiphany in 2024
christmastide()
christmastide(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_season

Find a vector of all liturgical days with assigned readings in ordinary time after Epiphany of a given liturgical year.

Examples

julia> epiphany_season()
7-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 Presentation in 2024
 the fifth Sunday after the Epiphany, February 4, 2024
 Transfiguration Sunday, February 11, 2024
 julia> epiphany_season(LiturgicalYear(2023))
7-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 Presentation in 2024
 the fifth Sunday after the Epiphany, February 4, 2024
 Transfiguration Sunday, February 11, 2024
epiphany_season()
epiphany_season(lityr)

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_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)

lent_sundays

No documentation found.

Lectionary.lent_sundays is a Function.

# 2 methods for generic function "lent_sundays" from Lectionary:
 [1] lent_sundays(lityear::LiturgicalYear)
     @ ~/Desktop/Lectionary.jl/src/seasons.jl:565
 [2] lent_sundays()
     @ ~/Desktop/Lectionary.jl/src/seasons.jl:565

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_season

Find a vector of all liturgical days with assigned readings in ordinary time after Pentecost of a given liturgical year.

Examples

julia> pentecost_season()
31-element Vector{LiturgicalDay}:
 Trinity Sunday, May 26, 2024
 The Visitation in 2024
 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 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
 All Saints' Day in 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
 Christ the King, November 24, 2024
 Thanksgiving Day in 2024
julia> pentecost_season(LiturgicalYear(2023)) == pentecost_season()
true
pentecost_season()
pentecost_season(lityr)

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)

Liturgical days

Concrete subtypes of the LiturgicalDay

Sunday: see separate page

Commemoration

A commemoration in the liturgical year other than a regular Sunday.

Examples

julia> Commemoration(Lectionary.FEAST_PENTECOST)
The Day of Pentecost, May 19, 2024
julia> Commemoration(Lectionary.FEAST_PENTECOST, 2025)
The Day of Pentecost, June 1, 2025

Construct a liturgical day for a commemoration.

Commemoration(commemoration_id)
Commemoration(commemoration_id, ly)

OtherDay

A day in the liturgical calendar that is not identified as a feast, fast or Sunday.

Example

julia> OtherDay(Date(2024,4,22))
April 22, 2024, Monday following the fourth Sunday of Easter

Construct an OtherDay for today.

Example

julia> OtherDay()
April 22, 2024, Monday following the fourth Sunday of Easter
OtherDay()

Functions for working with liturgical days

name

Name of a commemoration in the liturgical calendar.

Example

julia> name(ash_wednesday())
"The First Day of Lent or Ash Wednesday"
name(comm)

Name of a Sunday in the liturgical calendar.

Example

julia> name(easter_sunday())
"Easter Day"
name(sday)

Name of an OtherDay in the liturgical calendar.

Example

julia> otherday = OtherDay(Date(2024, 5, 6))
May 6, 2024, Monday following the sixth Sunday of Easter
julia> name(otherday)
"Monday following the sixth Sunday of Easter"
name(other)

civildate

Find the date in the civil calendar for a commemoration.

Example

julia> civildate(ash_wednesday())
2024-02-14
civildate(comm)

Find the date in the civil calendar for a given Sunday.

Example

julia> civildate(easter_sunday())
2024-03-31
civildate(sday)

Find the date in civil calendar for an ordinary day in the liturgical year.

Example

julia> otherday = OtherDay(Date(2024, 5, 6))
May 6, 2024, Monday following the sixth Sunday of Easter
julia> civildate(otherday)
2024-05-06
civildate(other)

liturgical_day

Find the correct liturgical day for a given date in the civil calendar.

Example

julia> liturgical_day(Date(2024,4,1))
April 1, 2024, Monday following Easter Day
liturgical_day()
liturgical_day(dt)

weekday

Find name of day of week of commemoration.

Example

julia> weekday(christmas_day())
"Monday"
weekday(fst)

Find name of day of week of commemoration.

Example

julia> weekday(OtherDay(Date(2024, 5, 6)))
"Monday"
weekday(otherday)

Functions for constructing particular liturgical days

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)

christmas_day

Find Christmas Day for a given liturgical year.

christmas_day()
christmas_day(lityr)

Find Christmas Day for a given year in the civil calendar.

christmas_day(yr)

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)

epiphany_day

Construct the Day of Epiphany for a given liturgical year.

Examples

julia> epiphany_day()
The Epiphany, January 6, 2024
julia> epiphany_day(LiturgicalYear(2023))
The Epiphany, January 6, 2024
epiphany_day()
epiphany_day(lityr)

Construct the Day of Epiphany for a given year in the civil calendar.

Example

julia> epiphany_day(2024)
The Epiphany, January 6, 2024
epiphany_day(yr)

Construct the Day of Epiphany for a given liturgical year.

Examples

julia> epiphany_day()
The Epiphany, January 6, 2024
julia> epiphany_day(LiturgicalYear(2023))
The Epiphany, January 6, 2024
epiphany_day()
epiphany_day(lityr)

Construct the Day of Epiphany for a given year in the civil calendar.

Example

julia> epiphany_day(2024)
The Epiphany, January 6, 2024
epiphany_day(yr)

epiphany

Find a numbered Sunday of the ordinary time after Epiphany in a given liturgical year.

ash_wednesday

Construct Ash Wednesday for a given liturgical year.

Examples

julia> ash_wednesday()
The First Day of Lent or Ash Wednesday, February 14, 2024
julia> ash_wednesday(LiturgicalYear(2023))
The First Day of Lent or Ash Wednesday, February 14, 2024
ash_wednesday()
ash_wednesday(lityr)

Construct Ash Wednesday for a given year in the civil calendar.

Example

julia> ash_wednesday(2024)
The First Day of Lent or Ash Wednesday, February 14, 2024
ash_wednesday(yr)

ash_wednesday_date

Find the date of Ash Wednesday in a given liturgical year in the civil calendar.

Examples

julia> ash_wednesday_date()
2024-02-14
julia> ash_wednesday_date(LiturgicalYear(2023))
2024-02-14
ash_wednesday_date()
ash_wednesday_date(lityr)

Find the date of Ash Wednesday for a given year in the civil calendar.

**Examples*

julia> ash_wednesday_date(2024)
2024-02-14
ash_wednesday_date(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)

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)

holyweek

No documentation found.

Binding holyweek does not exist.

good_friday

Construct Good Friday for a given liturtical year.

Example

good_friday()
good_friday(lityr)

Construct Good Friday for a given year in the civil calendar.

Example

good_friday(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)

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)

ascension

Find Ascension Day in a given liturgical year.

ascension()
ascension(lityr)

Find Ascension Day in a given year of the civil calendar.

ascension(yr)

thanksgiving

Find Thanksgiving Day in a given liturgical year.

thanksgiving()
thanksgiving(lityr)

Find Thanksgiving Day in a given year of the civil calendar.

thanksgiving(yr)