Skip to content

Latest commit

 

History

History
138 lines (76 loc) · 3.83 KB

normalize.md

File metadata and controls

138 lines (76 loc) · 3.83 KB
Raw

Phony.normalize

Normalizes a number, such that only numbers remain. Use before saving a normalized form into a database.

This will often raise an error if you try normalizing a non E164-izable number (a number that does not contain enough information to be normalized into an E164 conform number). Use Phony.plausible? for checking if it can be normalized first.

Example:

# No. Wrong. Nada.
Phony.normalize('364 35 33')

Always use it with a country code, as Phony needs it to know what country to normalize for:

Phony.normalize('41443643533').assert            == '41443643533'
Phony.normalize('+41 44 364 35 33').assert       == '41443643533'
Phony.normalize('+41 44 364 35 33').assert       == '41443643533'
Phony.normalize('+41 800 11 22 33').assert       == '41800112233'
Phony.normalize('John: +41 44 364 35 33').assert == '41443643533'
Phony.normalize('1 (703) 451-5115').assert       == '17034515115'
Phony.normalize('1-888-407-4747').assert         == '18884074747'
Phony.normalize('1.906.387.1698').assert         == '19063871698'
Phony.normalize('+41 (044) 364 35 33').assert    == '41443643533'

Example countries

NANP

Handles a CC.

Phony.normalize('+1 724 999 9999').assert == '17249999999'

Allows for providing a missing CC.

Phony.normalize('(310) 555-2121', cc: '1').assert == '13105552121'

Normalizes numbers with special characters.

Phony.normalize('1 (703) 451-5115').assert == '17034515115'

Normalizes numbers with special characters.

Phony.normalize('1-888-407-4747').assert == '18884074747'

Belarus

Phony.normalize('375 152450911').assert == '375152450911'
Phony.normalize('375 80 331234567').assert == '375331234567'

Cambodia

Handles numbers with an extra 0.

Phony.normalize('+855012239134').assert == "85512239134"

Germany

Handles a number with extra (0).

Phony.normalize('+49 (0) 209 22 33 44 55').assert == '4920922334455'

Handles a number with extra 0.

Phony.normalize('+49 0 209 22 33 44 55').assert == '4920922334455'

Hungary

Phony.normalize('36 0630245506').assert == '360630245506'

Japan

# TODO Phony.normalize('03-1234-5634', cc: '81').assert == '81312345634'

Japan

Phony.normalize('+81 3-1234-5634').assert == '81312345634'
Phony.normalize('3-1234-5634', cc: '81').assert == '81312345634'
Phony.normalize('03-1234-5634', cc: '81').assert == '81312345634'

Lithuania

Phony.normalize('370 8 5 1234567').assert == '370851234567'

Netherlands

Handles the Dutch number (without US cc) correctly.

Phony.normalize('310 5552121').assert == '315552121'

Russia

Phony.normalize('7 8 342 1234567').assert == '783421234567'

Unsupported Countries

Phony.normalize('+881-321 5560 5220').assert == '88132155605220'

Special Cases

Normalizes a too short number.

Phony.normalize('+972').assert == '972'

Normalizes an already normalized number.

Phony.normalize('41443643533').assert == '41443643533'

Normalizes a formatted number.

Phony.normalize('+41 44 364 35 33').assert == '41443643533'

Normalizes a 00 number.

Phony.normalize('0041 44 364 35 33').assert == '41443643533'

Normalizes a service number.

Phony.normalize('+41 800 11 22 33').assert == '41800112233'

Removes characters.

Phony.normalize('John: +41 44 364 35 33').assert == '41443643533'

Normalizes a number with colons.

Phony.normalize('1.906.387.1698').assert == '19063871698'

Normalizes an erroneous zero.

Phony.normalize('+410443643533').assert == '41443643533'

Does not normalize a correct 0 away.

Phony.normalize('+390909709511').assert == '390909709511'

Handles completely crazy 'numbers'.

Phony.normalize('Hello, I am Cora, the 41th parrot of the United States, and 44 is my 364 times 35 funky number. 32.').assert == '41443643532'