swedish holidays
v1.1.2
用於計算任何給定年份的所有瑞典假期日期的庫。
$ npm install swedish-holidays
import { getHolidays , getUpcomingHolidays , isHoliday , isPublicHoliday } from 'swedish-holidays' ;
// Get an array of all holidays for the current
const holidays = getHolidays ( ) ;
// Get an array of all holidays for a specific year
const holidays2019 = getHolidays ( 2019 ) ;
// Get an array of all upcoming holidays
const upcoming = getUpcomingHolidays ( ) ;
// Check if today is a holiday
const isItAHolidayToday = isHoliday ( ) ;
// Or if you want to check a specific date
const isThisAHoliday = isHoliday ( new Date ( '2019-12-24' ) ) ;
// Check if today is a public holiday in Sweden (see https://www.riksdagen.se/sv/dokument-lagar/dokument/svensk-forfattningssamling/lag-1989253-om-allmanna-helgdagar_sfs-1989-253)
const isItAPublicHolidayToday = isPublicHoliday ( ) ;
// Or if you want to check a specific date
const isThisAPublicHoliday = isPublicHoliday ( new Date ( '2021-11-01' ) ) ;
結果始終是一個Array
,其中填充了 JSON 格式的假期信息,包括名稱和日期。
[
{
name : 'Julafton' ,
date : '2019-12-24T00:00:00.000Z' ,
day : 24 ,
month : 12 ,
year : 2019 ,
isPublicHoliday : false ,
} ,
{
name : 'Juldagen' ,
date : '2019-12-25T00:00:00.000Z' ,
day : 25 ,
month : 12 ,
year : 2019 ,
isPublicHoliday : true ,
} ,
...
]
使用isHoliday
時,如果提供的日期不是假日,則結果為false
,否則為假日 JSON 物件。
使用isPublicHoliday
時,如果提供的日期不是公共假期,則結果為false
。
每個假期都會匯出並可以單獨使用。 IHolidayOptions
用於將參數傳遞給建構函式。支援年份和本地化。
為了方便起見,假期也可以使用其瑞典語名稱導入。
import { MidsummerEve , Midsommarafton } from 'swedish-holidays' ;
// Both will be equal instances of the same class
const midsummerA = new MidsummerEve ( { year : 2022 } ) ;
const midsummerB = new Midsommarafton ( { year : 2022 } ) ;
如果您希望使用預設語言(瑞典語)以外的語言傳回假日名稱,請使用language
JSON 物件並在將其傳遞給getHolidays
函數之前對其進行修改。
const { language } = require ( 'swedish-holidays' ) ;
const translation = { ... language } ;
// This value is 'Julafton' by default.
translation . christmasEve = 'Christmas Eve' ;
const holidays2019 = getHolidays ( 2019 , translation ) ;
// or if you want the current year
// supply a year that is 'falsy' e.g. undefined / null / 0 / false
const holidays = getHolidays ( 0 , translation ) ;
或使用介面IHolidayNames
import { getHolidays , IHolidayNames } from 'swedish-holidays' ;
const language : IHolidayNames = {
...
christmasEve : 'Christmas Eve' ,
...
}
const holidays2019 = getHolidays ( 2019 , language ) ;
該庫只能返回 1582 到 8702 之間年份的有效假期。
如果請求的年份無效,則會拋出錯誤。