FUNCTIONUUID 函数

uuid_extract_timestamp

从版本 1、6 或 7 的 UUID 中提取 timestamp with time zone。

Extracts a timestamp with time zone from a UUID of version 1, 6, or 7.

UUID 函数引入 17 现存至 20 devel 1 条签名 1 次签名变更

版本轨迹

相对 PostgreSQL 17：新增 1 条签名，移除 1 条。

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

新 uuid_extract_timestamp ( uuid ) → timestamp with time zone

从版本 1 或 7 的 UUID 中提取 timestamp with time zone。对于其他版本，该函数返回 null。注意，提取出的时间戳不一定与 UUID 生成时刻完全一致；这取决于生成该 UUID 的实现。
- uuid_extract_timestamp('019535d9-3df7-79fb-b466-fa907fa17f9e'::uuid)2025-02-23 21:46:24.503-05

PostgreSQL 17 有、18 不再有的 1 条签名，取自上一版快照。

uuid_extract_timestamp (uuid) → timestamp with time zone 这个函数从版本 1 的UUID中提取timestamp with time zone。对于其他版本，此函数返回NULL。注意，提取的时间戳不一定与UUID生成的时间完全相同；这取决于生成UUID的实现。

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

PostgreSQL 20 ← 19 说明更新

说明更新
PostgreSQL 18 ← 17 签名变更

uuid_extract_timestamp ( uuid ) → timestamp with time zone uuid_extract_timestamp (uuid) → timestamp with time zone 说明更新
PostgreSQL 17 ← 16 新增此函数

PostgreSQL 17 起可用

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

存在不存在

签名	17	18	19	20
`uuid_extract_timestamp (uuid) → timestamp with time zone`	存在	不存在	不存在	不存在
`uuid_extract_timestamp ( uuid ) → timestamp with time zone`	不存在	存在	存在	存在

函数	签名	主签名	最近变更
UUID FUNCTIONS UUID 函数 5 个 ↗
`gen_random_uuid`	1	`gen_random_uuid ( ) → uuid`	181 次
生成一个版本 4（随机）的 UUID			现存
`uuid_extract_timestamp`	1	`uuid_extract_timestamp ( uuid ) → timestamp with time zone`	181 次
从版本 1、6 或 7 的 UUID 中提取 timestamp with time zone。			现存
`uuid_extract_version`	1	`uuid_extract_version ( uuid ) → smallint`	181 次
从符合 RFC 9562 所描述某一变体的 UUID 中提取版本号。			现存
`uuidv4`	1	`uuidv4 ( ) → uuid`	—
生成一个版本 4（随机）的 UUID			现存
`uuidv7`	1	`uuidv7 ( [ shift interval ] ) → uuid`	—
生成一个版本 7（按时间排序）的 UUID。			现存