更新时间:2026-11-05 GMT+08:00
分享

区域和格式化

不同业务场景对日期时间的显示格式、时区、字符编码以及货币、数值等区域格式的要求不同,统一的格式设置有助于保证数据展示的准确性和可读性。本节介绍与格式显示相关的GUC参数,包括日期时间格式(DateStyle)、区间格式(IntervalStyle)、时区(TimeZone)、字符编码(client_encoding)以及货币、数值和时间区域格式(lc_*)等。

参数说明

表1 区域和格式化参数说明

参数

参数类型

说明

DateStyle

String

参数解释:设置日期和时间值的显示格式,以及有歧义的输入值的解析规则。这个变量包含两个独立的部分:输出格式声明(ISO、Postgres、SQL、German)和输入输出的年/月/日顺序(DMY、MDY、YMD)。这两个可以独立设置或者一起设置。关键字Euro和European等价于DMY;关键字US、NonEuro、NonEuropean等价于MDY。

优先推荐使用ISO格式。Postgres、SQL和German均采用字母缩写的形式来表示时区,例如"EST、WST、CST"等。

说明:

gs_initdb会将这个参数初始化成与lc_time一致的值。

取值范围:字符串。

默认值:ISO, MDY。

IntervalStyle

Enum

参数解释:设置区间值的显示格式。

取值范围:枚举型。

  • sql_standard表示产生与SQL标准规定匹配的输出。
  • postgres表示产生与PostgreSQL 8.4版本相匹配的输出,当DateStyle参数被设为ISO时。
  • postgres_verbose表示产生与PostgreSQL 8.4版本相匹配的输出,当DateStyle参数被设为non_ISO时。
  • iso_8601表示产生与在ISO 8601中定义的"格式与代号"相匹配的输出。
  • oracle表示产生于Oracle中与numtodsinterval函数相匹配的输出结果,详细请参考numtodsinterval。
    说明:

    IntervalStyle参数也会影响不明确的间隔输入的说明。

默认值:postgres。

TimeZone

String

参数解释:设置显示和解释时间类型数值时使用的时区。

取值范围:字符串。

默认值:GMT

timezone_abbreviations

String

参数解释:

设置服务器接受的时区缩写值。

取值范围:字符串。

默认值:Default。

说明:

Default表示通用时区的缩写。但也有其他诸如 'Australia' 和 'India' 等用来定义特定的安装。

extra_float_digits

Integer

参数解释:调整浮点值显示的数据位数,浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上(FLT_DIG或DBL_DIG中合适的)。

取值范围:-15~3。

说明:
  • 设置为3,表示包括部分有效的数据位。对转储需要精确恢复的浮点数据尤其有用。
  • 设置为负数,表示摒弃不需要的数据位。

默认值:0

client_encoding

String

参数解释:设置客户端的字符编码类型。请根据前端业务的情况确定。尽量客户端编码和服务器端编码一致,提高效率。

取值范围:兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。

说明:
  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式,并可以选择进行设置。
  • 默认情况下,gs_initdb会根据当前的系统环境初始化此参数,通过locale命令可以查看当前的配置环境。
  • 参数建议保持默认值,不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置client_encoding参数,即使设置也不会生效,以保证内部通信编码格式一致。

默认值:UTF8

lc_monetary

String

参数解释:设置货币值的显示格式,影响to_char之类的函数的输出。可接受的值是系统相关的。

取值范围:字符串。

说明:
  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式,并可以选择进行设置。
  • 默认情况下,gs_initdb会根据当前的系统环境初始化此参数,通过locale命令可以查看当前的配置环境。

默认值:en_US.UTF-8。

lc_numeric

String

参数解释:

设置数值的显示格式,影响to_char之类的函数的输出。可接受的值是系统相关的。

取值范围:字符串。

说明:
  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式,并可以选择进行设置。
  • 默认情况下,gs_initdb会根据当前的系统环境初始化此参数,通过locale命令可以查看当前的配置环境。

默认值:en_US.UTF-8。

lc_time

String

参数解释:设置时间和区域的显示格式,影响to_char之类的函数的输出。可接受的值是系统相关的。

取值范围:字符串。

说明:
  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式,并可以选择进行设置。
  • 默认情况下,gs_initdb会根据当前的系统环境初始化此参数,通过locale命令可以查看当前的配置环境。

默认值:en_US.UTF-8。

相关文档