Regex and cron

Regex for US ZIP Codes

Accept US ZIP codes in both formats the postal service uses, without losing leading zeros.

  • Free foreverNo trial, no paywall, no usage limits.
  • No sign-upOpen the page and start. We never ask for an email to use a tool.
  • PrivateEverything runs in your browser. Your input is never uploaded or stored on our servers.
  • Works offlineOnce the page has loaded, the tool keeps working without a connection.

Pattern

/^\d{5}(?:-\d{4})?$/

Regular expression

JavaScript syntax, run by your browser's own engine in a background worker. Press / anywhere to jump here.
Reset to the original pattern and examplesShow cheat sheet: click any token to insert itCopy pattern
Find every match instead of stopping at the first. Needed for matchAll() and for replacing all occurrences.Case-insensitive: /abc/i also matches "ABC" and "aBc".^ and $ match at the start and end of every line, not just the whole string. Use it to test one value per line.Lets . match line breaks too. Without it, . stops at \n and \r.Treats the pattern as Unicode code points: enables \p{…} property escapes and \u{…}, makes emoji count as one character, and rejects sloppy escapes.Only matches starting exactly at lastIndex (position 0 here), never further along. Useful for tokenizers that consume input piece by piece.Records the start and end index of every capture group (match.indices). The tester always shows group positions, so this only changes your code.The upgraded unicode mode (ES2024): set operations like [\p{L}--[a-z]] and [A&&B], string properties like \p{RGI_Emoji}. Cannot be combined with u.
4 matches4 matches

Test string

Matches are highlighted as you type, in alternating colors. Click inside a match (or hover its row below) to color its capture groups.
4 matchesClear test string

Explanation

Every part of the pattern in plain English. Hover a row to highlight that part of the pattern.
Copy explanation

Loading the explainer…

Every match with its position and capture groups.Preview a replacement with $1, $<name> and $& references, then copy the result.Copy a ready-to-run snippet for JavaScript, Python, Go, C#, PHP or Dart.

Matches

Named groups are shown by name. undefined means the group did not take part in that match.
Copy matches as JSONDownload matches.csv
#MatchPosition
1902100–5
2100016–11
30213412–17
490210-123418–28

Need a secure web app built around this? Talk to our team

Quick answer

The regex for a US ZIP code is ^\d{5}(?:-\d{4})?$: exactly five digits, optionally followed by a hyphen and the four-digit ZIP+4 extension. It matches 90210, 02134 and 90210-1234, and rejects 4- or 6-digit codes and extensions without the hyphen. Store ZIP codes as text, never as numbers, so codes in New England keep their leading zero.

  • Tested examples
  • Token-by-token breakdown
  • Code in 5 languages
  • Live tester

How to use the US ZIP code regex

  1. 1Copy the pattern with Copy pattern in the tester, or take a ready-made snippet for your language from the code section below.
  2. 2Check the sample lines in Test string: every line the US ZIP code regex accepts is highlighted, rejected lines stay plain.
  3. 3Paste your own values one per line to see which pass, and read Explanation for what each part of the pattern does.
  4. 4Open the Code tab for JavaScript, Python, Go, C#, PHP or Dart with the pattern translated and escaped.
  5. 5Validate again on the server: client-side checks give users quick feedback, not security.

How does the US ZIP code regex work?

Read it left to right. Each piece below matches one part of the input:

  • ^\d{5} Start of the string and exactly five digits.
  • (?:-\d{4})? Optionally a hyphen and the four-digit ZIP+4 add-on.
  • $ End of the string.

Which strings does the US ZIP code regex match?

The whole input must match, from the first character to the last. Every row below is checked against the pattern by our automated test suite before each release.

InputMatches?Why
90210YesBeverly Hills.
10001YesNew York.
02134YesBoston: the leading zero is part of the code.
90210-1234YesZIP+4.
9021NoFour digits (often a ZIP that lost its leading zero).
902101NoSix digits.
90210-123NoThe extension needs four digits.
90210 1234NoA space instead of the hyphen.
902101234NoNine digits without the hyphen (see the variant below).
ABCDENoLetters.

Why do ZIP codes lose their leading zero?

Because something treated them as numbers. Spreadsheets, CSV imports and <input type="number"> all turn 02134 into 2134, and every ZIP code in Massachusetts, Connecticut, New Jersey, Puerto Rico and much of New England starts with 0. Keep ZIP codes as strings end to end: type="text" with inputmode="numeric" and autocomplete="postal-code" gives a numeric keypad without the conversion.

