搜索快捷键 cmd + k | ctrl + k
- 安装
- 文档
- 入门
- 连接
- 数据导入
- 客户端 API
- 概览
- ADBC
- C
- C++
- CLI
- Dart
- Go
- Java (JDBC)
- Julia
- Node.js (已弃用)
- Node.js (Neo)
- ODBC
- PHP
- Python
- R
- Rust
- Swift
- Wasm
- SQL
- 介绍
- 语句
- 概览
- ANALYZE
- ALTER TABLE
- ALTER VIEW
- ATTACH 和 DETACH
- CALL
- CHECKPOINT
- COMMENT ON
- COPY
- CREATE INDEX
- CREATE MACRO
- CREATE SCHEMA
- CREATE SECRET
- CREATE SEQUENCE
- CREATE TABLE
- CREATE VIEW
- CREATE TYPE
- DELETE
- DESCRIBE
- DROP
- EXPORT 和 IMPORT DATABASE
- INSERT
- LOAD / INSTALL
- PIVOT
- 性能分析
- SELECT
- SET / RESET
- SET VARIABLE
- SUMMARIZE
- 事务管理
- UNPIVOT
- UPDATE
- USE
- VACUUM
- 查询语法
- SELECT
- FROM 和 JOIN
- WHERE
- GROUP BY
- GROUPING SETS
- HAVING
- ORDER BY
- LIMIT 和 OFFSET
- SAMPLE
- 展开嵌套
- WITH
- WINDOW
- QUALIFY
- VALUES
- FILTER
- 集合操作
- 预处理语句
- 数据类型
- 表达式
- 函数
- 概览
- 聚合函数
- 数组函数
- 位字符串函数
- Blob 函数
- 日期格式化函数
- 日期函数
- 日期部分函数
- 枚举函数
- 间隔函数
- Lambda 函数
- 列表函数
- 映射函数
- 嵌套函数
- 数值函数
- 模式匹配
- 正则表达式
- 结构体函数
- 文本函数
- 时间函数
- 时间戳函数
- 带时区时间戳函数
- 联合函数
- 实用函数
- 窗口函数
- 约束
- 索引
- 元查询
- DuckDB 的 SQL 方言
- 示例
- 配置
- 扩展
- 核心扩展
- 概览
- 自动补全
- Avro
- AWS
- Azure
- Delta
- DuckLake
- 编码
- Excel
- 全文搜索
- httpfs (HTTP 和 S3)
- Iceberg
- ICU
- inet
- jemalloc
- MySQL
- PostgreSQL
- 空间
- SQLite
- TPC-DS
- TPC-H
- UI
- VSS
- 指南
- 概览
- 数据查看器
- 数据库集成
- 文件格式
- 概览
- CSV 导入
- CSV 导出
- 直接读取文件
- Excel 导入
- Excel 导出
- JSON 导入
- JSON 导出
- Parquet 导入
- Parquet 导出
- 查询 Parquet 文件
- 使用 file: 协议访问文件
- 网络和云存储
- 概览
- HTTP Parquet 导入
- S3 Parquet 导入
- S3 Parquet 导出
- S3 Iceberg 导入
- S3 Express One
- GCS 导入
- Cloudflare R2 导入
- 通过 HTTPS / S3 使用 DuckDB
- Fastly 对象存储导入
- 元查询
- ODBC
- 性能
- Python
- 安装
- 执行 SQL
- Jupyter Notebooks
- marimo Notebooks
- Pandas 上的 SQL
- 从 Pandas 导入
- 导出到 Pandas
- 从 Numpy 导入
- 导出到 Numpy
- Arrow 上的 SQL
- 从 Arrow 导入
- 导出到 Arrow
- Pandas 上的关系型 API
- 多个 Python 线程
- 与 Ibis 集成
- 与 Polars 集成
- 使用 fsspec 文件系统
- SQL 编辑器
- SQL 功能
- 代码片段
- 故障排除
- 术语表
- 离线浏览
- 操作手册
- 开发
- 内部结构
- 为什么选择 DuckDB
- 行为准则
- 发布日历
- 路线图
- 站点地图
- 在线演示
文档 / SQL / 函数
日期格式化函数
The strftime
和 strptime
函数可用于在 DATE
/ TIMESTAMP
值和字符串之间进行转换。这在解析 CSV 文件、向用户显示输出或在程序之间传输信息时经常需要。由于日期表示形式多种多样,这些函数接受一个描述日期或时间戳应如何构建的格式字符串。
strftime
示例
strftime(timestamp, format)
函数根据指定的模式将时间戳或日期转换为字符串。
SELECT strftime(DATE '1992-03-02', '%d/%m/%Y');
02/03/1992
SELECT strftime(TIMESTAMP '1992-03-02 20:32:45', '%A, %-d %B %Y - %I:%M:%S %p');
Monday, 2 March 1992 - 08:32:45 PM
strptime
示例
strptime(text, format)
函数 根据指定的模式将字符串转换为时间戳。
SELECT strptime('02/03/1992', '%d/%m/%Y');
1992-03-02 00:00:00
SELECT strptime('Monday, 2 March 1992 - 08:32:45 PM', '%A, %-d %B %Y - %I:%M:%S %p');
1992-03-02 20:32:45
The strptime
函数在失败时会抛出错误。
SELECT strptime('02/50/1992', '%d/%m/%Y') AS x;
Invalid Input Error: Could not parse string "02/50/1992" according to format specifier "%d/%m/%Y"
02/50/1992
^
Error: Month out of range, expected a value between 1 and 12
若要在失败时返回 NULL
,请使用 try_strptime
函数
NULL
CSV 解析
日期格式也可以在 CSV 解析期间指定,无论是通过 COPY
语句 还是 read_csv
函数。这可以通过指定 DATEFORMAT
或 TIMESTAMPFORMAT
(或两者)来完成。DATEFORMAT
将用于日期转换,而 TIMESTAMPFORMAT
将用于时间戳转换。以下是一些使用示例。
在 COPY
语句中
COPY dates FROM 'test.csv' (DATEFORMAT '%d/%m/%Y', TIMESTAMPFORMAT '%A, %-d %B %Y - %I:%M:%S %p');
在 read_csv
函数中
SELECT *
FROM read_csv('test.csv', dateformat = '%m/%d/%Y', timestampformat = '%A, %-d %B %Y - %I:%M:%S %p');
格式说明符
以下是所有可用格式说明符的完整列表。
说明符 | 描述 | 示例 |
---|---|---|
%a |
缩写的星期几名称。 | Sun, Mon, … |
%A |
完整的星期几名称。 | Sunday, Monday, … |
%b |
缩写的月份名称。 | Jan, Feb, …, Dec |
%B |
完整的月份名称。 | January, February, … |
%c |
ISO 日期和时间表示形式 | 1992-03-02 10:30:20 |
%d |
月份中的日期(零填充十进制)。 | 01, 02, …, 31 |
%-d |
月份中的日期(十进制数)。 | 1, 2, …, 30 |
%f |
微秒(十进制数,左侧零填充)。 | 000000 - 999999 |
%g |
毫秒(十进制数,左侧零填充)。 | 000 - 999 |
%G |
ISO 8601 年份(带世纪),表示包含 ISO 周(参见 %V )大部分的年份。 |
0001, 0002, …, 2013, 2014, …, 9998, 9999 |
%H |
小时(24 小时制,零填充十进制数)。 | 00, 01, …, 23 |
%-H |
小时(24 小时制,十进制数)。 | 0, 1, …, 23 |
%I |
小时(12 小时制,零填充十进制数)。 | 01, 02, …, 12 |
%-I |
小时(12 小时制,十进制数)。 | 1, 2, … 12 |
%j |
一年中的日期(零填充十进制数)。 | 001, 002, …, 366 |
%-j |
一年中的日期(十进制数)。 | 1, 2, …, 366 |
%m |
月份(零填充十进制数)。 | 01, 02, …, 12 |
%-m |
月份(十进制数)。 | 1, 2, …, 12 |
%M |
分钟(零填充十进制数)。 | 00, 01, …, 59 |
%-M |
分钟(十进制数)。 | 0, 1, …, 59 |
%n |
纳秒(十进制数,左侧零填充)。 | 000000000 - 999999999 |
%p |
区域设置的 AM 或 PM。 | AM, PM |
%S |
秒(零填充十进制数)。 | 00, 01, …, 59 |
%-S |
秒(十进制数)。 | 0, 1, …, 59 |
%u |
ISO 8601 星期几(十进制数,1 表示星期一)。 | 1, 2, …, 7 |
%U |
年份的周数。第 01 周从当年的第一个星期日开始,因此可能存在第 00 周。请注意,这不符合 ISO-8601 中的周日期标准。 | 00, 01, …, 53 |
%V |
ISO 8601 周(十进制数,星期一为一周的第一天)。第 01 周是包含 1 月 4 日的周。请注意,%V 与年份指令 %Y 不兼容。请改用 ISO 年份 %G 。 |
01, …, 53 |
%w |
星期几(十进制数)。 | 0, 1, …, 6 |
%W |
年份的周数。第 01 周从当年的第一个星期一开始,因此可能存在第 00 周。请注意,这不符合 ISO-8601 中的周日期标准。 | 00, 01, …, 53 |
%x |
ISO 日期表示形式 | 1992-03-02 |
%X |
ISO 时间表示形式 | 10:30:20 |
%y |
不带世纪的年份(零填充十进制数)。 | 00, 01, …, 99 |
%-y |
不带世纪的年份(十进制数)。 | 0, 1, …, 99 |
%Y |
带世纪的年份(十进制数)。 | 2013, 2019 等。 |
%z |
与 UTC 的时间偏移量,形式为 ±HH:MM、±HHMM 或 ±HH。 | -0700 |
%Z |
时区名称。 | 欧洲/阿姆斯特丹 |
%% |
字面量 % 字符。 |
% |