convert-region

A simple utility to convert region abbreviations to full names and vice-versa. Built with Typescript. Less than 4KB with zero dependencies.

Story

I found myself building an application with location data being return from an existing API as abbreviations but, for presentation's sake, I needed full state names. I ended up writing a utility locally within my project, and ultimately decided to publish. I'll continue updating it with more countries, and eventually take over the world. Check out my website if ya wanna.

Usage

To use, install the package:

NPM

npm install convert-region

Yarn

yarn add convert-region

Then import it into your component:

import { convertRegion } from 'convert-region'

convertRegion returns two methods - toFullName& toAbbreviaton.

toFullName To convert an abbreviation to a full name pass in an abbreviation from the list below:

convertRegion.toFullName('NY');

which will return New York.

toAbbreviation To convert a full name to an abbreviation pass in an name from the list below:

convertRegion.toFullName('New York');

which will return NY.

Currently Available Regions

This utility currently covers all of North America; more regions will be added in the future.

United States

Canada

Mexico