kalevkom / isikukood-js

Validates and generates Estonian personal ID.

Estonian personal ID (isikukood)

JavaScript class for both browser and Node. Generates and validates Estonian personal IDs.

Check demo

Version 3

• Fully backwards compatible with previous major versions 2.x.x and 1.x.x.
• Migrated to TypeScript.
• Removed CommonJS support, use ESModules.

Version 2

• Fully backwards compatible with previous major versions 1.x.x.

Install

Install via npm, yarn or pnpm.

npm install isikukood
yarn install isikukood
pnpm install isikukood

Download and include JS file into your HTML.

<script src="./dist/isikukood.esm.js" type="module"></script>

Using ES Modules

import {Isikukood} from './dist/isikukood.esm.js';

Usage

Usage example.

// Validation
const ik = new Isikukood('47502124911');
const isValid = ik.validate(); // true is valid, false isn't valid
const sex = ik.getGender(); // "male" or "female"
const age = ik.getAge(); // person's age
const birthday = ik.getBirthday(); // person's birthday

// Generation
const validIk = Isikukood.generate(); // "49002124277"

// Generate with parameters
const maleIk = Isikukood.generate({
  gender: 'male',
  birthDay: 23,
  birthMonth: 3,
  birthYear: 1984,
});

API

Instance methods

Method	Description	Arguments	Return
new Isikukood()	constructor	number | string	Isikukood
validate()	Validates personal ID	-	boolean
generate()	Static function generates a valid personal ID	GenerateInput	string
getGender()	Get the gender of a person	-	Gender
getBirthday()	Get the birthday of a person	-	Date
getAge()	Get the birthday of a person in years	-	number
getControlNumber()	Gets the control number of personal ID	-	number
parse()	Parses the code	-	PersonalData

Static methods

Method	Description	Arguments	Return
parse()	Parses the code	number | string	PersonalData

Development

Be sure that your GNU Make software is installed on your system. Development commands are very simple.

Everything

make

Build

make build

Test

make test

Contribution

Any help is appreciated. Found a bug, typo, inaccuracy, etc.? Please do not hesitate to make a pull request or file an issue.

License

MIT License 2014-2023