Small utility for validating and creating Finnish social security numbers. No more, no less, no dependencies.
npm install finnish-ssn-2- A micro Javascript library for validating and creating Finnish social security numbers
- Zero dependencies
- This is a fork of vkomulai/finnish-ssn.
- adds support for new formats of Finnish personal identity codes (valid from 2023)
``sh`
npm install finnish-ssn-2
ES6 / TypeScript
`js`
import { FinnishSSN } from 'finnish-ssn-2'
const isValid = FinnishSSN.validate('010101C100X')
console.log(isValid) // Yields true
Validate an SSN
`js
// This is a valid SSN
console.log('valid ssn returns ' + FinnishSSN.validate('290296-7808'))
// 'valid ssn returns true'
// This is an invalid SSN
console.log('invalid ssn returns ' + FinnishSSN.validate('010198Y1000'))
// 'invalid ssn returns false'
`
Parse SSN
`js`
// This is a valid SSN
var parsedSsn = FinnishSSN.parse('290296W7808')
console.log(parsedSsn)
//
// {
// valid: true,
// sex: 'female',
// ageInYears: 19,
// dateOfBirth: Thu Feb 29 1996 00:00:00 GMT+0200 (EET)
//}
Create an SSN for person that is 20 years old.
`js`
console.log('SSN for person that is 20 years old ' + FinnishSSN.createWithAge(20))
// SSN for person that is 20 years old 010195-XXXX
- Validates parameter given SSN. Returns true if SSN is valid, otherwise false
- Parses parameter given SSN. Returns object {valid: boolean, sex: "male|female", ageInYears: Number, dateOfBirth: Date }
`js`
{
valid: false,
sex: null,
ageInYears: null,
dateOfBirth: null
}
{
valid: true,
sex: 'male',
ageInYears: 15,
dateOfBirth: Tue Feb 29 2000 00:00:00 GMT+0200 (EET)
}
{
valid: true,
sex: 'female',
ageInYears: 15,
dateOfBirth: Mon Feb 28 2000 00:00:00 GMT+0200 (EET)
}
- Creates a valid SSN using the given age (Integer). Generates randomly male and female SSN's.
`sh
npm run dist
- Support for new formats of Finnish personal identity code (valid from 2023)
- Initial release (forked from vkomulai/finnish-ssn)