#formatter #parser #numbers-parser #numbers

phonenumber

Library for parsing, formatting and validating international phone numbers

15 releases

0.3.9+9.0.21 Jan 14, 2026
0.3.7+8.13.52 Jan 11, 2025
0.3.6+8.13.36 Jul 9, 2024
0.3.3+8.13.9 Sep 19, 2023
0.1.0+8.7.0 Jul 31, 2017

#13 in Value formatting

Download history 64330/week @ 2025-10-26 66753/week @ 2025-11-02 45546/week @ 2025-11-09 62218/week @ 2025-11-16 65322/week @ 2025-11-23 79403/week @ 2025-11-30 76353/week @ 2025-12-07 79398/week @ 2025-12-14 32130/week @ 2025-12-21 36671/week @ 2025-12-28 63403/week @ 2026-01-04 86600/week @ 2026-01-11 98848/week @ 2026-01-18 111475/week @ 2026-01-25 112828/week @ 2026-02-01 113442/week @ 2026-02-08

439,777 downloads per month
Used in 79 crates (44 directly)

Apache-2.0

13MB
3.5K SLoC

phonenumber

CI Build Crates.io phonenumber License

Rust version of libphonenumber. We currently require 1.76.0 as minimum supported Rust version (MSRV).

Usage

Add this to your Cargo.toml:

[dependencies]
phonenumber = "0.3"

Example

The following example parses, validates and formats the given phone number.

use phonenumber::Mode;
use std::env;

fn main() {
	let mut args = env::args().skip(1).collect::<Vec<_>>();

	if args.len() < 1 {
		panic!("not enough arguments");
	}

	let number  = args.pop().unwrap();
	let country = args.pop().map(|c| c.parse().unwrap());

	let number = phonenumber::parse(country, number).unwrap();
	let valid  = phonenumber::is_valid(&number);

	if valid {
		println!("\x1b[32m{:#?}\x1b[0m", number);
		println!();
		println!("International: {}", number.format().mode(Mode::International));
		println!("     National: {}", number.format().mode(Mode::National));
		println!("      RFC3966: {}", number.format().mode(Mode::Rfc3966));
		println!("        E.164: {}", number.format().mode(Mode::E164));
	}
	else {
		println!("\x1b[31m{:#?}\x1b[0m", number);
	}
}

Dependencies

~4.5–6.5MB
~117K SLoC