File

projects/ngx-persian/src/lib/JDate/jalali-date-validator.service.ts

Description

Methods of this Service doing validation stuff on a Jalali date. You can use this Service using DI in all around of your app for validating Jalali dates without needing to convert them to the Georgian Date.

Index

Properties
Methods

Constructor

constructor()

Methods

isJYearLeap
isJYearLeap(jYear: number)

If JYear is a leap year in jalali Calendar, return true. We using the fact that if a year is leap, number of leap years until that year and the year after it is not equal.

Parameters :
Name Type Optional Description
jYear number No

full jalali year like: 1397

Returns : boolean
isValidJDate
isValidJDate(jYear: number, jMonth: number, jDay: number)

If Jalali date is not a valid Jalali date, return false. otherwise returns true.

Parameters :
Name Type Optional Description
jYear number No

full year number like: 1397

jMonth number No

starts from zero

jDay number No

starts from one

Returns : boolean
isValidJDay
isValidJDay(jYear: number, jMonth: number, jDay: number)

Checks if day number is in valid range according to the given year and month.

Parameters :
Name Type Optional Description
jYear number No

full jalali year like 1397

jMonth number No

month number starting from zero

jDay number No

day number starting from one

Returns : boolean
isValidJMonth
isValidJMonth(jMonth: number, startFromZero: boolean)

Checks if jalali month is in valid range or not. In default, jMonth should start from zero. If you want to start month number from one instead of zero, you should make startFromZero parameter to false.

Parameters :
Name Type Optional Default value
jMonth number No
startFromZero boolean No true
Returns : boolean
isValidJYear
isValidJYear(jYear: number)

Checks if jalali year is in acceptable range or not.

Implementation in source code

Parameters :
Name Type Optional Description
jYear number No

full jalali year like 1397

Returns : boolean
jMonthLength
jMonthLength(jYear: number, jMonth: number)

Returns number of days in a given month counting from 1.

Parameters :
Name Type Optional Description
jYear number No

full jalali year like 1397

jMonth number No

number of month from 0 for Farvardin to 11 for Esfand.

Returns : number
numOfJLeapYears
numOfJLeapYears(targetJYear: number)

Calculates the number of the leap years in jalali Calendar.

Implementation in source code

Parameters :
Name Type Optional Description
targetJYear number No

should be full year like: 1397 and should be between -61 to 3177.

[Implementation in source code]://github.com/sijad/ts-jalaali/blob/296a7c2fa1816a5bbb0b11bbe3eb03ebc17059f6/src/jalaali.ts#L71https

Returns : number

Properties

Private Static _maxAcceptableYear
Type : number
Default value : 3177
Private Static _minAcceptableYear
Default value : -61
import {Injectable} from '@angular/core';
import {div, mod} from './ArithmeticUtils';
import {InvalidJalaliDateError} from './InvalidJalaliDate.error';


/**
 * Methods of this Service doing validation stuff on a Jalali date. You can use this Service using DI in all around of your app for
 * validating Jalali dates without needing to convert them to the Georgian Date.
 */
@Injectable({
    providedIn: 'root'
})
export class JalaliDateValidatorService {

    private static _minAcceptableYear = -61;
    private static _maxAcceptableYear = 3177;

    constructor() {
    }

    /**
     * Returns number of days in a given month counting from 1.
     *
     * @param jYear full jalali year like 1397
     * @param jMonth number of month from 0 for Farvardin to 11 for Esfand.
     */
    jMonthLength(jYear: number, jMonth: number): number {
        if (jMonth < 6) {
            return 31;
        }
        if (jMonth < 11 || this.isJYearLeap(jYear)) {
            return 30;
        }
        return 29;
    }


    /**
     * Calculates the number of the leap years in jalali Calendar.
     *
     * @param targetJYear should be full year like: 1397 and should be between -61 to 3177.
     *
     * [Implementation in source code]{@link https://github.com/sijad/ts-jalaali/blob/296a7c2fa1816a5bbb0b11bbe3eb03ebc17059f6/src/jalaali.ts#L71}
     */
    numOfJLeapYears(targetJYear: number): number {
        // Jalali years starting the 33-year rule.
        const breaks = [
            -61, 9, 38, 199, 426, 686, 756, 818, 1111, 1181, 1210,
            1635, 2060, 2097, 2192, 2262, 2324, 2394, 2456, 3178
        ];

        const breaksLength = breaks.length;
        let jp = breaks[0];
        let jump = 0;
        let leapJ = -14;

        if (!this.isValidJYear(targetJYear)) {
            throw new InvalidJalaliDateError();
        }

        // Find the limiting years for the Jalali year jy.
        for (let i = 1; i < breaksLength; i += 1) {
            const jm = breaks[i];
            jump = jm - jp;
            if (targetJYear < jm) {
                break;
            }
            leapJ = leapJ + (div(jump, 33) * 8) + div(mod(jump, 33), 4);
            jp = jm;
        }
        const n = targetJYear - jp;

        // Find the number of leap years from AD 621 to the beginning
        // Of the current Jalali year in the Persian Calendar.
        leapJ = leapJ + (div(n, 33) * 8) + div(mod(n, 33) + 3, 4);

        if (mod(jump, 33) === 4 && jump - n === 4) {
            leapJ += 1;
        }
        return leapJ;
    }

    /**
     * If JYear is a leap year in jalali Calendar, return true. We using the fact that if a year is leap, number of leap years until that year
     * and the year after it is not equal.
     *
     * @param jYear full jalali year like: 1397
     */
    isJYearLeap(jYear: number): boolean {
        return this.numOfJLeapYears(jYear) !== this.numOfJLeapYears(jYear + 1);
    }

    /**
     * Checks if jalali year is in acceptable range or not.
     *
     * [Implementation in source code]{@link https://github.com/sijad/ts-jalaali/blob/296a7c2fa1816a5bbb0b11bbe3eb03ebc17059f6/src/jalaali.ts#L27}
     *
     * @param jYear full jalali year like 1397
     */
    isValidJYear(jYear: number): boolean {
        return jYear >= JalaliDateValidatorService._minAcceptableYear && jYear <= JalaliDateValidatorService._maxAcceptableYear;
    }

    /**
     * Checks if jalali month is in valid range or not. In default, jMonth should start from zero.
     * If you want to start month number from one instead of zero, you should make startFromZero parameter to false.
     */
    isValidJMonth(jMonth: number, startFromZero: boolean = true): boolean {
        let minMonthNumber = 0;
        let maxMonthNumber = 11;
        if (!startFromZero) {
            minMonthNumber++;
            maxMonthNumber++;
        }
        return jMonth >= minMonthNumber && jMonth <= maxMonthNumber;
    }

    /**
     * Checks if day number is in valid range according to the given year and month.
     *
     * @param jYear full jalali year like 1397
     * @param jMonth month number starting from zero
     * @param jDay day number starting from one
     */
    isValidJDay(jYear: number, jMonth: number, jDay: number): boolean {
        return jDay <= this.jMonthLength(jYear, jMonth) && jDay > 0;
    }

    /**
     * If Jalali date is not a valid Jalali date, return false. otherwise returns true.
     *
     * @param jYear full year number like: 1397
     * @param jMonth starts from zero
     * @param jDay starts from one
     */
    isValidJDate(jYear: number, jMonth: number, jDay: number): boolean {
        return this.isValidJYear(jYear) && this.isValidJMonth(jMonth) && this.isValidJDay(jYear, jMonth, jDay);
    }
}

results matching ""

    No results matching ""