Nobody Pays (for) Magazines

    nric-validator
    TypeScript icon, indicating that this package has built-in type declarations

    0.3.7 • Public • Published

    NRIC Validator

    npm library size npm

    An Utility to validate Malaysia NRIC

    I decided to publish this as public library after using this library for multiple Angular projects from Angular 5 to Angular 11.

    If you have any issue to use this library. Please creating issues here.

    Tech stacks

    • Javascript
    • Ava

    Install

    npm i nric-validator

    Features

    • check NRIC valid
    • get birth date
    • get gender
    • get age

    Benefits

    • Small bundle size
    • Work with all frameworks
    • Simple to use

    Usage

    It is simple to use the library, just import it directly to the typescript component

    import NRIC from "nric-validator";

    And use like this:

    Check NRIC valid

    Valid format is YYMMDD-PB-###G.

    YYMMDD, the person's date of birth in the ISO 8601:2000 format; for example, a person born on 16 September 1963, would have 630916 as the first six digits of their identity card. A person born on 1 January 1900 would have 000101 as the first digits, same with a person born on 1 January 2000.

    PB, the seventh and eighth digit, based on the place of birth of the person, which will be referred from the birth certificate upon application of the MyKad.

    ###, the ninth through eleventh digit is the generic special number generated by the National Registration Department of Malaysia's computer system.

    G, the 12th digit represents the gender of the person. The odd numbers for G denote male while the even numbers denote female.

    • if valid return true
    • if invalid return Error('Invalid value number format') || false
    const nric = new NRIC(value);
    nric.isValid

    Get birth date

    • if valid return birthday Fri Feb 24 1956 00:00:00 GMT+0730 (Malaysia Time)
    • if invalid return Error('Invalid value number format') || false
    const nric = new NRIC(value);
    nric.birthDate // Fri Feb 24 1956 00:00:00 GMT+0730 (Malaysia Time)

    Get gender

    • if valid return F || M
    • if invalid return Error('Invalid value number format') || false
    const nric = new NRIC(value);
    nric.gender // F (Female) or M (Male)

    Get age

    • if valid return age
    • if invalid return Error('Invalid value number format') || false
    const nric = new NRIC(value);
    nric.age // 29

    Support Traditional Way

    We can get the library directly from here:

    https://unpkg.com/nric-validator@0.3.5

    then, you can get it from window object and using normally.

    const test = new window.NRIC('560224608354');
    test.isValid // true

    Deno

    You can get library from here.

    import * as NRIC from "https://deno.land/x/nric_validator";
    

    Install

    npm i nric-validator

    DownloadsWeekly Downloads

    205

    Version

    0.3.7

    License

    MIT

    Unpacked Size

    13.9 kB

    Total Files

    9

    Last publish

    Collaborators

    • hayden.tran.d