log_timezone 是一个 配置参数，用于确定写入 PostgreSQL 日志中的时间戳所使用的时区。
log_timezone 在 PostgreSQL 8.3 中添加。
用法
时区在服务器日志中以相应的时区缩写显示，例如，对于 Europe/Berlin，将显示 CEST。有关时区到缩写映射列表，请参阅 pg_timezone_names。但是，无法直接指定时区缩写。
默认值
log_timezone 的默认值为：GMT。
请注意，log_timezone 的值在由 initdb 生成的 postgresql.conf 文件中显式设置为反映本地服务器时区。
按 PostgreSQL 版本分列详情
log_timezone (PostgreSQL 17)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/17/postgresql.conf |
| 源代码行 | 623 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 16)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/16/postgresql.conf |
| 源代码行 | 603 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 15)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/15/postgresql.conf |
| 源代码行 | 598 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 14)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/14/postgresql.conf |
| 源代码行 | 580 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 13)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/13/postgresql.conf |
| 源代码行 | 563 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 12)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/12/postgresql.conf |
| 源代码行 | 539 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 11)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/11/postgresql.conf |
| 源代码行 | 481 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 10)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/10/postgresql.conf |
| 源代码行 | 472 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 9.6)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/96/postgresql.conf |
| 源代码行 | 449 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 9.5)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/95/postgresql.conf |
| 源代码行 | 432 |
| 待重启 | 否 |
文档: log_timezone
log_timezone (PostgreSQL 9.4)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/94/postgresql.conf |
| 源代码行 | 436 |
文档: log_timezone
log_timezone (PostgreSQL 9.3)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/93/postgresql.conf |
| 源代码行 | 418 |
文档: log_timezone
log_timezone (PostgreSQL 9.2)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/92/postgresql.conf |
| 源代码行 | 418 |
文档: log_timezone
log_timezone (PostgreSQL 9.1)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 环境变量 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: log_timezone
log_timezone (PostgreSQL 9.0)
| 设置 | 未知 |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 命令行 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | 未知 |
| 重置值 | 未知 |
| 源文件 | |
| 源代码行 |
文档: log_timezone
log_timezone (PostgreSQL 8.4)
| 设置 | 未知 |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 命令行 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | 未知 |
| 重置值 | 未知 |
| 源文件 | |
| 源代码行 |
文档: log_timezone
log_timezone (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置在日志消息中使用的时区。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 命令行 |
| 最小值 | |
| 最大值 |
文档: log_timezone
更改历史
- PostgreSQL 8.3
- 添加 (提交 bdd6b622)
示例
log_timezone 通常由 initdb 设置为服务器时区
$ initdb -D /var/lib/pgsql/data ... selecting default time zone ... Europe/Berlin ... $ grep log_timezone /var/lib/pgsql/data/postgresql.conf log_timezone = 'Europe/Berlin'
将 log_timezone 设置为 Europe/Berlin 时的日志输出示例
[2022-08-15 03:05:32 CEST] psql postgres postgres LOG: 00000: statement: SELECT 1;
无法为 log_timezone 指定时区缩写
postgres=# ALTER SYSTEM SET log_timezone = 'CEST'; ERROR: invalid value for parameter "log_timezone": "CEST"
参考
- PostgreSQL 文档： log_timezone