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' ) ) ;
結果は常に、名前や日付を含む JSON 形式の休日情報が含まれるArray
になります。
[
{
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 年までの有効な休日のみを返すことができます。
無効な年が要求された場合、エラーがスローされます。