Skip to content

date_sub

Enterprise scalar function reference.

Function Snapshot

Field Value
Function date_sub
Category Date and Time
Scope Scalar expression
Discovery SELECT * FROM pg_catalog.pg_proc WHERE proname = 'date_sub';

Purpose

Adds or subtracts interval values from date or timestamp expressions.

Syntax

SELECT date_sub(current_timestamp, interval '3 hours');

Parameters

  • Positional arguments as defined by overload signatures in pg_catalog.pg_proc.

Returns

  • Returns function-specific scalar/array/object according to resolved overload.

Null and Error Behavior

  • Most overloads are deterministic and null-propagating unless documented otherwise.
  • Validate concrete overload behavior with pg_catalog.pg_proc in your running build.

Operational Notes

  • Use schema-qualified objects and parameterized queries for production pipelines.
  • Validate overload details in-cluster with pg_catalog.pg_proc and pg_get_function_result(oid).

Cross-References