Welcome to the NIK Converter Library, your go-to solution for parsing Indonesian National Identification Numbers (NIK) and extracting insightful data from them!
The NIK Converter Library allows you to effortlessly convert NIK strings into structured NIKData objects. With this library, you can extract valuable information such as province, city, district, gender, birth date, age, zodiac sign, and more from Indonesian NIKs.
- NIK Parsing: Parse Indonesian National Identification Numbers (NIK) effortlessly.
- Detailed Data Extraction: Extract detailed information including province, city, district, gender, birth date, age, zodiac sign, and more from NIKs.
- Customizable Translations: Translate to Indonesian for localized data extraction.
- Easy Integration: Simple integration into your Android projects.
To integrate the NIK Converter Library into your Android project, follow these steps:
-
Add the JitPack repository to your build file:
allprojects { repositories { ... maven { url 'https://jitpack.io' } } }
-
Add the dependency:
dependencies { implementation 'com.github.mathindas:nik-converter:1.0.7' }
Here's a quick example of how to use the NIK Converter Library in your Android project:
val nikConverter = NIKConverter()
val nik = "your_nik_string_here"
val context = applicationContext // or any valid context
val nikData = nikConverter.convert(nik, context)
// val nikData = nikConverter.convert(nik, context, translateToId = true) // use this if you want to translate to indonesian
if (nikData != null) {
// Print all NIK data fields
println("Province: ${nikData.province}")
println("City: ${nikData.city}")
println("District: ${nikData.district}")
println("District Postal Code: ${nikData.districtPostalCode}")
println("Gender: ${nikData.gender}")
println("Birth Date: ${nikData.birthDate}")
println("Birth Month: ${nikData.birthMonth}")
println("Birth Year: ${nikData.birthYear}")
println("Birth Day: ${nikData.birthDay}")
println("Birthday Countdown: ${nikData.birthdayCountdown}")
println("Age: ${nikData.age}")
println("Zodiac Sign: ${nikData.zodiacSign}")
println("Chinese Zodiac: ${nikData.chineseZodiac}")
println("Unique Code: ${nikData.uniqueCode}")
} else {
println("Invalid NIK.")
}Contributions are welcome! If you encounter any issues or have suggestions for improvements, feel free to open an issue or submit a pull request.
This library is available under the MIT License. See the LICENSE file for more information.