feat: add holidays for South Africa

Author: confusedbuffalo

README.md

@@ -600,6 +600,7 @@ Almost everything from opening_hours definition is supported, as well as some ex
     - [Russian][ph-ru]
     - Slovakia
     - [Slovenia][ph-si]
+    - [South Africa][ph-za]
     - Spain
     - [Sweden][ph-se]
     - [Switzerland][ph-ch]
@@ -622,6 +623,7 @@ Almost everything from opening_hours definition is supported, as well as some ex
     - Hungary (good until 2024–2025)
     - Luxembourg (good until 2025–2026)
     - Romania (good until 2021)
+    - South Africa (2025–2027)
 
 - There can be two cases which need to be separated (this applies for PH and SH):
 
@@ -904,5 +906,6 @@ Edit: This does also work on npmjs in this short version … -->
 [ph-ua]: https://uk.wikipedia.org/wiki/%D0%A1%D0%B2%D1%8F%D1%82%D0%B0_%D1%82%D0%B0_%D0%BF%D0%B0%D0%BC%27%D1%8F%D1%82%D0%BD%D1%96_%D0%B4%D0%BD%D1%96_%D0%B2_%D0%A3%D0%BA%D1%80%D0%B0%D1%97%D0%BD%D1%96
 [ph-us]: https://en.wikipedia.org/wiki/Public_holidays_in_the_United_States
 [ph-vn]: https://vi.wikipedia.org/wiki/C%C3%A1c_ng%C3%A0y_l%E1%BB%85_%E1%BB%9F_Vi%E1%BB%87t_Nam
+[ph-za]: https://www.gov.za/about-sa/public-holidays
 
 <!-- }}} -->

src/holidays/index.js

@@ -35,3 +35,4 @@ export { default as ua } from './ua.yaml';
 export { default as us } from './us.yaml';
 export { default as vn } from './vn.yaml';
 export { default as xa } from './xa.yaml';
+export { default as za } from './za.yaml';

src/holidays/za.yaml

@@ -0,0 +1,42 @@
+---
+
+_nominatim_url: 'https://nominatim.openstreetmap.org/reverse?format=json&lat=-28.8747&lon=25.0372&zoom=18&addressdetails=1&accept-language=en'
+
+# https://www.gov.za/about-sa/public-holidays
+# https://en.wikipedia.org/wiki/Public_holidays_in_South_Africa
+PH:
+  - {'name': "New Year's Day", 'variable_date': 'nextMo-Sa01January'}
+  - {'name': 'Human Rights Day', 'variable_date': 'nextMo-Sa21March'}
+  - {'name': 'Good Friday', 'variable_date': easter, 'offset': -2}
+  - {'name': 'Family Day', 'variable_date': easter, 'offset': 1}
+  - {'name': 'Freedom Day', 'variable_date': 'nextMo-Sa27April'}
+  - {'name': "Workers' Day", 'variable_date': 'nextMo-Sa01May'}
+  - {'name': 'Youth Day', 'variable_date': 'nextMo-Sa16June'}
+  - {'name': "National Women's Day", 'variable_date': 'nextMo-Sa09August'}
+  - {'name': 'Heritage Day', 'variable_date': 'nextMo-Sa24September'}
+  - {'name': 'Day of Reconciliation', 'variable_date': 'nextMo-Sa16December'}
+  - {'name': 'Christmas Day', 'variable_date': 'nextMo-Sa25December'}
+  - {'name': 'Day of Goodwill', 'variable_date': 'nextMo-Sa26December'}
+
+# https://www.gov.za/about-sa/school-calendar
+SH:
+  - name: Before term 1
+    '2025': [1, 1, 1, 14]
+    '2026': [1, 1, 1, 13]
+    '2027': [1, 1, 1, 12]
+  - name: Between term 1 and term 2
+    '2025': [3, 29, 4, 7]
+    '2026': [3, 28, 4, 7]
+    '2027': [3, 20, 4, 5]
+  - name: Between term 2 and term 3
+    '2025': [6, 28, 7, 21]
+    '2026': [6, 27, 7, 20]
+    '2027': [6, 26, 7, 21]
+  - name: Between term 3 and term 4
+    '2025': [10, 4, 10, 12]
+    '2026': [9, 24, 10, 5]
+    '2027': [9, 23, 10, 6]
+  - name: After term 4
+    '2025': [12, 11, 12, 31]
+    '2026': [12, 10, 12, 31]
+    '2027': [9, 10, 12, 31]

src/index.js

@@ -2842,12 +2842,20 @@ export default function(value, nominatim_object, optional_conf_parm) {
             'nextSaturday20Jun'     : getDateOfWeekdayInDateRange(6, new Date(year, 5, 20)),
             'nextSaturday31Oct'     : getDateOfWeekdayInDateRange(6, new Date(year, 9, 31)),
             'nextWednesday16Nov'    : getDateOfWeekdayInDateRange(3, new Date(year, 10, 16)),
+            'nextMo-Sa01January'    : getDateOfNextWeekdayRange(1, 6, new Date(year, 0, 1)),
             'nextMo-Fr17March'      : getDateOfNextWeekdayRange(1, 5, new Date(year, 2, 17)),
+            'nextMo-Sa21March'      : getDateOfNextWeekdayRange(1, 6, new Date(year, 2, 21)),
+            'nextMo-Sa27April'      : getDateOfNextWeekdayRange(1, 6, new Date(year, 3, 27)),
             'nextMo-Sa01May'        : getDateOfNextWeekdayRange(1, 6, new Date(year, 4, 1)),
             'nextMo-Fr12July'       : getDateOfNextWeekdayRange(1, 5, new Date(year, 6, 12)),
+            'nextMo-Sa16June'       : getDateOfNextWeekdayRange(1, 6, new Date(year, 5, 16)),
             'nextMo-Sa07August'     : getDateOfNextWeekdayRange(1, 6, new Date(year, 7, 7)),
             'nextMo-Fr30November'   : getDateOfNextWeekdayRange(1, 5, new Date(year, 10, 30)),
+            'nextMo-Sa09August'     : getDateOfNextWeekdayRange(1, 6, new Date(year, 7, 9)),
+            'nextMo-Sa24September'  : getDateOfNextWeekdayRange(1, 6, new Date(year, 8, 24)),
+            'nextMo-Sa16December'   : getDateOfNextWeekdayRange(1, 6, new Date(year, 11, 16)),
             'nextMo-Sa25December'   : getDateOfNextWeekdayRange(1, 6, new Date(year, 11, 25)),
+            'nextMo-Sa26December'   : getDateOfNextWeekdayRange(1, 6, new Date(year, 11, 26)),
             'springEquinox'         : springEquinoxCalc(year),
             'autumnalEquinox'       : autumnalEquinoxCalc(year),
         };