currency

Custom PostgreSQL currency type in 1Byte

Overview

Package	Version	Category	License	Language
`pg_currency`	`0.0.3`	TYPE	MIT	C

ID	Extension	Bin	Lib	Load	Create	Trust	Reloc	Schema
3680	`currency`	No	Yes	No	Yes	No	Yes	-

Related	`plpgsql` `financial` `pg_accumulator` `omni_ledger` `country` `isn` `pg_xenophile` `icu_ext`

Version

Type	Repo	Version	PG Ver	Package	Deps
EXT	PIGSTY	`0.0.3`	1817161514	`pg_currency`	`plpgsql`
RPM	PIGSTY	`0.0.3`	1817161514	`pg_currency_$v`	-
DEB	PIGSTY	`0.0.3`	1817161514	`postgresql-$v-pg-currency`	-

OS / PG	PG18	PG17	PG16	PG15	PG14
el8.x86_64	PIGSTY 0.0.3 el8.x86_64.pg18 : pg_currency_18 pg_currency_18-0.0.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.3 · 16.8KiB	PIGSTY 0.0.3 el8.x86_64.pg17 : pg_currency_17 pg_currency_17-0.0.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.3 · 16.8KiB	PIGSTY 0.0.3 el8.x86_64.pg16 : pg_currency_16 pg_currency_16-0.0.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.3 · 16.8KiB	PIGSTY 0.0.3 el8.x86_64.pg15 : pg_currency_15 pg_currency_15-0.0.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.3 · 16.7KiB	PIGSTY 0.0.3 el8.x86_64.pg14 : pg_currency_14 pg_currency_14-0.0.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.3 · 16.7KiB
el8.aarch64	PIGSTY 0.0.3 el8.aarch64.pg18 : pg_currency_18 pg_currency_18-0.0.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.3 · 17.4KiB	PIGSTY 0.0.3 el8.aarch64.pg17 : pg_currency_17 pg_currency_17-0.0.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.3 · 17.4KiB	PIGSTY 0.0.3 el8.aarch64.pg16 : pg_currency_16 pg_currency_16-0.0.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.3 · 17.4KiB	PIGSTY 0.0.3 el8.aarch64.pg15 : pg_currency_15 pg_currency_15-0.0.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.3 · 17.3KiB	PIGSTY 0.0.3 el8.aarch64.pg14 : pg_currency_14 pg_currency_14-0.0.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.3 · 17.3KiB
el9.x86_64	PIGSTY 0.0.3 el9.x86_64.pg18 : pg_currency_18 pg_currency_18-0.0.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.3 · 17.2KiB	PIGSTY 0.0.3 el9.x86_64.pg17 : pg_currency_17 pg_currency_17-0.0.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.3 · 17.2KiB	PIGSTY 0.0.3 el9.x86_64.pg16 : pg_currency_16 pg_currency_16-0.0.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.3 · 17.2KiB	PIGSTY 0.0.3 el9.x86_64.pg15 : pg_currency_15 pg_currency_15-0.0.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.3 · 17.0KiB	PIGSTY 0.0.3 el9.x86_64.pg14 : pg_currency_14 pg_currency_14-0.0.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.3 · 17.0KiB
el9.aarch64	PIGSTY 0.0.3 el9.aarch64.pg18 : pg_currency_18 pg_currency_18-0.0.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.3 · 17.6KiB	PIGSTY 0.0.3 el9.aarch64.pg17 : pg_currency_17 pg_currency_17-0.0.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.3 · 17.6KiB	PIGSTY 0.0.3 el9.aarch64.pg16 : pg_currency_16 pg_currency_16-0.0.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.3 · 17.6KiB	PIGSTY 0.0.3 el9.aarch64.pg15 : pg_currency_15 pg_currency_15-0.0.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.3 · 17.6KiB	PIGSTY 0.0.3 el9.aarch64.pg14 : pg_currency_14 pg_currency_14-0.0.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.3 · 17.6KiB
el10.x86_64	PIGSTY 0.0.3 el10.x86_64.pg18 : pg_currency_18 pg_currency_18-0.0.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.3 · 17.0KiB	PIGSTY 0.0.3 el10.x86_64.pg17 : pg_currency_17 pg_currency_17-0.0.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.3 · 17.0KiB	PIGSTY 0.0.3 el10.x86_64.pg16 : pg_currency_16 pg_currency_16-0.0.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.3 · 17.0KiB	PIGSTY 0.0.3 el10.x86_64.pg15 : pg_currency_15 pg_currency_15-0.0.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.3 · 16.9KiB	PIGSTY 0.0.3 el10.x86_64.pg14 : pg_currency_14 pg_currency_14-0.0.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.3 · 16.9KiB
el10.aarch64	PIGSTY 0.0.3 el10.aarch64.pg18 : pg_currency_18 pg_currency_18-0.0.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.3 · 17.7KiB	PIGSTY 0.0.3 el10.aarch64.pg17 : pg_currency_17 pg_currency_17-0.0.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.3 · 17.7KiB	PIGSTY 0.0.3 el10.aarch64.pg16 : pg_currency_16 pg_currency_16-0.0.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.3 · 17.7KiB	PIGSTY 0.0.3 el10.aarch64.pg15 : pg_currency_15 pg_currency_15-0.0.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.3 · 17.7KiB	PIGSTY 0.0.3 el10.aarch64.pg14 : pg_currency_14 pg_currency_14-0.0.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.3 · 17.7KiB
d12.x86_64	PIGSTY 0.0.3 d12.x86_64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d12.x86_64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.3 · 19.0KiB	PIGSTY 0.0.3 d12.x86_64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d12.x86_64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d12.x86_64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.3 · 19.0KiB
d12.aarch64	PIGSTY 0.0.3 d12.aarch64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d12.aarch64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d12.aarch64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d12.aarch64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.3 · 19.3KiB	PIGSTY 0.0.3 d12.aarch64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.3 · 19.2KiB
d13.x86_64	PIGSTY 0.0.3 d13.x86_64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.3 · 19.0KiB	PIGSTY 0.0.3 d13.x86_64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.3 · 19.0KiB	PIGSTY 0.0.3 d13.x86_64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.3 · 19.0KiB	PIGSTY 0.0.3 d13.x86_64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.3 · 18.9KiB	PIGSTY 0.0.3 d13.x86_64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.3 · 18.9KiB
d13.aarch64	PIGSTY 0.0.3 d13.aarch64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.3 · 19.2KiB	PIGSTY 0.0.3 d13.aarch64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d13.aarch64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.3 · 19.1KiB	PIGSTY 0.0.3 d13.aarch64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.3 · 19.3KiB	PIGSTY 0.0.3 d13.aarch64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.3 · 19.2KiB
u22.x86_64	PIGSTY 0.0.3 u22.x86_64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.3 · 20.3KiB	PIGSTY 0.0.3 u22.x86_64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.3 · 22.5KiB	PIGSTY 0.0.3 u22.x86_64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.3 · 22.4KiB	PIGSTY 0.0.3 u22.x86_64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.3 · 22.4KiB	PIGSTY 0.0.3 u22.x86_64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.3 · 22.3KiB
u22.aarch64	PIGSTY 0.0.3 u22.aarch64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.3 · 20.3KiB	PIGSTY 0.0.3 u22.aarch64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.3 · 22.4KiB	PIGSTY 0.0.3 u22.aarch64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.3 · 22.4KiB	PIGSTY 0.0.3 u22.aarch64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.3 · 22.4KiB	PIGSTY 0.0.3 u22.aarch64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.3 · 22.3KiB
u24.x86_64	PIGSTY 0.0.3 u24.x86_64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.3 · 20.3KiB	PIGSTY 0.0.3 u24.x86_64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.3 · 20.3KiB	PIGSTY 0.0.3 u24.x86_64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.3 · 20.3KiB	PIGSTY 0.0.3 u24.x86_64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.3 · 20.3KiB	PIGSTY 0.0.3 u24.x86_64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.3 · 20.3KiB
u24.aarch64	PIGSTY 0.0.3 u24.aarch64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.3 · 20.7KiB	PIGSTY 0.0.3 u24.aarch64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.3 · 20.7KiB	PIGSTY 0.0.3 u24.aarch64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.3 · 20.7KiB	PIGSTY 0.0.3 u24.aarch64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.3 · 20.8KiB	PIGSTY 0.0.3 u24.aarch64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.3 · 20.8KiB
u26.x86_64	PIGSTY 0.0.3 u26.x86_64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.3 · 20.1KiB	PIGSTY 0.0.3 u26.x86_64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.3 · 20.1KiB	PIGSTY 0.0.3 u26.x86_64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.3 · 20.1KiB	PIGSTY 0.0.3 u26.x86_64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.3 · 20.1KiB	PIGSTY 0.0.3 u26.x86_64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.3 · 20.1KiB
u26.aarch64	PIGSTY 0.0.3 u26.aarch64.pg18 : postgresql-18-pg-currency postgresql-18-pg-currency_0.0.3-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.3 · 20.9KiB	PIGSTY 0.0.3 u26.aarch64.pg17 : postgresql-17-pg-currency postgresql-17-pg-currency_0.0.3-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.3 · 20.8KiB	PIGSTY 0.0.3 u26.aarch64.pg16 : postgresql-16-pg-currency postgresql-16-pg-currency_0.0.3-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.3 · 20.8KiB	PIGSTY 0.0.3 u26.aarch64.pg15 : postgresql-15-pg-currency postgresql-15-pg-currency_0.0.3-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.3 · 20.8KiB	PIGSTY 0.0.3 u26.aarch64.pg14 : postgresql-14-pg-currency postgresql-14-pg-currency_0.0.3-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.3 · 20.8KiB

