swedish holidays تنزيل - swedish holidays تنزيل كود المصدر

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