Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Country-specific Django helpers for New Zealand.

Project description

Country-specific Django helpers for New Zealand.

What’s in the New Zealand localflavor?

  • forms.NZRegionSelect - a Select widget with a list of New Zealand regions.
  • forms.NZProvinceSelect - a Select widget with a list of New Zealand provinces.
  • forms.NZNorthIslandSelect - a Select widget with a list of Norh Island city and district councils.
  • forms.NZSouthIslandSelect - a Select widget with a list of South Island city and district councils.
  • forms.NZPostCodeField - a form field that validates input as a New Zealand postal code. Valid format is XXXX, where X is a digit.
  • forms.NZPhoneNumberField - a form field that validates input as a New Zealand phone number. Validates local and international land line and mobile numbers just as well as 0800 number validation.
  • forms.NZBankAccountNumberField - a form field that validates input as a New Zealand bank account number. Validates the format XX-XXXX-XXXXXXX-XX(X). When strict checking is enabled the bank ID part of account number is validatedm too.

See the source code for full details.

NZ specific settings

  • LOCALFLAVOR_NZ_STRICT defaults to False. Add it to your settings if you want to enable strict validation. Currently, if set to True, NZBankAccountNumberField will also validate if given bank account number’s bank id is one of the valid ones. See django_localflavor_nz.forms.BANK_IDS for full list of valid bank IDs.

About django-localflavor-nz

django_localflavor_nz package was created by Marek Kuziel, because New Zealand “localflavor” didn’t make it to Django before django.contrib.localflavor was deprecated in Django 1.5.


Install the package easy_install django-localflavor_nz or pip install django-localflavor_nz.

Add django_localflavor_nz to INSTALLED_APPS in your settings.


django test django_localflavor_nz will run the tests for this localflavor.

About localflavors

Django’s localflavor packages offer additional functionality for particular countries or cultures.

For example, these might include form fields for your country’s postal codes, phone number formats or government ID numbers.

The localflavors code used to live in Django proper – in django.contrib.localflavor – but was separated into standalone packages in Django 1.5 to keep the framework’s core clean.

For other localflavor packages, see

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-localflavor-nz, version 1.1
Filename, size File type Python version Upload date Hashes
Filename, size django-localflavor-nz-1.1.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page