root/tz.js
3
1
Fork 0
mirror of https://github.com/therootcompany/tz.js synced 2025-11-03 22:32:47 +00:00
Code Issues Releases Wiki Activity

make Prettier

Browse Source
This commit is contained in:
AJ ONeal 2021-05-28 00:57:42 -06:00
parent aaa31a25b9
commit ff9e266052
6 changed files with 563 additions and 564 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.prettierignore Normal file
View File

@ -0,0 +1 @@
*.min.js

7
.prettierrc.json Normal file
View File

@ -0,0 +1,7 @@
{
"printWidth": 80,
"tabWidth": 2,
"singleQuote": false,
"bracketSpacing": true,
"semi": true
}

14
README.md
View File

@ -1,8 +1,7 @@
# [xtz.js](https://github.com/therootcompany/tz.js)
A fast, lightweight, zero-dependency library to
translate between Time Zones and UTC with native
`Intl.DateTimeFormat` in ~100 LoC. For Node.js & Browsers.
A fast, lightweight, zero-dependency library to translate between Time Zones and UTC with native `Intl.DateTimeFormat`
in ~100 LoC. For Node.js & Browsers.
XTZ is a poor man's Temporal polyfill, but just for time zones.
@ -155,7 +154,8 @@ Or our bespoke date object:
var utcDate = TZ.toUTC("2021-11-07 03:15:59.000", "America/New_York");
```
You can also use a date object as the source time, but the date's UTC time will be treated as **_relative to time zone_** rather than absolute (this is a workaround for JavaScript's lack of bi-directional timezone support).
You can also use a date object as the source time, but the date's UTC time will be treated as **_relative to time
zone_** rather than absolute (this is a workaround for JavaScript's lack of bi-directional timezone support).
```js
var utcDate = TZ.toUTC(
@ -180,7 +180,8 @@ utcDate.toISOString();
Q: What happens in March when 2am is skipped?
- A: Although 2am is not a valid time, rather than throwing an error this library will resolve to 1am instead, which is an hour early in real ("tick-tock" or "monotonic") time.
- A: Although 2am is not a valid time, rather than throwing an error this library will resolve to 1am instead, which
is an hour early in real ("tick-tock" or "monotonic") time.
```js
var utcDate = TZ.toUTC("2021-03-14 02:15:59.000", "America/New_York");
utcDate.toISOString();
@ -190,7 +191,8 @@ Q: What happens in March when 2am is skipped?
Q: What happens in November when 2am happens twice?
- A: Although both 2ams are distinguishable with ISO offset times, only the first can be resolved from a local time with this library.
- A: Although both 2ams are distinguishable with ISO offset times, only the first can be resolved from a local time
with this library.
```js
var utcDate = TZ.toUTC("2021-11-07 01:15:59.000", "America/New_York");
utcDate.toISOString();

16
examples.js
View File

@ -22,9 +22,7 @@ var XTZ;
console.info();
console.info("\t// during daylight savings");
console.info(
`\tXTZ.toUTC("2021-03-14 08:15:59.000", "America/New_York")`
);
console.info(`\tXTZ.toUTC("2021-03-14 08:15:59.000", "America/New_York")`);
console.info(`\ttzDate.toISOString()`);
tzDate = XTZ.toUTC("2021-03-14 08:15:59.000", "America/New_York");
console.info(
@ -35,9 +33,7 @@ var XTZ;
console.info();
console.info("\t// during standard time");
console.info(
`\tXTZ.toUTC("2021-11-07 08:15:59.000", "America/New_York")`
);
console.info(`\tXTZ.toUTC("2021-11-07 08:15:59.000", "America/New_York")`);
console.info(`\ttzDate.toISOString()`);
tzDate = XTZ.toUTC("2021-11-07 08:15:59.000", "America/New_York");
console.info(
@ -52,9 +48,7 @@ var XTZ;
// Time Zone-relative time translated to UTC
//
function demo2() {
console.info(
"What time is it in New York at 8:15am on March 14th UTC?"
);
console.info("What time is it in New York at 8:15am on March 14th UTC?");
console.info();
console.info("\t// during daylight savings");
@ -71,9 +65,7 @@ var XTZ;
console.info();
console.info("\t// during standard time");
console.info(
`\tXTZ.toUTC("2021-11-07T08:15:59.000Z", "America/New_York")`
);
console.info(`\tXTZ.toUTC("2021-11-07T08:15:59.000Z", "America/New_York")`);
console.info(`\ttzDate.toISOString()`);
tzDate = XTZ.toUTC("2021-11-07T08:15:59.000Z", "America/New_York");
console.info(

9
xtz.js
View File

@ -70,8 +70,7 @@ var XTZ;
function getOffset(utcDate, tzD2) {
var tzDate = new Date(toOffsetISOString(tzD2));
var diff =
Math.round(tzDate.valueOf() - utcDate.valueOf()) / (60 * 1000);
var diff = Math.round(tzDate.valueOf() - utcDate.valueOf()) / (60 * 1000);
return diff;
}
@ -99,9 +98,7 @@ var XTZ;
// +0500, -0730
return (
offset +
h.toString().padStart(2, "0") +
m.toString().padStart(2, "0")
offset + h.toString().padStart(2, "0") + m.toString().padStart(2, "0")
);
}
@ -179,4 +176,4 @@ var XTZ;
if ("undefined" != typeof module && module.exports) {
module.exports = XTZ;
}
}());
})();