Configuration basics

July 31, 2026 ยท View on GitHub

import CodeBlock from '@theme/CodeBlock'; import configuration from '!!raw-loader!../_examples/configuration/Program.cs';

Configuration basics

Prefer per-call culture arguments when an overload provides one. Use CultureInfo.CurrentCulture and CurrentUICulture when a Humanizer API follows ambient application culture. Reserve Configurator for application-wide strategies, registries, or enum metadata rules.

Configure global behavior once during application startup, before any request or background worker can use Humanizer.

Configure a strategy

This verified program installs date and duration strategies at startup:

{configuration}

It prints:

an hour ago; 1 hour

For a global date strategy, assign Configurator.DateTimeHumanizeStrategy once at startup. For a custom localized component, call the relevant registry's Register method before the registry is resolved.

Configure before first use

LocaliserRegistry<T> freezes registrations on first use, so registering after resolution throws InvalidOperationException. Likewise, call Configurator.UseEnumDescriptionPropertyLocator before the first enum humanization.