Formato dei codici postali per paese: riferimento regex 2026

Gli Stati Uniti usano cinque cifre o ZIP+4, il che tenta gli sviluppatori a modellare i codici postali come interi. Quel modello si rompe immediatamente in Canada, Regno Unito, Paesi Bassi, Irlanda, Malta e Argentina, dove le lettere fanno parte del codice. Si rompe anche silenziosamente in Germania, Francia, Spagna, Italia e Polonia, dove gli zeri iniziali sono significativi e una colonna intera li elimina.

Una seconda classe di bug deriva dalla posizione. La maggior parte dei paesi occidentali mette il codice postale dopo la città, ma Germania, Francia, Paesi Bassi e Giappone lo collocano prima della città, e il Giappone mette l'intero codice all'inizio assoluto dell'indirizzo. Se il tuo modulo genera un template fisso, produrrà indirizzi che un lettore locale trova palesemente sbagliati anche se ogni campo è compilato.

La maggior parte dell'Europa usa codici numerici a lunghezza fissa. Germania, Francia, Spagna, Italia, Grecia, Turchia e Arabia Saudita usano cinque cifre; Austria, Belgio, Svizzera, Danimarca, Norvegia, Ungheria e Sudafrica ne usano quattro; Polonia e Portogallo aggiungono un trattino; la Svezia usa tre cifre, uno spazio e due. La Cechia usa cinque cifre tipicamente scritte con uno spazio dopo la terza.

Asia e America Latina sono per lo più numeriche ma con lunghezze diverse. India, Cina, Russia, Singapore e Nigeria usano sei cifre; il Giappone ne usa sette con un trattino convenzionale dopo la terza; la Corea del Sud ne usa cinque; il Brasile ne usa otto con un trattino dopo la quinta; il Cile ne usa sette; la Colombia ne usa sei; Perù e Messico ne usano cinque. La sola lunghezza non basta a identificare un paese, ed è per questo che un validatore ha bisogno del campo paese prima di validare qualsiasi cosa.

Il Canada usa il pattern A1A 1A1, e le lettere sono limitate. Il primo carattere non può essere D, F, I, O, Q, U, W o Z, e le lettere rimanenti non possono essere D, F, I, O, Q o U. Lo spazio tra i due gruppi è convenzionale. Un validatore che consente qualsiasi lettera accetterà codici che Canada Post non emette mai.

Il Regno Unito usa un codice esterno di due-quattro caratteri seguito da un singolo spazio e un codice interno di tre caratteri, come in SW1A 1AA. I Paesi Bassi sono quattro cifre, uno spazio e due lettere maiuscole. L'Irlanda usa un Eircode di sette caratteri diviso in una routing key di tre caratteri e un identificatore univoco di quattro caratteri. Malta è tre lettere, uno spazio e quattro cifre. L'Argentina usa il CPA di otto caratteri, una lettera seguita da quattro cifre e tre lettere, per esempio C1425ABC.

Hong Kong e gli Emirati Arabi Uniti non hanno un sistema di codici postali. Entrambi sono nel set di fixture di 38 paesi di questo sito, e il generatore restituisce un valore postale vuoto per loro invece di inventare cifre. Questo è il comportamento corretto ed è anche un caso di test utile, perché un modulo che contrassegna il codice postale come obbligatorio è rotto per entrambi i mercati.

La convenzione negli Emirati è un numero di casella postale, che non è un codice postale e non dovrebbe essere forzato in quel campo. Gli indirizzi di Hong Kong usano il distretto e la via, e la posta viene consegnata senza alcun codice. Se il tuo modello dati richiede un valore postale non nullo, usa un sentinella esplicito come un flag a livello di paese, non un codice falso, perché un codice falso supererà la validazione e poi fallirà ogni controllo a valle che presuppone un codice reale.

Un controllo di struttura risponde se una stringa corrisponde al pattern del paese. Un controllo di esistenza risponde se il codice appare in un dataset di riferimento. Solo il secondo può dirti che un codice non è mai stato assegnato. Questo sito esegue il controllo di struttura per tutti i 38 paesi e un controllo di esistenza per gli ZIP statunitensi su 40.979 righe, e li etichetta diversamente così nessuno li confonde.

Nessuno dei due controlli prova la consegnabilità. Uno ZIP statunitense di cinque cifre può esistere mentre l'indirizzo stradale sotto di esso no, e un codice tedesco strutturalmente valido può appartenere a una città diversa da quella fornita. Se hai bisogno di quel livello di garanzia, ti serve un dataset di riferimento postale e un database a livello di strada, che è un prodotto diverso da un controllo di formato.

Ancora ogni pattern. Un /\d{5}/ non ancorato corrisponde alle cinque cifre dentro una stringa di nove cifre e riporta successo. Usa ^ e $, o l'API equivalente di corrispondenza completa. In JavaScript, \d corrisponde solo alle cifre ASCII; in Python, \d corrisponde per impostazione predefinita alle cifre Unicode, quindi un pattern può accettare numeri arabi orientali a meno che tu non compili con re.ASCII o scriva [0-9].

Decidi esplicitamente se il separatore è obbligatorio. Per la visualizzazione, inserisci tu stesso il separatore canonico. Per l'input, accetta zero o uno spazio o trattino e normalizza. Fai attenzione ai trattini all'interno delle classi di caratteri, dove definiscono intervalli a meno che non siano escapati o posizionati per ultimi. E non usare un flag case-insensitive per coprire un bug di normalizzazione: converti in maiuscolo al momento della scrittura e mantieni la forma di visualizzazione canonica.

Memorizza una forma canonica e deriva la forma di visualizzazione. La forma canonica è di solito maiuscola con il separatore standard, o solo cifre quando il separatore è puramente convenzionale. Conserva l'input grezzo dell'utente in una colonna separata se hai bisogno di una traccia di controllo, perché la normalizzazione è lossy e un agente di supporto potrebbe aver bisogno di vedere esattamente cosa è stato digitato.

La normalizzazione specifica per paese è piccola ma reale. Il Canada vuole lettera-cifra-lettera maiuscola, spazio, cifra-lettera-cifra. I Paesi Bassi vogliono lettere maiuscole dopo le cifre. Il Regno Unito vuole un singolo spazio e maiuscole. Brasile e Giappone usano un trattino che gli utenti spesso omettono, quindi normalizza alla forma con trattino. La Germania non vuole alcun separatore e deve mantenere lo zero iniziale.

Ogni validatore ha bisogno di un corpus con almeno un caso valido e uno non valido per paese, più casi che testano specificamente la normalizzazione e l'archiviazione. La tabella seguente è un set iniziale. Nota che diversi casi non validi sono non validi per ragioni specifiche del paese anziché generiche, ed è qui che la maggior parte dei test scritti a mano si ferma troppo presto.

Aggiungi casi per i paesi senza codice postale, per gli zeri iniziali e per le varianti di separatore che gli utenti digitano davvero. Se il validatore è condiviso tra client e server, esegui lo stesso corpus contro entrambe le implementazioni; una divergenza tra un client permissivo e un server rigoroso è la fonte più comune di segnalazioni del tipo "il modulo l'ha accettato ma l'API l'ha rifiutato".