| id | configuration |
|---|---|
| title | Configuration basics |
| sidebar_position | 5 |
| diataxis | how-to |
| persona | application developer |
import CodeBlock from '@theme/CodeBlock'; import configuration from '!!raw-loader!../_examples/configuration/Program.cs';
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.
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.
LocaliserRegistry<T> freezes registrations on first use, so registering after
resolution throws InvalidOperationException. Likewise, call
Configurator.UseEnumDescriptionPropertyLocator before the first enum
humanization.