Deprecate Kjønn og fødselsår fra Fodselsnummer for fjerning

Fra 1.1.2032 vil nye fødselsnummer være kjønnsnøytrale. Vi kommer derfor
til å fjerne kjønn fra Fodselsnummer.

Fra 1.1.2032 vil nye fødselsnummer tildeles etter ny algoritme. Tildeling av
nummere vil starte fra 999 og telle nedover. Individnummerene vil derfor
ikke lenger med sikkerhet kunne brukes til å si noe om århundre og derfor
ikke alder.

Mer info fra Skatteetaten:
https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/

Author: eivinhb

src/main/java/no/bekk/bekkopen/person/Fodselsnummer.java

@@ -73,12 +73,30 @@ public String getMonth() {
 	/**
 	 * Returns the birthyear of the Fodselsnummer
 	 *
-	 * @return A String containing the year of birth.
+	 * @return a String containg the year of birth represented by 2 (two) digits. Century is not included.
+	 */
+	public String getYear() {
+		return get2DigitBirthYear();
+	}
+
+	/**
+	 * Returns the birthyear of the Fodselsnummer
+	 *
+	 * @return A String containing the year of birth represented by 4 (four) digits. Century is included.
+	 * @deprecated For removal - After 1.1.2032 we cannot reliably conclude correct century anymore.
+	 * <a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
+	 * replaced by {@link #getYear()}
 	 */
+	@Deprecated
 	public String getBirthYear() {
 		return getCentury() + get2DigitBirthYear();
 	}
 
+	/**
+     * @deprecated For removal - After 1.1.2032 we cannot reliably conclude correct century anymore.
+     * 	<a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
+	 */
+	@Deprecated
 	String getCentury() {
 		String result = null;
 		int individnummerInt = Integer.parseInt(getIndividnummer());
@@ -152,9 +170,12 @@ public String getIndividnummer() {
 
 	/**
 	 * Returns the digit that decides the gender - the 9th in the Fodselsnummer.
-	 *
+	 * 
+	 * @deprecated For removal - Gender will stop working after 1.1.2032
+     * 	<a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
 	 * @return The digit.
 	 */
+	@Deprecated
 	public int getGenderDigit() {
 		return getAt(8);
 	}
@@ -179,18 +200,24 @@ public int getChecksumDigit2() {
 
 	/**
 	 * Returns true if the Fodselsnummer represents a man.
-	 *
+	 * 
+	 * @deprecated For removal - Gender will stop working after 1.1.2032
+     * 	<a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
 	 * @return true or false.
 	 */
+	@Deprecated
 	public boolean isMale() {
 		return getGenderDigit() % 2 != 0;
 	}
 
 	/**
 	 * Returns true if the Fodselsnummer represents a woman.
-	 *
+	 * 
+	 * @deprecated For removal - Gender will stop working after 1.1.2032
+     * 	<a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
 	 * @return true or false.
 	 */
+	@Deprecated
 	public boolean isFemale() {
 		return !isMale();
 	}
@@ -264,6 +291,11 @@ private static int getThirdDigit(String fodselsnummer) {
 		return Integer.parseInt(fodselsnummer.substring(2, 3));
 	}
 
+	/**
+	 * @deprecated For removal - Gender will stop working after 1.1.2032
+     * 	<a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
+	 */
+	@Deprecated
 	public KJONN getKjonn() {
 		if (isFemale()) {
 			return KJONN.KVINNE;

src/main/java/no/bekk/bekkopen/person/FodselsnummerCalculator.java

@@ -47,11 +47,14 @@ private FodselsnummerCalculator() {
   /**
    * Returns a List with valid Fodselsnummer instances for a given Date and gender.
    *
+   * @deprecated For removal - Gender will stop working after 1.1.2032
+   * 	<a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
+   *
    * @param date en dato
    * @param kjonn kjønn
    * @return liste med fødselsnummer
    */
-
+	@Deprecated
 	public static List<Fodselsnummer> getFodselsnummerForDateAndGender(Date date, KJONN kjonn) {
 		List<Fodselsnummer> result = getManyFodselsnummerForDate(date);
 		splitByGender(kjonn, result);

src/main/java/no/bekk/bekkopen/person/KJONN.java

@@ -26,6 +26,11 @@
  * #L%
  */
 
+/**
+ * @deprecated For removal - Gender will stop working after 1.1.2032
+ * <a href="https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/nytt-fodselsnummer-fra-2032/">Nytt fødselsnummer fra 2032</a>
+ */
+@Deprecated
 public enum KJONN {
 
 	MANN, KVINNE, BEGGE;

src/main/java/no/bekk/bekkopen/person/KjønnExtractor.java

@@ -0,0 +1,26 @@
+package no.bekk.bekkopen.person;
+
+public class KjønnExtractor {
+
+
+	public static KJONN from(Fodselsnummer fodselsnummer) {
+		return getKjonn(fodselsnummer);
+	}
+
+	public static boolean isFemale(Fodselsnummer fodselsnummer) {
+		return !isMale(fodselsnummer);
+	}
+
+	public static boolean isMale(Fodselsnummer fodselsnummer) {
+		return fodselsnummer.getAt(8) % 2 != 0;
+	}
+
+	private static KJONN getKjonn(Fodselsnummer fodselsnummer) {
+		if (isFemale(fodselsnummer)) {
+			return KJONN.KVINNE;
+		} else {
+			return KJONN.MANN;
+		}
+	}
+
+}