Wiki / Operator Families / B-tree classes
btree/timestamp_ops (class)
B-tree operator class for timestamp; member of datetime_ops.
Reading PostgreSQL 18.6.
Description
B-tree operator class for timestamp; member of datetime_ops.
- Object kind
- Operator class
- Index AM
- B-tree
- Input type
- timestamp
- Stored key type
- Same as input type (catalog zero)
- Default class
- yes
Usage
btree/timestamp_opsOperator classes and families
An index definition can specify an operator class for each column of an index.
The operator class identifies the operators to be used by the index for that column. For example, a B-tree index on the type int4 would use the int4_ops class; this operator class includes comparison functions for values of type int4 . In practice the default operator class for the column's data type is usually sufficient. The main reason for having operator classes is that for some data types, there could be more than one meaningful index behavior. For example, we might want to sort a complex-number data type either by absolute value or by real part. We could do this by defining two operator classes for the data type and then selecting the proper class when making an index. The operator class determines the basic sort ordering (which can then be modified by adding sort options COLLATE , ASC / DESC and/or NULLS FIRST / NULLS LAST ).
There are also some built-in operator classes besides the default ones:
Family operator strategies
| Operator overload | Strategy | Purpose | Ordering family | Membership scope | Source description |
|---|---|---|---|---|---|
| <(date,date) | 1 | search | Family member | less than | |
| <=(date,date) | 2 | search | Family member | less than or equal | |
| =(date,date) | 3 | search | Family member | equal | |
| >=(date,date) | 4 | search | Family member | greater than or equal | |
| >(date,date) | 5 | search | Family member | greater than | |
| <(date,timestamp) | 1 | search | Family member | less than | |
| <=(date,timestamp) | 2 | search | Family member | less than or equal | |
| =(date,timestamp) | 3 | search | Family member | equal | |
| >=(date,timestamp) | 4 | search | Family member | greater than or equal | |
| >(date,timestamp) | 5 | search | Family member | greater than | |
| <(date,timestamptz) | 1 | search | Family member | less than | |
| <=(date,timestamptz) | 2 | search | Family member | less than or equal | |
| =(date,timestamptz) | 3 | search | Family member | equal | |
| >=(date,timestamptz) | 4 | search | Family member | greater than or equal | |
| >(date,timestamptz) | 5 | search | Family member | greater than | |
| <(timestamp,timestamp) | 1 | search | Class input pair | less than | |
| <=(timestamp,timestamp) | 2 | search | Class input pair | less than or equal | |
| =(timestamp,timestamp) | 3 | search | Class input pair | equal | |
| >=(timestamp,timestamp) | 4 | search | Class input pair | greater than or equal | |
| >(timestamp,timestamp) | 5 | search | Class input pair | greater than | |
| <(timestamp,date) | 1 | search | Family member | less than | |
| <=(timestamp,date) | 2 | search | Family member | less than or equal | |
| =(timestamp,date) | 3 | search | Family member | equal | |
| >=(timestamp,date) | 4 | search | Family member | greater than or equal | |
| >(timestamp,date) | 5 | search | Family member | greater than | |
| <(timestamp,timestamptz) | 1 | search | Family member | less than | |
| <=(timestamp,timestamptz) | 2 | search | Family member | less than or equal | |
| =(timestamp,timestamptz) | 3 | search | Family member | equal | |
| >=(timestamp,timestamptz) | 4 | search | Family member | greater than or equal | |
| >(timestamp,timestamptz) | 5 | search | Family member | greater than | |
| <(timestamptz,timestamptz) | 1 | search | Family member | less than | |
| <=(timestamptz,timestamptz) | 2 | search | Family member | less than or equal | |
| =(timestamptz,timestamptz) | 3 | search | Family member | equal | |
| >=(timestamptz,timestamptz) | 4 | search | Family member | greater than or equal | |
| >(timestamptz,timestamptz) | 5 | search | Family member | greater than | |
| <(timestamptz,date) | 1 | search | Family member | less than | |
| <=(timestamptz,date) | 2 | search | Family member | less than or equal | |
| =(timestamptz,date) | 3 | search | Family member | equal | |
| >=(timestamptz,date) | 4 | search | Family member | greater than or equal | |
| >(timestamptz,date) | 5 | search | Family member | greater than | |
| <(timestamptz,timestamp) | 1 | search | Family member | less than | |
| <=(timestamptz,timestamp) | 2 | search | Family member | less than or equal | |
| =(timestamptz,timestamp) | 3 | search | Family member | equal | |
| >=(timestamptz,timestamp) | 4 | search | Family member | greater than or equal | |
| >(timestamptz,timestamp) | 5 | search | Family member | greater than |
Family support functions
| Support number | Left type | Right type | Function signature | Result type |
|---|---|---|---|---|
| 1 | date | date | date_cmp(date,date) | int4 |
| 2 | date | date | date_sortsupport(internal) | void |
| 4 | date | date | btequalimage(oid) | bool |
| 6 | date | date | date_skipsupport(internal) | void |
| 1 | date | timestamp | date_cmp_timestamp(date,timestamp) | int4 |
| 1 | date | timestamptz | date_cmp_timestamptz(date,timestamptz) | int4 |
| 1 | timestamp | timestamp | timestamp_cmp(timestamp,timestamp) | int4 |
| 2 | timestamp | timestamp | timestamp_sortsupport(internal) | void |
| 4 | timestamp | timestamp | btequalimage(oid) | bool |
| 6 | timestamp | timestamp | timestamp_skipsupport(internal) | void |
| 1 | timestamp | date | timestamp_cmp_date(timestamp,date) | int4 |
| 1 | timestamp | timestamptz | timestamp_cmp_timestamptz(timestamp,timestamptz) | int4 |
| 1 | timestamptz | timestamptz | timestamptz_cmp(timestamptz,timestamptz) | int4 |
| 2 | timestamptz | timestamptz | timestamp_sortsupport(internal) | void |
| 4 | timestamptz | timestamptz | btequalimage(oid) | bool |
| 6 | timestamptz | timestamptz | timestamp_skipsupport(internal) | void |
| 1 | timestamptz | date | timestamptz_cmp_date(timestamptz,date) | int4 |
| 1 | timestamptz | timestamp | timestamptz_cmp_timestamp(timestamptz,timestamp) | int4 |
| 3 | date | interval | in_range(date,date,interval,bool,bool) | bool |
| 3 | timestamp | interval | in_range(timestamp,timestamp,interval,bool,bool) | bool |
| 3 | timestamptz | interval | in_range(timestamptz,timestamptz,interval,bool,bool) | bool |
Classes in this family
| Class | Input type | Key type | Default |
|---|---|---|---|
| date_ops | date | Same as input type | yes |
| timestamptz_ops | timestamptz | Same as input type | yes |
| timestamp_ops | timestamp | Same as input type | yes |
Related entries
Documentation and source
- Matching PostgreSQL source archive
- PostgreSQL 18 English manual: indexes-opclass.html
- PostgreSQL 18 English manual: catalog-pg-opclass.html
- PostgreSQL 18 English manual: catalog-pg-amop.html
- PostgreSQL 18 English manual: catalog-pg-amproc.html
Source build
- Version
- 18.6
- Build
- https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- Source fingerprint
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
Compare versions
PostgreSQL 17 → 18: changed.
--- PostgreSQL 17
+++ PostgreSQL 18
@@ -648,6 +648,33 @@
"number": "4",
"result_type": "bool",
"right_type": "timestamptz"
+ },
+ {
+ "family": "datetime_ops",
+ "function": "date_skipsupport(internal)",
+ "left_type": "date",
+ "method": "btree",
+ "number": "6",
+ "result_type": "void",
+ "right_type": "date"
+ },
+ {
+ "family": "datetime_ops",
+ "function": "timestamp_skipsupport(internal)",
+ "left_type": "timestamp",
+ "method": "btree",
+ "number": "6",
+ "result_type": "void",
+ "right_type": "timestamp"
+ },
+ {
+ "family": "datetime_ops",
+ "function": "timestamp_skipsupport(internal)",
+ "left_type": "timestamptz",
+ "method": "btree",
+ "number": "6",
+ "result_type": "void",
+ "right_type": "timestamptz"
}
]
}Compares recorded interfaces and attributes. Source fingerprints and build metadata are excluded; an absent sample is not proof of the introduction or removal release.
Related entries
Export JSON · Back to Operator Families · Recorded in PostgreSQL 10 through 20; the first sample is not necessarily its introduction.