- Installation
- Guides
- Data Import & Export
- CSV Import
- CSV Export
- Parquet Import
- Parquet Export
- Query Parquet
- HTTP Parquet Import
- S3 Parquet Import
- Meta Queries
- Python
- Install
- Execute SQL
- Jupyter Notebooks
- SQL on Pandas
- Import From Pandas
- Export To Pandas
- SQL on Arrow
- Import From Arrow
- Export To Arrow
- Relational API on Pandas
- DuckDB with Ibis
- SQL Editors
- Documentation
- Connect
- Data Import
- Client APIs
- Overview
- Python
- R
- Java
- Julia
- C
- Overview
- Startup
- Configure
- Query
- Data Chunks
- Values
- Types
- Prepared Statements
- Appender
- Table Functions
- Replacement Scans
- API Reference
- C++
- Node.js
- Wasm
- ODBC
- CLI
- SQL
- Introduction
- Statements
- Overview
- Select
- Insert
- Delete
- Update
- Create Schema
- Create Table
- Create View
- Create Sequence
- Create Macro
- Drop
- Alter Table
- Copy
- Export
- Query Syntax
- SELECT
- FROM
- WHERE
- GROUP BY
- GROUPING SETS
- HAVING
- ORDER BY
- LIMIT
- SAMPLE
- UNNEST
- WITH
- WINDOW
- QUALIFY
- VALUES
- FILTER
- Data Types
- Expressions
- Functions
- Overview
- Numeric Functions
- Text Functions
- Pattern Matching
- Date Functions
- Timestamp Functions
- Time Functions
- Interval Functions
- Date Formats
- Date Parts
- Blob Functions
- Nested Functions
- Utility Functions
- Indexes
- Aggregates
- Window Functions
- Samples
- Information Schema
- Configuration
- Pragmas
- Extensions
- Development
- Testing
- Internals Overview
- Storage Versions & Format
- Execution Format
- Profiling
- Release Dates
- Building
- Sitemap
- Why DuckDB
- FAQ
- Code of Conduct
- Live Demo
This section describes functions and operators for examining and manipulating TIME
values.
Time Operators
The table below shows the available mathematical operators for TIME
types.
Operator | Description | Example | Result |
---|---|---|---|
+ |
addition of an INTERVAL |
TIME '01:02:03' + INTERVAL 5 HOUR |
06:02:03 |
- |
subtraction of an INTERVAL |
TIME '06:02:03' - INTERVAL 5 HOUR' |
01:02:03 |
Time Functions
The table below shows the available scalar functions for TIME
types.
Function | Description | Example | Result |
---|---|---|---|
current_time |
Current time (start of current transaction) | ||
date_diff( part , starttime , endtime ) |
The number of partition boundaries between the times | date_diff('hour', TIME '01:02:03', TIME '06:01:03') |
5 |
date_part( part , time ) |
Get subfield (equivalent to extract) | date_part('minute', TIME '14:21:13') |
21 |
date_sub( part , starttime , endtime ) |
The number of complete partitions between the times | date_sub('hour', TIME '01:02:03', TIME '06:01:03') |
4 |
extract( part from time ) |
Get subfield from a time | extract('hour' FROM TIME '14:21:13') |
14 |
make_time( bigint , bigint , double ) |
The time for the given parts | make_time(13, 34, 27.123456) |
13:34:27.123456 |
The only date parts that are defined for times are epoch
, hours
, minutes
, seconds
, milliseconds
and microseconds
.
Search Shortcut cmd + k | ctrl + k