Configuration parameter

lc_time — PostgreSQL configuration parameter

Category Client Connection Defaults

Sets the locale to use for formatting dates and times, for example with the to_char family of functions.

At a glance

Property Value
Parameter lc_time
Category Client Connection Defaults
Default (see documentation)
Value type string
Change scope Per-session (SET)
Available in PostgreSQL 12, 13, 14, 15, 16, 17, 18, 19 (added in 12)

What it does

Sets the locale to use for formatting dates and times, for example with the to_char family of functions. Acceptable values are system-dependent; see locale for more information. If this variable is set to the empty string (which is the default) then the value is inherited from the execution environment of the server in a system-dependent way.

(Description quoted from the official PostgreSQL documentation.)

How to apply a change

Can be set per session with SET, per role/database with ALTER ROLE/DATABASE ... SET, or globally in postgresql.conf.

Inspect the current value and source with SHOW lc_time; or SELECT name, setting, unit, context, source FROM pg_settings WHERE name = 'lc_time';.

Tuning guidance

This sets a session default (locale, formatting, search path or transaction behaviour) rather than a performance knob. Set it per role or database with ALTER ROLE/DATABASE ... SET so the right default follows the right workload, and prefer setting it explicitly in the application for behaviour the query results depend on.

Reference

PostgreSQL documentation — lc_time.

Keep going

Related & next steps

Was this helpful?

← All configuration parameters