Validate_FI::pin

Validate_FI::pin() – Validate Personal Identity Number (HETU)

Synopsis

require_once 'Validate/FI.php';

mixed Validate_FI::pin ( string $number , bool $info )

Description

Validate Personal Identity Number (HETU).

The Finnish PIN number (HETU) aka Social Security Number (SSN) is a 11 digit number with birthdate as ddmmyycxxxy where c is century, xxx is a three digit individual number and the last digit is a control number (y).

If xxx is odd it's a male PIN number and if even a female.

Return gender (Male or Female) and date of birth (YYYY-MM-DD) in array if PIN is valid, is available by switching $info (2nd parameter) to true.

Example: 010101-123N would be a male and born in 1st of January 1901.

Parameter

string $number

PIN number to be validated

boolean $info

optional; Return gender and date of birth on success

Return value

mixed - Returns true or false if $info = false or gender (Male or Female) and date of birth (YYYY-MM-DD) in array if PIN is valid, false otherwise

Example

Using pin() in default mode

<?php
// Include the package
require_once 'Validate/FI.php';

$pin '010101-123N';
if ( 
Validate_FI::pin($pin) ) {
    print 
'Valid';
} else {
    print 
'Not valid!';
}
?>

Using pin() with $info = TRUE

<?php
// Include the package
require_once('Validate/FI.php');

$pin '010101-123N';
if ( 
$userinfo Validate_FI::pin($pintrue) ) {
    
print_r($userinfo);
} else {
    print 
'Not valid!';
}
?>

Output:

    
     
Array
(
    [0] => Male
    [1] => 1901-01-01
)