world-timestamp

Provides UTC (or any timezone) time in microseconds and milliseconds from https://worldtimeapi.org.

• Totally independent of the local system clock.
• Capable of next.js, nuxt.js or any react projects.
• Supports various timezones. (See worldtimeapi/timezones)

Installation

$ npm install world-timestamp

Usage

import worldTimestamp from 'world-timestamp';

const getUTCTimestamp = async () => {
    // const timestamp = await worldTimestamp(); // "Etc/UTC" as default
    const timestamp = await worldTimestamp("Asia/Tokyo");

    console.log(timestamp.response); // returns worldtimeapi.org response
    console.log(timestamp.response.datetime); // Ex. 2022-10-01T18:00:00.123456+09:00

    console.log(timestamp.milliseconds); // 1664614800123.456
    console.log(timestamp.utcMilliseconds); // 1664647200123.456

    console.log(timestamp.microseconds); // 1664614800123456
    console.log(timestamp.utcMicroseconds); // 1664647200123456
};

References

worldTimestamp(timezone?: string): Promise<WorldTimestamp>

Parameter	Type	Description
timezone	string	Timezone. Default: "Etc/UTC"

You can find all available timezones here: https://worldtimeapi.org/timezones

WorldTimestamp

Property	Type	Description
response	WorldTimeApiResponse	Worldtimeapi.org response
milliseconds	number	Timestamp in milliseconds
utcMilliseconds	number	Timestamp in milliseconds in UTC
microseconds	number(intager)	Timestamp in microseconds
utcMicroseconds	number(intager)	Timestamp in microseconds in UTC

WorldTimeApiResponse

Property	Type	Description
abbreviation	string	Abbreviation of the timezone
client_ip	string	Client IP address
datetime	string	Timestamp in ISO 8601 format
day_of_week	number	Day of the week
day_of_year	number	Day of the year
dst	boolean	Is daylight saving time in effect?
dst_from	string	Date daylight saving time starts
dst_offset	number	Daylight saving time offset
dst_until	string	Date daylight saving time ends
raw_offset	number	Timezone offset from UTC including daylight saving time
timezone	string	Timezone
unixtime	number	Timestamp in seconds
utc_datetime	string	Timestamp in ISO 8601 format in UTC
utc_offset	string	Timezone offset from UTC
week_number	number	Week number

see more in https://worldtimeapi.org/pages/schema

License

MIT License © 2022 MugiSus

Feel free to contact me if you have any questions or suggestions.