stdnum.gb.nhs

NHS (United Kingdom National Health Service patient identifier).

The NHS number is used by the NHS (National Health Service) and its partners to uniquely identify patients. The number is used in England, Wales and the Isle of Man. The number is assigned at birth and consists of 10 digits where the final digit is a check digit.

More information:

• https://en.wikipedia.org/wiki/NHS_number

• https://www.nhs.uk/using-the-nhs/about-the-nhs/what-is-an-nhs-number/

• https://digital.nhs.uk/article/301/NHS-Number

• https://www.datadictionary.nhs.uk/data_dictionary/attributes/n/nhs/nhs_number_de.asp

>>> validate('943-476-5870')
'9434765870'
>>> validate('9434765871')  # invalid check digit
Traceback (most recent call last):
    ...
InvalidChecksum: ...
>>> format('9434765870')
'943 476 5870'

stdnum.gb.nhs.checksum(number: str) → int

Calculate the checksum. The checksum is only used for the 9 digits of the number and the result can either be 0 or 42.

stdnum.gb.nhs.compact(number: str) → str

Convert the number to the minimal representation. This strips the number of any valid separators and removes surrounding whitespace.

stdnum.gb.nhs.format(number: str, separator: str = ' ') → str

Reformat the number to the standard presentation format.

stdnum.gb.nhs.is_valid(number: str) → bool

Check if the number is valid.

stdnum.gb.nhs.validate(number: str) → str

Check if the number is valid. This checks the length and check digit.