↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

文档 / 函数百科 / 数据类型格式化函数

FUNCTION数据类型格式化函数

to_char

根据给定的格式将时间戳转换为字符串。

Converts time stamp to string according to the given format.

数据类型格式化函数 引入 9.0（基线） 现存至 20 devel 4 条签名 0 次签名变更

分组
数据类型格式化函数
签名数
4 条
引入版本
9.0（基线）
状态
现存
签名变更
未变过
本版来源
本站译文

PostgreSQL 18 手册 · 9.8 数据类型格式化函数 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

签名

PostgreSQL 18 里 to_char 的 4 条签名，按上游手册顺序排列。参数名用斜体，类型用弱化色， 之后是返回类型。说明取自本站手册译文：标「沿用」的借用了另一版的译文，标「EN」的本站暂无译文、按英文原文显示。

  1. to_char ( timestamp, text ) → text

    根据给定的格式将时间戳转换为字符串。
    • to_char(timestamp '2002-04-20 17:31:12.66', 'HH12:MI:SS')05:31:12

  2. to_char ( timestamp with time zone, text ) → text

    根据给定的格式将时间戳转换为字符串。
    • to_char(timestamp '2002-04-20 17:31:12.66', 'HH12:MI:SS')05:31:12

  3. to_char ( interval, text ) → text

    根据给定的格式将间隔转换为字符串。
    • to_char(interval '15h 2m 12s', 'HH24:MI:SS')15:02:12

  4. to_char ( numeric_type, text ) → text

    根据给定的格式将数字转换为字符串；适用于 integer， bigint， numeric，real， double precision。
    • to_char(125, '999')125
    • to_char(125.8::real, '999D9')125.8
    • to_char(-125.8, '999D99S')125.80-

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的签名。

  1. PostgreSQL 13 ← 12 手册重排

    这一跳手册重排了函数表的写法，签名文本整体改写，只记函数的增删，不逐条比较签名。

签名矩阵

每条签名在给出了签名的 18 个版本里的存在情况；方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来，上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同，跨越那一跳的同一条签名会显示成两行。

存在 不存在

签名 9.09.19.29.39.49.59.61011121314151617181920
to_char ( timestamp, text ) → text 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在
to_char ( interval, text ) → text 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在
to_char ( int, text ) → text 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在
to_char ( double precision, text ) → text 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在
to_char ( numeric, text ) → text 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在
to_char ( timestamp with time zone, text ) → text 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 存在 存在 存在 存在 存在 存在 存在 存在
to_char ( numeric_type, text ) → text 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 存在 存在 存在 存在 存在 存在 存在 存在

同组函数

函数 签名 主签名 版本变动 最近变更
DATA TYPE FORMATTING FUNCTIONS 数据类型格式化函数 4 个 ↗
to_char基线 4 to_char ( timestamp, text ) → text —
根据给定的格式将时间戳转换为字符串。 现存
to_date基线 1 to_date ( text, text ) → date —
根据给定的格式将字符串转换为日期。 现存
to_number基线 1 to_number ( text, text ) → numeric —
根据给定的格式将字符串转换为数字。 现存
to_timestamp基线 2 to_timestamp ( text, text ) → timestamp with time zone —
根据给定的格式将字符串转换为时间戳。 现存