# Person

Aadhar (English: Foundation) is a 12-digit unique identity number that can be obtained by residents of India, based on their biometric and demographic data.

// usage
{{aadhar()}}
{{aadhar({ onlyLastFour: true })}} // false by default
{{aadhar({ separatedByWhiteSpace: false })}} // true by default

Generate a random aadhar.

{{aadhar()}};
=> '8506 7820 9696'

Optionally provide option of getting only the last four

{{aadhar({ onlyLastFour: true })}};
=> '1851'

Optionally specify dashes be removed

{{aadhar({ separatedByWhiteSpace: false })}};
'873300307032'

// usage
{{age()}}
{{age({ type: 'child' })}}

Generate a random age

{{age()}};
=> 45

Default range is between 1 and 120

Optionally specify one of a handful of enumerated age types:

{{age({type: 'child'})}};
=> 9

Allowed types are: child, teen, adult, senior

// usage
{{birthday()}}
{{birthday({ string: true })}}
{{birthday({ type: 'child' })}}

Generate a random birthday

{{birthday()}};
=> Fri Aug 16 1985 00:00:00 GMT-0400 (EDT)

By default, returns an actual JavaScript Date object.

Optionally specify it be returned as a string.

{{birthday({string: true})}};
=> '4/1/1968'

By default returns in MM/DD/YYYY format. Can specify DD/MM/YYYY as follows:

{{birthday({string: true, american: false})}};
=> '28/6/1993'

For more complex date formats, use the Moment library.

Can specify the type, same types as with age.

{{birthday({type: 'child'})}};
=> Sat Sep 08 2001 00:00:00 GMT-0400 (EDT)

You can compose with {{year for interesting combinations. For example, let's say we want to get the birthdays of some renaissance artists (born between 1450 and 1500). We can generate a year and then get a birthday from that year:

var year = {{year({ min: 1450, max: 1500 })}};
{{birthday({ year: year })}};
=> Wed Aug 27 1484 11:24:14 GMT-0400 (EDT)

// Could be simplified down to one line
{{birthday({ year: {{year({ min: 1450, max: 1500 })}} })}};
=> Fri Nov 26 1469 09:17:13 GMT-0500 (EST)

Can specify maxAge and/or minAge. This will return a date which yields to an age between the given range. Attention on limits: the full day of birthdays are considered to be part of the allowed range (from the first millisecond of the minimum date to the last second of the maximum date).

{{birthday({minAge: 18, maxAge: 21})}};
=> Thu Apr 18 2002 13:48:34 GMT-0400 (EDT)

// usage
{{cf()}}

Generate a random Italian social security number (Codice Fiscale).

{{cf()}};
=> 'BRSMRT87S49A988X'

Optionally specify any or all components: first name, last name, gender, birth date, place of birth (using ISTAT geocodes for Italian cities).

{{cf({first: 'Sergio', last: 'Leone'})}};
=> 'LNESRG93P28F067V'

{{cf({first: 'Sophia', last: 'Loren', gender: 'Female', birthday: new Date(1934,8,20), city: 'h501'})}};

=> 'LRNSPH34P60H501G'

// usage
{{cpf()}}

Generate a random Brazilian tax id.

{{cpf()}};
=> '607.116.899-62'

Optionally omit punctuation:

{{cpf({ formatted: false })}};
=> '18641718397'

// usage
{{first()}}
{{first({ nationality: 'en' })}}

Generate a random first name

{{first()}};
=> 'Leila'

Optionally specify a gender to limit first names to that gender

{{first({ gender: "female" })}};
=> 'Emma'

Optionally specify a nationality to limit first names to those most common of that nationality

{{first({ nationality: "it" })}};
=> 'Alberto'

Note, currently support for nationality is limited to: 'en', 'it', 'nl', 'fr'.

// usage
{{gender()}}

Generate a random gender

  {{gender()}};
  => 'Female'

Extra genders can be provided using the extraGenders key in the optional options argument:

  Chance.gender({
    extraGenders: ['Agender', 'Genderqueer', 'Trans', 'Pangender']
  });

// usage
{{last()}}
{{last({ nationality: 'en' })}}

Generate a random last name

{{last()}};
=> 'Mago'

Optionally specify a nationality to limit first names to those most common of that nationality

{{last({ nationality: 'it' })}};
=> 'Giovannini'

Note, currently support for nationality is limited to: 'en', 'it', 'nl', 'uk', 'de', 'jp', 'es', 'fr'.

// usage
{{name()}}
{{name({ middle: true })}}
{{name({ middle_initial: true })}}
{{name({ prefix: true })}}
{{name({ nationality: 'en' })}}

Generate a random name

  {{name()}};
  => 'Dafi Vatemi'

Optionally include the middle name

  {{name({ middle: true })}};
  => 'Nelgatwu Powuku Heup'

Optionally include the middle initial

  {{name({ middle_initial: true })}};
  => 'Ezme I Iza'

Optionally include the prefix

  {{name({ prefix: true })}};
  => 'Doctor Suosat Am'

Optionally include the suffix

  {{name({ suffix: true })}};
  => 'Fanny Baker Esq.'

Optionally specify a gender

  {{name({ gender: 'male' })}};
  => "Patrick Copeland"

Optionally specify a nationality

  {{name({ nationality: 'it' })}};
  => "Roberta Mazzetti"

Note, currently support for nationality is limited to: 'en', 'it'.

// usage
{{prefix()}}
{{prefix({ full: true })}}

Generate a random name prefix

{{prefix()}};
=> 'Mrs.'

By default, returns the shorter version.

Optionally get back the full version.

{{prefix({ full: true })}};
=> 'Mister'

Optionally specify a gender. Valid options are male, female, or all (the default).

{{prefix({ gender: "male" })}};
=> 'Mr.'

{{prefix({ gender: "female" })}};
=> 'Miss'

To maintain legacy support, this also responds to {{name_prefix()}}.

// usage
{{ssn()}}
{{ssn({ ssnFour: true })}}
{{ssn({ dashes: false })}}

Generate a random social security number.

{{ssn()}};
=> '411-90-0070'

Optionally provide option of getting only the last four

{{ssn({ ssnFour: true })}};
=> '2938'

Optionally specify dashes be removed

{{ssn({ dashes: false })}};
=> '293839295'

// usage
{{suffix()}}
{{suffix({ full: true })}}

Generate a random name suffix

{{suffix()}};
=> 'Sr.'

By default, returns the shorter version.

Optionally get back the full version.

{{suffix({ full: true })}};
=> 'Juris Doctor'

To maintain legacy support, this also responds to {{name_suffix()}}.

// usage
{{zodiac()}}

Generate a random zodiac signs.

{{zodiac()}};
=> 'Aries'