https://github.com/bendrucker/postgres-date
Postgres date column parser
https://github.com/bendrucker/postgres-date
Last synced: over 1 year ago
JSON representation
Postgres date column parser
- Host: GitHub
- URL: https://github.com/bendrucker/postgres-date
- Owner: bendrucker
- License: mit
- Created: 2015-06-13T23:50:41.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2023-03-28T13:57:04.000Z (over 3 years ago)
- Last Synced: 2025-04-10T08:14:05.091Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 40 KB
- Stars: 14
- Watchers: 3
- Forks: 16
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# postgres-date [](https://github.com/bendrucker/postgres-date/actions?query=workflow%3Atests)
> Postgres date output parser
This package parses [date/time outputs](https://www.postgresql.org/docs/current/datatype-datetime.html#DATATYPE-DATETIME-OUTPUT) from Postgres into Javascript `Date` objects. Its goal is to match Postgres behavior and preserve data accuracy.
If you find a case where a valid Postgres output results in incorrect parsing (including loss of precision), please [create a pull request](https://github.com/bendrucker/postgres-date/compare) and provide a failing test.
**Supported Postgres Versions:** `>= 9.6`
All prior versions of Postgres are likely compatible but not officially supported.
## Install
```
npm install --save postgres-date
```
## Usage
```js
const parse = require('postgres-date')
parse('2011-01-23 22:15:51Z')
// => 2011-01-23T22:15:51.000Z
```
## API
#### `parse(isoDate)` -> `date`
##### isoDate
*Required*
Type: `string`
A date string from Postgres.
## Releases
The following semantic versioning increments will be used for changes:
* **Major**: Removal of support for Node.js versions or Postgres versions (not expected)
* **Minor**: Unused, since Postgres returns dates in standard ISO 8601 format
* **Patch**: Any fix for parsing behavior
## License
MIT © [Ben Drucker](http://bendrucker.me)