Phone Format

International standard Phone Number formatter.

const phoneFormat = require('phone-format');
 
let numbers = [
        '01511999999999',
        '88888-8888',
        '(35)8888-8888',
        '[phone]',
    ];
    
let formatted = phoneFormat.normalizeArraySync(numbers);
 
console.log(formatted);
 

Installation

$ npm install phone-format

Features

Normalizes phone numbers to the international standard. Supported international formats:

• +55 (Brazil).
  • (DD) 99999-9999
  • (0DD) 99999-9999
  • (0XXDD) 99999-9999
  • Supports 8 and 9 digits long phone numbers
  • Skips all non-numeric digits
  • Numbers started with (+) are not adjusted (special chars are dropped)
  • Formatted version follows the pattern: +55DD999999999

Usage

Install the package:

$ npm install phone-format --save

Require the package:

const phoneFormat = require('phone-format');

Documentation

normalizeArraySync(phoneNumbers[, DDI, DDD])

• Parameters

  • Phone Number(s) : (Required). Accepts an Array of Phone Number strings,
  • DDI: (Default: '55'). Specifies which formatting rule to be used (Only support +55 for now)
  • DDD: (Default: '11'). Specifies the default Area Code, if not present.

• Returns

  • Array of objects as bellow:

[
    {
        formattedNumber: '01511999999999',
        originalNumber: '[phone]'
    },
    {
        formattedNumber: '88888-8888',
        originalNumber: '[phone]'
    },
    {
        formattedNumber: '(35)7777-7777',
        originalNumber: '[phone]'
    },
    {
        formattedNumber: '[phone]',
        originalNumber: '[phone]'
    }
]

License

MIT