If you receive data that has already lost zeros, pad it back with zip.padStart(5, "0") before validating, but only when you know the source is US data.

Does a valid ZIP code format mean the ZIP exists?

No. Not every five-digit number is assigned (00000 passes this pattern), ZIP codes are delivery routes rather than areas, and they change. To check that a ZIP exists or matches a city and state, use the USPS address APIs or an address-verification service at checkout.

To accept a nine-digit ZIP with or without the hyphen, use ^\d{5}(?:-?\d{4})?$, and normalize to the hyphenated form before storing. For other countries, see the UK postcode and India PIN code patterns.

How do I use the US ZIP code regex in JavaScript, Python, Go, C# and PHP?

The pattern is translated for each engine rather than pasted as is: named groups, anchors, escapes, shorthand classes and flags are adjusted so each snippet behaves as closely to the JavaScript version as its engine allows. Differences that remain (Go's RE2 has no lookarounds or backreferences, for example) are called out under each one. The Code tab in the tester above also exports Dart, and updates as you edit the pattern.

JavaScript and TypeScript

const regex = /^\d{5}(?:-\d{4})?$/;

function isValid(value) {
  return regex.test(value);
}

console.log(isValid("90210"));

Python

import re

pattern = re.compile(r"^[0-9]{5}(?:-[0-9]{4})?\Z")

def is_valid(value: str) -> bool:
    return pattern.search(value) is not None

print(is_valid("90210"))
  • \d and \w are written as [0-9] and [A-Za-z0-9_] because in Python they also match digits and letters from other scripts.
  • JavaScript's $ only matches at the very end of the string. Python's $ also matches before a trailing newline, so the pattern uses \Z instead.

Go

package main

import (
	"fmt"
	"regexp"
)

func main() {
	re := regexp.MustCompile(`^\d{5}(?:-\d{4})?$`)
	fmt.Println(re.MatchString("90210"))
}

C#

using System;
using System.Text.RegularExpressions;

// The timeout stops a pathological input from hanging the thread (ReDoS).
var regex = new Regex(@"^[0-9]{5}(?:-[0-9]{4})?\z", RegexOptions.None, TimeSpan.FromSeconds(1));
Console.WriteLine(regex.IsMatch("90210"));
  • \d and \w are written as [0-9] and [A-Za-z0-9_] because in .NET they also match digits and letters from other scripts.
  • JavaScript's $ only matches at the very end of the string. .NET's $ also matches before a trailing newline, so the pattern uses \z instead.

PHP

<?php

$pattern = '/^\d{5}(?:-\d{4})?$/D';

function isValid(string $value, string $pattern): bool
{
    return preg_match($pattern, $value) === 1;
}

var_dump(isValid('90210', $pattern));
  • The D modifier makes $ match only at the very end, like JavaScript (PCRE's $ also matches before a trailing newline).

Browse all 25 patterns in the regex pattern library, or build your own in the regex tester.

Frequently asked questions

An optional four-digit extension that narrows delivery to a block, building or PO box, written after a hyphen as in 90210-1234. Most forms accept the five-digit code alone.
Yes. Codes in the Northeast, such as 02134 in Boston and 06103 in Hartford, start with 0, which is why ZIP codes must be stored as text.
Only when the selected country is the United States. Choose the pattern from the country field, because postal code formats differ everywhere and some countries have none.

Last updated by the Playxoft engineering team.

From the engineers who built this tool

Building something bigger than a quick fix?

Auth, payments, dashboards and security are where web apps get hard. We have shipped them many times. Share your idea and we will map out a realistic plan and estimate, free and with no obligation.

More free tools

See all tools

Regex Tester

Test regex live with highlighted matches, plain-English explanations and code export.

Open tool

Cron Expression Generator

New

Build and explain cron schedules, see the next runs in any time zone, copy platform snippets.

Open tool

SQL Formatter

Beautify or minify SQL in 12 dialects, with keyword case, indent and line:column errors.

Open tool

cURL to Python Converter

New

Convert cURL commands into Python requests or httpx code with params, json, files and auth.

Open tool

cURL to Fetch Converter

New

Turn any cURL command into JavaScript fetch() code with headers, JSON, forms and auth.

Open tool

cURL to Axios Converter

New

Convert cURL commands into an Axios request config with params, data, auth and timeouts.

Open tool