SwedishIdentityNumbers 1.0.2

Based on the provided class definitions and their methods, here is an updated version of your README.md file:

SwedishIdentityNumbers

A .NET library for working with Swedish identity numbers.

Overview

The SwedishIdentityNumbers library provides a set of classes for working with Swedish identity numbers:

• Personnummer for personal identity numbers
• Samordningsnummer for coordination numbers
• Organisationsnummer for organization numbers

Each of these classes inherits from the abstract base class SwedishIdentityNumber, which provides common functionality for validating and working with identity numbers.

Installation

Install SwedishIdentityNumbers via NuGet:

dotnet add package SwedishIdentityNumbers

Or search for SwedishIdentityNumbers in the NuGet package manager in Visual Studio.

Usage

Create a Personnummer

using SwedishIdentityNumbers;

var personnummer = new Personnummer("8507301234"); // also allows 850730-1234
// throws 
// ArgumentNullException if null
// ArgumentException if empty
// FormatException if not of the correct format

Get the Date of Birth (a DateOnly) from a Personnummer

var dateOfBirth = personnummer.DateOfBirth;

Try to create a Personnummer

using SwedishIdentityNumbers;

if (Personnummer.TryCreate("8507301234", out var personnummer)) // also allows 850730-1234
{
    // Successfully created
}

Create a Samordningsnummer

using SwedishIdentityNumbers;

var samordningsnummer = new Samordningsnummer("8507901234"); // also allows 850790-1234
// throws 
// ArgumentNullException if null
// ArgumentException if empty
// FormatException if not of the correct format

Get the Date of Birth (a DateOnly) from a Samordningsnummer

var dateOfBirth = samordningsnummer.DateOfBirth;

Working with Organisationsnummer

using SwedishIdentityNumbers;

var organisationsnummer = new Organisationsnummer("5560360793"); // also allows 165560360793 and 556036-0793
// throws 
// ArgumentNullException if null
// ArgumentException if empty
// FormatException if not of the correct format

Determine the Probable Swedish Company Form

var companyForm = organisationsnummer.ProbableSwedishCompanyForm;

Swedish Company Forms

The library includes a SwedishCompanyForm enum, representing different forms of companies in Sweden. This enum is used in conjunction with the Organisationsnummer class to identify the probable form of a company based on its organization number. The different enum values represent various types of company forms, ranging from Joint Stock Companies to Government Agencies. The implementation and enum values are based on information from Bolagsverket.

public enum SwedishCompanyForm
{
    JointStockCompany,  // Aktiebolag, filialer, banker, f�rs�kringsbolag och europabolag
    GeneralPartnership, // Handelsbolag och kommanditbolag
    HousingCooperative, // Bostadsr�ttsf�reningar, ekonomiska f�reningar, etc.
    ReligiousCommunity, // Trossamfund
    GovernmentAgency,   // Statlig myndighet
    Unknown             // Ok�nd
}

## Development

To work on `SwedishIdentityNumbers`, clone the repo and open `SwedishIdentityNumbers.sln` in Visual Studio or your preferred editor.

## Testing

Run the tests in `SwedishIdentityNumbers.Tests` to ensure everything is working correctly.

## License

`SwedishIdentityNumbers` is licensed under the MIT License. See the [LICENSE](./LICENSE.txt) file for details.