https://github.com/mpolla/fin-id-utils
Tools for Finnish personal identity codes HETU (henkilötunnus) and SATU (sähköinen asiointitunnus).
https://github.com/mpolla/fin-id-utils
digijavaestovirasto dvv finland finnish-identity-codes henkilotunnus hetu identity java jvm kotlin sahkoinenasiointi satu suomi
Last synced: 5 months ago
JSON representation
Tools for Finnish personal identity codes HETU (henkilötunnus) and SATU (sähköinen asiointitunnus).
- Host: GitHub
- URL: https://github.com/mpolla/fin-id-utils
- Owner: mpolla
- Created: 2019-10-07T13:11:56.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-17T13:56:40.000Z (over 1 year ago)
- Last Synced: 2024-09-18T16:09:14.340Z (over 1 year ago)
- Topics: digijavaestovirasto, dvv, finland, finnish-identity-codes, henkilotunnus, hetu, identity, java, jvm, kotlin, sahkoinenasiointi, satu, suomi
- Language: Kotlin
- Homepage:
- Size: 165 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
fin-id-utils - validate Finnish personal identity codes
=======================================================
This library provides tools for Finnish personal identity codes HETU (henkilötunnus) ans SATU (sähköinen asiointitunnus).
Features
* Validate HETU and SATU identity codes.
* Check gender of a HETU code.
* Generate random codes.
See https://dvv.fi/en/personal-identity-code
## Add dependency
Apache Maven
com.github.mpolla
fin-id-utils
0.5.4
Gradle Kotlin DSL
implementation("com.github.mpolla:fin-id-utils:0.5.4")
Gradle Groovy DSL
implementation 'com.github.mpolla:fin-id-utils:0.5.4'
## Usage (Java)
Validate a HETU/SATU code.
```java
boolean validHetu = HetuUtil.isValid("131052+308T");
boolean validSatu = SatuUtil.isValid("10011187H");
```
Check the gender of a HETU code.
```java
boolean isFemale = HetuUtil.isFemale("131052-308T");
```
Generate random HETU/SATU code.
```java
String randomHetu = HetuUtil.generateRandom();
String randomSatu = SatuUtil.generateRandom();
```
Compute the control character suffix for a HETU code.
```java
Char controlCharacter = HetuUtil.computeControlCharacter("131052-308");
```
## Usage (Kotlin)
Validate a HETU/SATU code.
```kotlin
val validHetu = HetuUtil.isValid("131052+308T")
val validSatu = SatuUtil.isValid("10011187H")
```
Check the gender of a HETU code.
```kotlin
val isFemale = HetuUtil.isFemale("131052-308T")
```
Generate random HETU/SATU code.
```kotlin
val randomHetu = HetuUtil.generateRandom()
val randomSatu = SatuUtil.generateRandom()
```
Compute the control character suffix for a HETU code.
```kotlin
val controlCharacter = HetuUtil.computeControlCharacter("131052-308")
```
## Development
Publish new release
git tag x.x
./gradlew publish