Build

You can build the RPM / DEB packages for pg_currency using pig build:

pig build pkg pg_currency         # build RPM / DEB packages

Install

You can install pg_currency directly. First, make sure the PGDG and PIGSTY repositories are added and enabled:

pig repo add pgsql -u          # Add repo and update cache

Install the extension using pig or apt/yum/dnf:

Install

pig install pg_currency;          # Install for current active PG version

pig

pig ext install -y pg_currency -v 18  # PG 18
pig ext install -y pg_currency -v 17  # PG 17
pig ext install -y pg_currency -v 16  # PG 16
pig ext install -y pg_currency -v 15  # PG 15
pig ext install -y pg_currency -v 14  # PG 14

dnf

dnf install -y pg_currency_18       # PG 18
dnf install -y pg_currency_17       # PG 17
dnf install -y pg_currency_16       # PG 16
dnf install -y pg_currency_15       # PG 15
dnf install -y pg_currency_14       # PG 14

apt

apt install -y postgresql-18-pg-currency   # PG 18
apt install -y postgresql-17-pg-currency   # PG 17
apt install -y postgresql-16-pg-currency   # PG 16
apt install -y postgresql-15-pg-currency   # PG 15
apt install -y postgresql-14-pg-currency   # PG 14

Create Extension:

CREATE EXTENSION currency CASCADE;  -- requires: plpgsql

Usage

currency: ISO 4217 currency code type

The currency extension provides a data type for ISO 4217 currency codes using only a single byte of storage per value.

CREATE EXTENSION currency;

CREATE TABLE transactions (
    id                serial,
    payment_currency  currency
);

INSERT INTO transactions VALUES (1, 'USD'), (2, 'EUR'), (3, 'USD');

SELECT * FROM transactions ORDER BY payment_currency;
 id | payment_currency
----+------------------
  2 | EUR
  1 | USD
  3 | USD

Operators

Standard comparison operators are supported: =, <>, <, >, <=, >=.

B-tree index support is included for efficient ordering and lookups.

Functions

-- List all supported currency codes
SELECT * FROM supported_currencies() currency ORDER BY currency;

currency

Overview

Version

Build

Install

Usage

Operators

Functions

Was this page helpful?