Installation

To install discstamp, use npm:

npm install discstamp

Usage

Using discstamp is incredibly straightforward. This section provides you with detailed examples on how to convert various timestamp formats to Discord UNIX timestamps.

Basic Example

Let's begin with a simple example using an ISO 8601 timestamp. Simply import the discstamp module and call the iso function with the timestamp you want to convert:

const discstamp = require('discstamp');

const isoTimestamp = '2023-08-27T19:45:00';
const discordTimestampFromIso = discstamp.iso(isoTimestamp);
console.log(discordTimestampFromIso);

AM/PM Format

You can also convert timestamps in the AM/PM format. Provide the time along with the period (AM/PM), followed by the timezone to the ampm function:

const discstamp = require('discstamp');
const amPmTimestampWithTimezone = '08:30 AM EST';
const discordTimestampFromAmPm = discstamp.ampm(amPmTimestampWithTimezone);
console.log(discordTimestampFromAmPm);

Supported Timezones

Many timezones are supported, some of them, with their code are listed below:

American Timezones

| Timezone Name | Timezone Code | Offset | |-----------------------------------|---------------|-----------| | Eastern Standard Time | EST | UTC-5 | | Central Standard Time | CST | UTC-6 | | Mountain Standard Time | MST | UTC-7 | | Pacific Standard Time | PST | UTC-8 | | Alaska Standard Time | AKST | UTC-9 | | Hawaii-Aleutian Standard Time | HST | UTC-10 | | Brasília Time | BRT | UTC-3 | | Argentina Time | ART | UTC-3 |

European Timezones

| Timezone Name | Timezone Code | Offset | |-----------------------------------|---------------|-----------| | Central European Time | CET | UTC+1 | | Eastern European Time | EET | UTC+2 | | Western European Time | WET | UTC+0 | | Irish Standard Time | IST | UTC+0 | | Greenwich Mean Time | GMT | UTC+0 | | Coordinated Universal Time | UTC | UTC+0 | | British Summer Time | BST | UTC+1 | | Central European Summer Time | CEST | UTC+2 | | Eastern European Summer Time | EEST | UTC+3 | | Moscow Standard Time | MSK | UTC+3 | | Central European Time (Croatia) | CET | UTC+1 | | Eastern European Time (Estonia) | EET | UTC+2 | | Western European Time (Portugal) | WET | UTC+0 | | Central European Time (Spain) | CET | UTC+1 | | Eastern European Time (Finland) | EET | UTC+2 | | Central European Time (Norway) | CET | UTC+1 | | Eastern European Time (Romania) | EET | UTC+2 | | Central European Time (Switzerland)| CET | UTC+1 | | Eastern European Time (Turkey) | EET | UTC+3 |

Middle Eastern Timezones

| Timezone Name | Timezone Code | Offset | |------------------------|---------------|-----------| | Arabia Standard Time | AST | UTC+3 | | Israel Standard Time | ISST | UTC+2 | | Turkey Time | TRT | UTC+3 | | Iran Standard Time | IRST | UTC+3:30 | | Iraq Standard Time | AST | UTC+3 | | United Arab Emirates Standard Time | GST | UTC+4 | | Qatar Standard Time | AST | UTC+3 | | Oman Standard Time | GST | UTC+4 | | Kuwait Standard Time | AST | UTC+3 | | Bahrain Standard Time | AST | UTC+3 | | Yemen Standard Time | AST | UTC+3 | | Jordan Standard Time | EET | UTC+2 | | Lebanon Standard Time | EET | UTC+2 | | Syria Standard Time | EET | UTC+2 | | Palestine Standard Time | EET | UTC+2 |

Asian Timezones

| Timezone Name | Timezone Code | Offset | |-------------------------------|---------------|-----------| | China Standard Time | CST | UTC+8 | | Japan Standard Time | JST | UTC+9 | | Korea Standard Time | KST | UTC+9 | | India Standard Time | IST | UTC+5:30 | | Pakistan Standard Time | PKT | UTC+5 | | Bangladesh Standard Time | BST | UTC+6 | | Southeast Asia Time | SGT | UTC+8 | | Australia Western Standard Time| AWST | UTC+8 | | Hong Kong Time | HKT | UTC+8 | | Indochina Time | ICT | UTC+7 |

Oceanian Timezones

| Timezone Name | Timezone Code | Offset | |-----------------------------------|---------------|-----------| | Australian Eastern Time | AET | UTC+11 | | Australian Central Time | ACT | UTC+10:30 | | Australian Central Standard Time | ACST | UTC+9:30 | | Australian Western Standard Time | AWST | UTC+8 | | Fiji Standard Time | FJT | UTC+12 | | New Zealand Standard Time | NZST | UTC+12 | | New Zealand Daylight Time | NZDT | UTC+13 | | Papua New Guinea Time | PGT | UTC+10 | | Solomon Islands Time | SBT | UTC+11 | | Vanuatu Standard Time | VUT | UTC+11 | | Wallis and Futuna Time | WFT | UTC+12 | | Norfolk Island Time | NFT | UTC+11:30 | | Tonga Standard Time | TOT | UTC+13 | | Samoa Standard Time | SST | UTC-11 | | Tokelau Time | TKT | UTC+13 | | Tuvalu Time | TVT | UTC+12 |

Long Date Format

Converting timestamps in long date format is just as easy:

const discstamp = require('discstamp');
const longDateTimestamp = 'August 27, 2023 19:45:00 UTC';
const discordTimestampFromLongDate = discstamp.longdate(longDateTimestamp);
console.log(discordTimestampFromLongDate);

Custom Formats

discstamp supports an array of other formats as well, including DD/MM/YYYY, MM/DD/YYYY, Human-Readable Textual Formats, Julian Date, and more. Each format has its own corresponding function that you can use similarly to the examples above.

Experiment with different formats and timestamps to see how discstamp can seamlessly integrate timestamp conversions into your projects!

For more details on supported formats and functions, refer to the Supported Formats section.

Feel free to share your usage examples and innovative timestamp conversions with the discstamp community!

Feel free to share your usage examples and innovative timestamp conversions with the discstamp community!

Contributing

We encourage contributions from the community! To get involved, please follow our contribution guidelines. Feel free to create an PR or an issue if you wish to contribute Github Repo

License

This project is licensed under the GNU License.

Note: Package is being maintained to the fullest, apologies if you need to reinstall