Package Exports

world-timestamp
world-timestamp/build/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (world-timestamp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

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