Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings
This repository was archived by the owner on Jun 23, 2019. It is now read-only.

motss/utc-time

Repository files navigation

🚨 No longer maintained. Moved to @reallyland/node_mod. 🚨

@motss/utc-time

Generate JavaScript's UTC time with various offsets


NPM

Build Status Version Downloads MIT License Dependency Status NSP Status

Code of Conduct Codecov Coverage Status

codebeat-badge codacy-badge inch-badge

Returns a JavaScript date object using the UTC timezone with optional offsets to adjust the hour, minute, second or millisecond.

Table of contents

Pre-requisites

Setup

Install

# Install via NPM
$ npm install --save @motss/utc-time

Usage

Node.js

const {
 utcTime,
 // utcTimeSync,
} = require('@motss/utc-time');
void async function main() {
 /** NOTE: Assuming today's date is '2020-02-02', */
 const defaultUTCDatetime = await utcTime(); // utcTimeSync();
 const defaultUTCDatetimeWithOffsets = await utcTime({
 offset: {
 hour: 3,
 minute: 2,
 second: 1,
 millisecond: 0,
 },
 });
 const specifiedUTCDatetime = await utcTime({
 startDatetime: '2033-03-03T03:33:33.333Z',
 });
 
 assert(defaultUTCDatetime, new Date('2020-02-02T00:00:00.000Z')); // OK
 assert(defaultUTCDatetimeWithOffsets, new Date('2020-02-02T03:02:01.000Z')); // OK
 assert(specifiedUTCDatetime, new Date('2033-03-03T03:33:33.333Z')); // OK
}();

Native ES modules or TypeScript

// @ts-check
import {
 utcTime,
 // utcTimeSync,
} from '@motss/utc-time';
void async function main() {
 /** NOTE: Assuming today's date is '2020-02-02', */
 const defaultUTCDatetime = await utcTime(); // utcTimeSync();
 const defaultUTCDatetimeWithOffsets = await utcTime({
 offset: {
 hour: 3,
 minute: 2,
 second: 1,
 millisecond: 0,
 },
 });
 const specifiedUTCDatetime = await utcTime({
 startDatetime: '2033-03-03T03:33:33.333Z',
 });
 
 assert(defaultUTCDatetime, new Date('2020-02-02T00:00:00.000Z')); // OK
 assert(defaultUTCDatetimeWithOffsets, new Date('2020-02-02T03:02:01.000Z')); // OK
 assert(specifiedUTCDatetime, new Date('2033-03-03T03:33:33.333Z')); // OK
}();

API Reference

UTCTimeOpts

  • offsets <Object> Optional offset values when returning a JavaScript Date object using UTC timezone.
    • hour <number> Optional offset to adjust the hour.
    • minute <number> Optional offset to adjust the minute.
    • second <number> Optional offset to adjust the second.
    • millisecond <number> Optional offset to adjust the millisecond.
  • startDatetime <string|number|Date> Optional starting datetime. Defaults to today's datetime if it is not provided.

utcTime([UTCTimeOps])

utcTimeSync([UTCTimeOpts])

This methods works the same as utcTime([UTCTimeOpts]) except that this is the synchronous version.

License

MIT License Β© Rong Sen Ng

About

Generate JavaScript's UTC time with various offsets

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /