---
name: "Number::Phone::Formatter::NationallyPreferredIntl"
section: "3pm"
platform: "linux"
package: "libnumber-phone-perl"
version: "4.0006-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Number::Phone::Formatter::NationallyPreferredIntl"
---

# Number::Phone::Formatter::NationallyPreferredIntl(3pm)

nationally-preferred format for international phone number

## NAME

Number::Phone::Formatter::NationallyPreferredIntl - nationally-preferred format for international phone number

## DESCRIPTION

A formatter to output the international number in its nationally preferred format.

## METHOD

### format

This is the only method. It takes an E.123 international format string and a Number::Phone object, and outputs the nationally-preferred international representation of the  phone number.

```
  +1 212 334 0611 -> +1 212-334-0611
```

Note that this uses data derived from libphonenumber, and if your object is not derived from that it will first create a temporary object. This may involve a small unexpected performance hit.

## AUTHOR, COPYRIGHT and LICENCE

Copyright 2018 Matthew Somerville \<*matthew-github@dracos.co.uk*\>

This software is free-as-in-speech software, and may be used, distributed, and modified under the terms of either the GNU General Public Licence version 2 or the Artistic Licence.  It's up to you which one you use.  The full text of the licences can be found in the files GPL2.txt and ARTISTIC.txt, respectively.