instance method number_to_phone

Formats number into a phone number.

number_to_phone(5551234)    # => "555-1234"
number_to_phone("5551234")  # => "555-1234"
number_to_phone(1235551234) # => "123-555-1234"
number_to_phone("12x34")    # => "12x34"

number_to_phone(1235551234, delimiter: ".", country_code: 1, extension: 1343)
# => "+1.123.555.1234 x 1343"

Options

:area_code

Whether to use parentheses for the area code. Defaults to false.

number_to_phone(1235551234, area_code: true)
# => "(123) 555-1234"

:delimiter

The digit group delimiter to use. Defaults to "-".

number_to_phone(1235551234, delimiter: " ")
# => "123 555 1234"

:country_code

A country code to prepend.

number_to_phone(1235551234, country_code: 1)
# => "+1-123-555-1234"

:extension

An extension to append.

number_to_phone(1235551234, extension: 555)
# => "123-555-1234 x 555"

:pattern

A regexp that specifies how the digits should be grouped. The first three captures from the regexp are treated as digit groups.

number_to_phone(13312345678, pattern: /(\d{3})(\d{4})(\d{4})$/)
# => "133-1234-5678"
number_to_phone(75561234567, pattern: /(\d{1,4})(\d{4})(\d{4})$/, area_code: true)
# => "(755) 6123-4567"