Skip to content

fix(nz): add Matariki, King's Birthday #154

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rickar merged 1 commit into from
Jun 5, 2026
+83 −2
Merged

fix(nz): add Matariki, King's Birthday #154

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions v2/nz/matariki.go
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
package nz

import (
"time"

"github.com/rickar/cal/v2"
)

var DefaultLoc = time.Local

// CalcMatarikiOffset calculates the occurrence of a holiday that is determined
// by its relation to Matariki, the Māori New Year.
// See https://en.wikipedia.org/wiki/Matariki for more details.
// Dates 2022 to 2052 supported. Data taken from Matariki Advisory Committee report - Final Report V2 - 21 May 2021.
// https://www.mbie.govt.nz/assets/matariki-dates-2022-to-2052-matariki-advisory-group.pdf

var matarikiDates = map[int]time.Time{
2022: time.Date(2022, time.June, 24, 0, 0, 0, 0, DefaultLoc),
2023: time.Date(2023, time.July, 14, 0, 0, 0, 0, DefaultLoc),
2024: time.Date(2024, time.June, 28, 0, 0, 0, 0, DefaultLoc),
2025: time.Date(2025, time.June, 20, 0, 0, 0, 0, DefaultLoc),
2026: time.Date(2026, time.July, 10, 0, 0, 0, 0, DefaultLoc),
2027: time.Date(2027, time.June, 25, 0, 0, 0, 0, DefaultLoc),
2028: time.Date(2028, time.July, 14, 0, 0, 0, 0, DefaultLoc),
2029: time.Date(2029, time.July, 6, 0, 0, 0, 0, DefaultLoc),
2030: time.Date(2030, time.June, 21, 0, 0, 0, 0, DefaultLoc),
2031: time.Date(2031, time.July, 11, 0, 0, 0, 0, DefaultLoc),
2032: time.Date(2032, time.July, 2, 0, 0, 0, 0, DefaultLoc),
2033: time.Date(2033, time.June, 24, 0, 0, 0, 0, DefaultLoc),
2034: time.Date(2034, time.July, 7, 0, 0, 0, 0, DefaultLoc),
2035: time.Date(2035, time.June, 29, 0, 0, 0, 0, DefaultLoc),
2036: time.Date(2036, time.July, 18, 0, 0, 0, 0, DefaultLoc),
2037: time.Date(2037, time.July, 10, 0, 0, 0, 0, DefaultLoc),
2038: time.Date(2038, time.June, 25, 0, 0, 0, 0, DefaultLoc),
2039: time.Date(2039, time.July, 15, 0, 0, 0, 0, DefaultLoc),
2040: time.Date(2040, time.July, 6, 0, 0, 0, 0, DefaultLoc),
2041: time.Date(2041, time.July, 19, 0, 0, 0, 0, DefaultLoc),
2042: time.Date(2042, time.July, 11, 0, 0, 0, 0, DefaultLoc),
2043: time.Date(2043, time.July, 3, 0, 0, 0, 0, DefaultLoc),
2044: time.Date(2044, time.June, 24, 0, 0, 0, 0, DefaultLoc),
2045: time.Date(2045, time.July, 7, 0, 0, 0, 0, DefaultLoc),
2046: time.Date(2046, time.June, 29, 0, 0, 0, 0, DefaultLoc),
2047: time.Date(2047, time.July, 19, 0, 0, 0, 0, DefaultLoc),
2048: time.Date(2048, time.July, 3, 0, 0, 0, 0, DefaultLoc),
2049: time.Date(2049, time.June, 25, 0, 0, 0, 0, DefaultLoc),
2050: time.Date(2050, time.July, 15, 0, 0, 0, 0, DefaultLoc),
2051: time.Date(2051, time.June, 30, 0, 0, 0, 0, DefaultLoc),
2052: time.Date(2052, time.June, 21, 0, 0, 0, 0, DefaultLoc),
}

func CalcMatarikiOffset(h *cal.Holiday, year int) time.Time {
tm, ok := matarikiDates[year]
if !ok {
// return the first Matariki day
tm, _ = matarikiDates[2022]
return tm
}
return tm.Add(time.Duration(h.Offset) * 24 * time.Hour)
}
14 changes: 12 additions & 2 deletions v2/nz/nz_holidays.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,8 +61,8 @@ var (
Func: cal.CalcDayOfMonth,
}

// QueensBirthday represents Queen's Birthday on the first Monday in June
QueensBirthday = &cal.Holiday{
// KingsBirthday represents King's Birthday on the first Monday in June
KingsBirthday = &cal.Holiday{
Name: "Queen's Birthday",
Type: cal.ObservancePublic,
Month: time.June,
Expand All @@ -71,6 +71,16 @@ var (
Func: cal.CalcWeekdayOffset,
}

// QueensBirthday was the name of King's Birthday holiday during the reign of Queen Elizabeth II
QueensBirthday = KingsBirthday

// Matariki represents the Matariki public holiday, on the Friday closest to the Māori New Year
Matariki = &cal.Holiday{
Name: "Matariki",
Type: cal.ObservancePublic,
Func: CalcMatarikiOffset,
}

// LabourDay represents Labour Day on the fourth Monday in October
LabourDay = &cal.Holiday{
Name: "Labour Day",
Expand Down
12 changes: 12 additions & 0 deletions v2/nz/nz_holidays_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -109,6 +109,18 @@ func TestHolidays(t *testing.T) {
{BoxingDay, 2020, d(2020, 12, 26), d(2020, 12, 28)},
{BoxingDay, 2021, d(2021, 12, 26), d(2021, 12, 28)},
{BoxingDay, 2022, d(2022, 12, 26), d(2022, 12, 27)},

{Matariki, 2021, d(2022, 6, 24), d(2022, 6, 24)},
{Matariki, 2022, d(2022, 6, 24), d(2022, 6, 24)},
{Matariki, 2023, d(2023, 7, 14), d(2023, 7, 14)},
{Matariki, 2024, d(2024, 6, 28), d(2024, 6, 28)},
{Matariki, 2025, d(2025, 6, 20), d(2025, 6, 20)},
{Matariki, 2026, d(2026, 7, 10), d(2026, 7, 10)},
{Matariki, 2027, d(2027, 6, 25), d(2027, 6, 25)},
{Matariki, 2028, d(2028, 7, 14), d(2028, 7, 14)},
{Matariki, 2029, d(2029, 7, 6), d(2029, 7, 6)},
{Matariki, 2030, d(2030, 6, 21), d(2030, 6, 21)},
{Matariki, 2031, d(2031, 7, 11), d(2031, 7, 11)},
}

for _, test := range tests {
Expand Down
Loading