mirror of
				https://github.com/therootcompany/tz.js.git
				synced 2024-11-16 17:29:01 +00:00 
			
		
		
		
	Compare commits
	
		
			No commits in common. "6417eca7f69ba0c7eabdcc92f284ea2397efec59" and "6a095b0966704f61bb1a66e544320e5557d93318" have entirely different histories.
		
	
	
		
			6417eca7f6
			...
			6a095b0966
		
	
		
							
								
								
									
										108
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										108
									
								
								README.md
									
									
									
									
									
								
							| @ -9,36 +9,58 @@ XTZ is a poor man's `Temporal` polyfill, but just for time zones. \ | ||||
| Demo: <https://therootcompany.github.io/tz.js/> | ||||
| 
 | ||||
| ```js | ||||
| // What's the current time, in ISO+Offset format? | ||||
| // What's the current time, in ISO format? | ||||
| 
 | ||||
| TZ.toLocalISOString(new Date()); // "2021-11-07T03:15:59.000-0500" | ||||
| TZ.timeZone(); // "America/New_York" | ||||
| ``` | ||||
| 
 | ||||
| ```js | ||||
| // What will the ISO+Offset datetime string be | ||||
| // when it's 3:15am in New York? | ||||
| // | ||||
| // (Relative New York time to Absolute ISO+Offset Time) | ||||
| > What UTC time will it be when it's 3:15am in New York? | ||||
| 
 | ||||
| TZ.toOffsetISOString("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| ```js | ||||
| // Relative New York time to Absolute UTC Time | ||||
| TZ.toUTCISOString("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| // "2021-11-07T03:15:59.000-0500" | ||||
| ``` | ||||
| 
 | ||||
| ```js | ||||
| // What time will it be in New York | ||||
| // when it's 7:15am UTC? | ||||
| // | ||||
| // (Absolute UTC Zulu time to Relative New York time) | ||||
| var tzDate = TZ.toUTC("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| // { | ||||
| //   year: 2021, month: 10, day: 7, | ||||
| //   hour: 3, minute: 15, second: 59, millisecond: 0, | ||||
| //   offset: -300, timeZoneName: "Eastern Standard Time" | ||||
| // } | ||||
| 
 | ||||
| tzDate.toISOString(); | ||||
| // "2021-11-07T03:15:59.000-0500" | ||||
| // (same as "2021-11-07T08:15:59.000Z") | ||||
| ``` | ||||
| 
 | ||||
| > What time will it be in New York when it's 7:15am UTC? | ||||
| 
 | ||||
| ```js | ||||
| // Absolute UTC time to Relative New York time | ||||
| TZ.toTimeZoneISOString("2021-03-14T07:15:59.000Z", "America/New_York"); | ||||
| // "2021-03-14T03:15:59.000-0400" | ||||
| ``` | ||||
| 
 | ||||
| ```js | ||||
| var utcDate = TZ.toTimeZone("2021-03-14T07:15:59.000Z", "America/New_York"); | ||||
| // { | ||||
| //   year: 2021, month: 2, day: 14, | ||||
| //   hour: 3, minute: 15, second: 59, millisecond: 0, | ||||
| //   offset: -240, timeZoneName: "Eastern Daylight Time" | ||||
| // } | ||||
| 
 | ||||
| utcDate.toISOString(); | ||||
| // "2021-03-14T03:15:59.000-0400" | ||||
| // (same as "2021-11-07T07:15:59.000Z") | ||||
| ``` | ||||
| 
 | ||||
| # Features | ||||
| 
 | ||||
| - [x] Translate a UTC Zulu time to a Time Zone | ||||
| - [x] Translate a Zoned time to ISO+Offset | ||||
| - [x] Translate a UTC time to a Time Zone | ||||
| - [x] Translate a Zoned time to UTC | ||||
| - [x] Handles **Daylight Savings**, Weird Time Zones, etc... | ||||
|   - [x] Well-tested `npm run test` | ||||
| - [x] Lightweight (No deps) | ||||
| @ -86,46 +108,33 @@ https://www.youtube.com/playlist?list=PLxki0D-ilnqa6horOJ2G18WMZlJeQFlAt | ||||
| - `toLocalISOString(dateOrNull)` | ||||
| - `toTimeZone(utcDate, timeZone)` | ||||
| - `toTimeZoneISOString(isoString, timeZone)` | ||||
| - `fromTimeZone(dtString, timeZone)` | ||||
| - `toOffsetISOString(dtString, timeZone)` | ||||
| - `toUTC(dtString, timeZone)` | ||||
| - `toUTCISOString(dtString, timeZone)` | ||||
| 
 | ||||
| ## `toTimeZone(utcDate, timeZone)` | ||||
| 
 | ||||
| > Convert UTC into a Target Time Zone | ||||
| 
 | ||||
| Use ISO timestamps representing the absolute UTC time (ISO with or without offset): | ||||
| Use ISO timestamps representing the absolute UTC time (with or without offset): | ||||
| 
 | ||||
| ```txt | ||||
| "2021-11-07T08:15:59.000Z" | ||||
| ``` | ||||
| 
 | ||||
| ```js | ||||
| var utcDate = TZ.toTimeZone("2021-03-14T07:15:59.000Z", "America/New_York"); | ||||
| // { | ||||
| //   year: 2021, month: 2, day: 14, | ||||
| //   hour: 3, minute: 15, second: 59, millisecond: 0, | ||||
| //   offset: -240, timeZoneName: "Eastern Daylight Time" | ||||
| // } | ||||
| 
 | ||||
| utcDate.toISOString(); | ||||
| // "2021-03-14T03:15:59.000-0400" | ||||
| // (same as "2021-11-07T07:15:59.000Z") | ||||
| ``` | ||||
| 
 | ||||
| ### Convert directly to an ISO String: | ||||
| Convert directly to an ISO String: | ||||
| 
 | ||||
| ```js | ||||
| TZ.toTimeZoneISOString("2021-11-07T08:15:59.000Z", "America/New_York"); | ||||
| // "2021-11-07T03:15:59.000-0500" | ||||
| ``` | ||||
| 
 | ||||
| ### Or use our bespoke (custom) date object: | ||||
| Or use our bespoke (custom) date object: | ||||
| 
 | ||||
| ```js | ||||
| var tzDate = TZ.toTimeZone("2021-11-07T08:15:59.000Z", "America/New_York"); | ||||
| ``` | ||||
| 
 | ||||
| ### You can also use a date object with an absolute ISO time: | ||||
| You can also use a date object with an absolute UTC time: | ||||
| 
 | ||||
| ```js | ||||
| var tzDate = TZ.toTimeZone( | ||||
| @ -139,16 +148,16 @@ console.log(tzDate.toISOString()); | ||||
| // "2021-11-07T03:15:59.000-0500" | ||||
| ``` | ||||
| 
 | ||||
| ### Our ISO Strings + Offsets work with JavaScript's native Date object!! | ||||
| Our ISO Strings + Offsets work with JavaScript's native Date object!! | ||||
| 
 | ||||
| ```js | ||||
| new Date("2021-11-07T03:15:59.000-0500").toISOString()); | ||||
| // "2021-11-07T08:15:59.000Z" | ||||
| ``` | ||||
| 
 | ||||
| ## `fromTimeZone(dtString, timeZone)` | ||||
| ## `toUTC(dtString, timeZone)` | ||||
| 
 | ||||
| > Convert a Target Time Zone into ISO | ||||
| > Convert a Target Time Zone into UTC | ||||
| 
 | ||||
| Use ISO-like timestamps representing the _local_ time in the target time zone: | ||||
| 
 | ||||
| @ -156,39 +165,24 @@ Use ISO-like timestamps representing the _local_ time in the target time zone: | ||||
| "2021-11-0 03:15:59.000" | ||||
| ``` | ||||
| 
 | ||||
| ```js | ||||
| var tzDate = TZ.fromTimeZone("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| // { | ||||
| //   year: 2021, month: 10, day: 7, | ||||
| //   hour: 3, minute: 15, second: 59, millisecond: 0, | ||||
| //   offset: -300, timeZoneName: "Eastern Standard Time" | ||||
| // } | ||||
| 
 | ||||
| tzDate.toISOString(); | ||||
| // "2021-11-07T03:15:59.000-0500" | ||||
| // (same as "2021-11-07T08:15:59.000Z") | ||||
| ``` | ||||
| 
 | ||||
| ### Convert directly to an offset ISO String: | ||||
| Convert directly to an offset ISO String: | ||||
| 
 | ||||
| ```js | ||||
| TZ.toOffsetISOString("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| TZ.toUTCISOString("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| // "2021-11-07T03:15:59.000-0500" | ||||
| ``` | ||||
| 
 | ||||
| ### Or our bespoke date object: | ||||
| Or our bespoke date object: | ||||
| 
 | ||||
| ```js | ||||
| var utcDate = TZ.fromTimeZone("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| var utcDate = TZ.toUTC("2021-11-07 03:15:59.000", "America/New_York"); | ||||
| ``` | ||||
| 
 | ||||
| ### Use a Date as a source time | ||||
| 
 | ||||
| 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.fromTimeZone( | ||||
| var utcDate = TZ.toUTC( | ||||
|   new Date("2021-11-07T03:15:59.000Z"), | ||||
|   "America/New_York" | ||||
| ); | ||||
| @ -213,7 +207,7 @@ 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. | ||||
|   ```js | ||||
|   var utcDate = TZ.fromTimeZone("2021-03-14 02:15:59.000", "America/New_York"); | ||||
|   var utcDate = TZ.toUTC("2021-03-14 02:15:59.000", "America/New_York"); | ||||
|   utcDate.toISOString(); | ||||
|   // "2021-03-14T02:15:59.000-0400" | ||||
|   // (same as "2021-03-14T01:15:59.000-0500") | ||||
| @ -224,7 +218,7 @@ Q: What happens in November when 1am happens twice? | ||||
| - A: Although both 1ams are distinguishable with ISO offset times, only the first can be resolved from a local time | ||||
|   with this library. | ||||
|   ```js | ||||
|   var utcDate = TZ.fromTimeZone("2021-11-07 01:15:59.000", "America/New_York"); | ||||
|   var utcDate = TZ.toUTC("2021-11-07 01:15:59.000", "America/New_York"); | ||||
|   utcDate.toISOString(); | ||||
|   // "2021-11-07T01:15:59.000-0400", same as "2021-11-07T05:15:59.000Z" | ||||
|   // (an hour before the 2nd 1am at "2021-11-07T01:15:59.000-0500") | ||||
|  | ||||
							
								
								
									
										12
									
								
								examples.js
									
									
									
									
									
								
							
							
						
						
									
										12
									
								
								examples.js
									
									
									
									
									
								
							| @ -22,9 +22,9 @@ var XTZ; | ||||
|     console.info(); | ||||
| 
 | ||||
|     console.info("\t// during daylight savings"); | ||||
|     console.info(`\tXTZ.fromTimeZone("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.fromTimeZone("2021-03-14 08:15:59.000", "America/New_York"); | ||||
|     tzDate = XTZ.toUTC("2021-03-14 08:15:59.000", "America/New_York"); | ||||
|     console.info( | ||||
|       "\t" + tzDate.toISOString(), | ||||
|       "// same as", | ||||
| @ -33,9 +33,9 @@ var XTZ; | ||||
|     console.info(); | ||||
| 
 | ||||
|     console.info("\t// during standard time"); | ||||
|     console.info(`\tXTZ.fromTimeZone("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.fromTimeZone("2021-11-07 08:15:59.000", "America/New_York"); | ||||
|     tzDate = XTZ.toUTC("2021-11-07 08:15:59.000", "America/New_York"); | ||||
|     console.info( | ||||
|       "\t" + tzDate.toISOString(), | ||||
|       "// same as", | ||||
| @ -65,9 +65,9 @@ var XTZ; | ||||
|     console.info(); | ||||
| 
 | ||||
|     console.info("\t// during standard time"); | ||||
|     console.info(`\tXTZ.fromTimeZone("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.fromTimeZone("2021-11-07T08:15:59.000Z", "America/New_York"); | ||||
|     tzDate = XTZ.toUTC("2021-11-07T08:15:59.000Z", "America/New_York"); | ||||
|     console.info( | ||||
|       "\t" + tzDate.toISOString(), | ||||
|       "// same as", | ||||
|  | ||||
							
								
								
									
										18
									
								
								index.html
									
									
									
									
									
								
							
							
						
						
									
										18
									
								
								index.html
									
									
									
									
									
								
							| @ -99,8 +99,8 @@ String(((new Date()).getTimezoneOffset() % 60)).padStart(2, '0')</code></pre> | ||||
|     <hr /> | ||||
| 
 | ||||
|     <form class="js-tz2utc"> | ||||
|       <h3>TimeZone-Relative (Local) to Absolute (ISO+Offset) String:</h3> | ||||
|       <pre><code>XTZ.fromTimeZone("<span class="js-dtx-tz">YYYY-03-14 03:15:69.000</span>", "<span class="js-tzx-tz">UTC</span>") | ||||
|       <h3>Relative TimeZone to Absolute UTC:</h3> | ||||
|       <pre><code>XTZ.toUTC("<span class="js-dtx-tz">YYYY-03-14 03:15:69.000</span>", "<span class="js-tzx-tz">UTC</span>") | ||||
|    .toISOString() | ||||
| // <span class="js-myx-dt-tz"></span></code></pre> | ||||
|       <label> | ||||
| @ -130,14 +130,14 @@ String(((new Date()).getTimezoneOffset() % 60)).padStart(2, '0')</code></pre> | ||||
|       </label> | ||||
|       <br /> | ||||
|       <br /> | ||||
|       <button type="submit">Convert to ISO+Offset!</button> | ||||
|       <button type="submit">Convert to UTC!</button> | ||||
|       <br /> | ||||
|     </form> | ||||
| 
 | ||||
|     <hr /> | ||||
| 
 | ||||
|     <form class="js-utc2tz"> | ||||
|       <h3>Absolute (UTC) to TimeZone-Relative (ISO+Offset) String:</h3> | ||||
|       <h3>Absolute UTC to Relative TimeZone</h3> | ||||
|       <pre><code>XTZ.toTimeZone("<span class="js-dtx-utc">YYYY-03-14 03:15:69.000</span>", "<span class="js-tzx-utc">UTC</span>") | ||||
|    .toISOString() | ||||
| // <span class="js-myx-dt-utc"></span></code></pre> | ||||
| @ -201,17 +201,17 @@ Asia/Kolkata        +0530 (No DST) (30-min)</pre | ||||
|       } | ||||
| 
 | ||||
|       function translate(dt, tz, tz2) { | ||||
|         var utc = new Date(XTZ.fromTimeZone(dt, tz).toISOString()); | ||||
|         var utc = new Date(XTZ.toUTC(dt, tz).toISOString()); | ||||
|         if (!tz2) { | ||||
|           return utc; | ||||
|         } | ||||
|         return XTZ.toTimeZone(utc, tz2); | ||||
|       } | ||||
| 
 | ||||
|       function fromTimeZone() { | ||||
|       function toUTC() { | ||||
|         var curDt = $(".js-dt-tz").value; | ||||
|         var curTz = $(".js-tz-tz").value; | ||||
|         $(".js-my-dt-tz").value = XTZ.fromTimeZone(curDt, curTz).toISOString(); | ||||
|         $(".js-my-dt-tz").value = XTZ.toUTC(curDt, curTz).toISOString(); | ||||
| 
 | ||||
|         $(".js-dtx-tz").innerText = curDt; | ||||
|         $(".js-tzx-tz").innerText = curTz; | ||||
| @ -265,10 +265,10 @@ Asia/Kolkata        +0530 (No DST) (30-min)</pre | ||||
|       $("form.js-tz2utc").addEventListener("submit", function (ev) { | ||||
|         ev.preventDefault(); | ||||
|         ev.stopPropagation(); | ||||
|         fromTimeZone(); | ||||
|         toUTC(); | ||||
|       }); | ||||
| 
 | ||||
|       fromTimeZone(); | ||||
|       toUTC(); | ||||
|       toTZ(); | ||||
|       xTZ(); | ||||
|     </script> | ||||
|  | ||||
| @ -1,12 +1,8 @@ | ||||
| { | ||||
|   "name": "xtz", | ||||
|   "version": "1.3.1", | ||||
|   "version": "1.1.1", | ||||
|   "description": "A fast, lightweight, zero-dependency library to translate between Time Zones and UTC with native Intl.DateTimeFormat in ~100 LoC. For Node.js & Browsers.", | ||||
|   "main": "xtz.js", | ||||
|   "files": [ | ||||
|     "xtz.js", | ||||
|     "tolocalisostring.js" | ||||
|   ], | ||||
|   "scripts": { | ||||
|     "test": "node ./test.js", | ||||
|     "build": "uglifyjs ./xtz.js > ./xtz.min.js ; gzip -k -f ./xtz.min.js" | ||||
|  | ||||
							
								
								
									
										53
									
								
								test.js
									
									
									
									
									
								
							
							
						
						
									
										53
									
								
								test.js
									
									
									
									
									
								
							| @ -6,7 +6,7 @@ function testUtcToTz(t) { | ||||
|   var result = TZ.toTimeZone.apply(TZ, t.inputs).toISOString(); | ||||
|   if (t.result !== result) { | ||||
|     throw new Error( | ||||
|       `Invalid UTC/ISO+Offset to TZ conversion for ${t.desc}:\n` + | ||||
|       `Invalid UTC to TZ conversion for ${t.desc}:\n` + | ||||
|         `\tExpected: ${t.result}\n` + | ||||
|         `\tActual: ${result}\n` | ||||
|     ); | ||||
| @ -15,8 +15,7 @@ function testUtcToTz(t) { | ||||
| 
 | ||||
| function testTzToUtc(t) { | ||||
|   var result = TZ.toUTC.apply(TZ, t.inputs); | ||||
|   var result2 = TZ.fromTimeZone.apply(TZ, t.inputs); | ||||
|   if (t.result !== result.toISOString() || t.result !== result2.toISOString()) { | ||||
|   if (t.result !== result.toISOString()) { | ||||
|     console.log(result); | ||||
|     throw new Error( | ||||
|       `Invalid TZ to UTC conversion for ${t.desc}:\n` + | ||||
| @ -45,23 +44,23 @@ function testTzToUtc(t) { | ||||
| 
 | ||||
|   // 12:15am NY -0500 => -0400
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 12:15am NY EST", | ||||
|     desc: "UTC to 12:15am NY EST", | ||||
|     inputs: ["2021-03-14T05:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-03-14T00:15:59.000-0500", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 12:15am NY EST (2)", | ||||
|     desc: "UTC to 12:15am NY EST (2)", | ||||
|     inputs: ["2021-03-14T00:15:59.000-0500", "America/New_York"], | ||||
|     result: "2021-03-14T00:15:59.000-0500", | ||||
|   }, | ||||
|   // 1:15am NY (non-DST)
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 1:15am NY EST", | ||||
|     desc: "UTC to 1:15am NY EST", | ||||
|     inputs: ["2021-03-14T06:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-03-14T01:15:59.000-0500", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 1:15am NY EST (2)", | ||||
|     desc: "UTC to 1:15am NY EST (2)", | ||||
|     inputs: ["2021-03-14T01:15:59.000-0500", "America/New_York"], | ||||
|     result: "2021-03-14T01:15:59.000-0500", | ||||
|   }, | ||||
| @ -70,23 +69,23 @@ function testTzToUtc(t) { | ||||
| 
 | ||||
|   // 3:15am NY (DST)
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 3:15am NY EDT", | ||||
|     desc: "UTC to 3:15am NY EDT", | ||||
|     inputs: ["2021-03-14T07:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-03-14T03:15:59.000-0400", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 3:15am NY EDT (2)", | ||||
|     desc: "UTC to 3:15am NY EDT (2)", | ||||
|     inputs: ["2021-03-14T03:15:59.000-0400", "America/New_York"], | ||||
|     result: "2021-03-14T03:15:59.000-0400", | ||||
|   }, | ||||
|   // 4:15am NY
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 4:15am NY EDT", | ||||
|     desc: "UTC to 4:15am NY EDT", | ||||
|     inputs: ["2021-03-14T08:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-03-14T04:15:59.000-0400", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 4:15am NY EDT (2)", | ||||
|     desc: "UTC to 4:15am NY EDT (2)", | ||||
|     inputs: ["2021-03-14T04:15:59.000-0400", "America/New_York"], | ||||
|     result: "2021-03-14T04:15:59.000-0400", | ||||
|   }, | ||||
| @ -107,57 +106,57 @@ function testTzToUtc(t) { | ||||
| 
 | ||||
|   // 12:15am NY -0400 => -0500
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 2021 Nov 7, 12:15am NY EDT", | ||||
|     desc: "UTC to 2021 Nov 7, 12:15am NY EDT", | ||||
|     inputs: ["2021-11-07T04:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-11-07T00:15:59.000-0400", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 2021 Nov 7, 12:15am NY EDT (2)", | ||||
|     desc: "UTC to 2021 Nov 7, 12:15am NY EDT (2)", | ||||
|     inputs: ["2021-11-07T00:15:59.000-0400", "America/New_York"], | ||||
|     result: "2021-11-07T00:15:59.000-0400", | ||||
|   }, | ||||
|   // 1:15am NY (DST) -0400
 | ||||
|   // NOTE: 1:15am happens TWICE (with different offsets)
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 2021 Nov 7, 1:15am NY EDT", | ||||
|     desc: "UTC to 2021 Nov 7, 1:15am NY EDT", | ||||
|     inputs: ["2021-11-07T05:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-11-07T01:15:59.000-0400", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 2021 Nov 7, 1:15am NY EDT (2)", | ||||
|     desc: "UTC to 2021 Nov 7, 1:15am NY EDT (2)", | ||||
|     inputs: ["2021-11-07T01:15:59.000-0400", "America/New_York"], | ||||
|     result: "2021-11-07T01:15:59.000-0400", | ||||
|   }, | ||||
|   // 1:15am NY (non-DST) -0500
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 2021 Nov 7, 1:15am NY EST", | ||||
|     desc: "UTC to 2021 Nov 7, 1:15am NY EST", | ||||
|     inputs: ["2021-11-07T06:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-11-07T01:15:59.000-0500", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 2021 Nov 7, 1:15am NY EST (2)", | ||||
|     desc: "UTC to 2021 Nov 7, 1:15am NY EST (2)", | ||||
|     inputs: ["2021-11-07T01:15:59.000-0500", "America/New_York"], | ||||
|     result: "2021-11-07T01:15:59.000-0500", | ||||
|   }, | ||||
|   // 2:15am NY -0500
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 2021 Nov 7, 2:15am NY EST", | ||||
|     desc: "UTC to 2021 Nov 7, 2:15am NY EST", | ||||
|     inputs: ["2021-11-07T07:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-11-07T02:15:59.000-0500", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 2021 Nov 7, 2:15am NY EST (2)", | ||||
|     desc: "UTC to 2021 Nov 7, 2:15am NY EST (2)", | ||||
|     inputs: ["2021-11-07T02:15:59.000-0500", "America/New_York"], | ||||
|     result: "2021-11-07T02:15:59.000-0500", | ||||
|   }, | ||||
|   // 3:15am NY
 | ||||
|   { | ||||
|     desc: "UTC Zulu to 2021 Nov 7, 3:15am NY EST", | ||||
|     desc: "UTC to 2021 Nov 7, 3:15am NY EST", | ||||
|     inputs: ["2021-11-07T08:15:59.000Z", "America/New_York"], | ||||
|     result: "2021-11-07T03:15:59.000-0500", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to 2021 Nov 7, 3:15am NY EST (2)", | ||||
|     desc: "UTC to 2021 Nov 7, 3:15am NY EST (2)", | ||||
|     inputs: ["2021-11-07T03:15:59.000-0500", "America/New_York"], | ||||
|     result: "2021-11-07T03:15:59.000-0500", | ||||
|   }, | ||||
| @ -168,29 +167,27 @@ function testTzToUtc(t) { | ||||
| 
 | ||||
|   // Colombo +0530 (not DST)
 | ||||
|   { | ||||
|     desc: "UTC Zulu to Asia/Colombo (1)", | ||||
|     desc: "UTC to Asia/Colombo (1)", | ||||
|     inputs: ["2021-03-14T08:15:59.000Z", "Asia/Colombo"], | ||||
|     result: "2021-03-14T13:45:59.000+0530", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to Asia/Colombo (2)", | ||||
|     desc: "UTC to Asia/Colombo (2)", | ||||
|     inputs: ["2021-03-14T13:45:59.000+0530", "Asia/Colombo"], | ||||
|     result: "2021-03-14T13:45:59.000+0530", | ||||
|   }, | ||||
|   { | ||||
|     desc: "UTC Zulu to Asia/Colombo (3)", | ||||
|     desc: "UTC to Asia/Colombo (3)", | ||||
|     inputs: ["2021-11-07T08:15:59.000Z", "Asia/Colombo"], | ||||
|     result: "2021-11-07T13:45:59.000+0530", | ||||
|   }, | ||||
|   { | ||||
|     desc: "ISO+Offset to Asia/Colombo (4)", | ||||
|     desc: "UTC to Asia/Colombo (4)", | ||||
|     inputs: ["2021-11-07T13:45:59.000+0530", "Asia/Colombo"], | ||||
|     result: "2021-11-07T13:45:59.000+0530", | ||||
|   }, | ||||
| ].forEach(testUtcToTz); | ||||
| console.info( | ||||
|   "Pass: UTC/ISO+Offset to TZ for America/New_York and Asia/Colombo" | ||||
| ); | ||||
| console.info("Pass: UTC to TZ for America/New_York and Asia/Colombo"); | ||||
| 
 | ||||
| [ | ||||
|   //
 | ||||
|  | ||||
							
								
								
									
										49
									
								
								xtz.js
									
									
									
									
									
								
							
							
						
						
									
										49
									
								
								xtz.js
									
									
									
									
									
								
							| @ -1,4 +1,6 @@ | ||||
| (function (exports) { | ||||
| var XTZ; | ||||
| 
 | ||||
| (function () { | ||||
|   "use strict"; | ||||
| 
 | ||||
|   function toTimeZone(date, timeZone) { | ||||
| @ -60,16 +62,15 @@ | ||||
| 
 | ||||
|   function toTimeZoneISOString(date, timeZone) { | ||||
|     var whole = toTimeZone(date, timeZone); | ||||
|     return formatAsOffsetISOString(whole); | ||||
|     return toOffsetISOString(whole); | ||||
|   } | ||||
| 
 | ||||
|   function _toOffsetISOString() { | ||||
|     /* jshint validthis: true */ | ||||
|     return formatAsOffsetISOString(this); | ||||
|     return toOffsetISOString(this); | ||||
|   } | ||||
| 
 | ||||
|   function getOffset(utcDate, tzD2) { | ||||
|     var tzDate = new Date(formatAsOffsetISOString(tzD2)); | ||||
|     var tzDate = new Date(toOffsetISOString(tzD2)); | ||||
|     var diff = Math.round((tzDate.valueOf() - utcDate.valueOf()) / (60 * 1000)); | ||||
|     return diff; | ||||
|   } | ||||
| @ -97,21 +98,10 @@ | ||||
|     } | ||||
| 
 | ||||
|     // +0500, -0730
 | ||||
|     return ( | ||||
|       offset + h.toString().padStart(2, "0") + m.toString().padStart(2, "0") | ||||
|     ); | ||||
|     return offset + p2(h) + p2(m); | ||||
|   } | ||||
| 
 | ||||
|   function toOffsetISOString(date, timeZone) { | ||||
|     if ("offset" in date && "year" in date) { | ||||
|       return formatAsOffsetISOString(date); | ||||
|     } | ||||
| 
 | ||||
|     var whole = fromTimeZone(date, timeZone); | ||||
|     return formatAsOffsetISOString(whole); | ||||
|   } | ||||
| 
 | ||||
|   function formatAsOffsetISOString(d) { | ||||
|   function toOffsetISOString(d) { | ||||
|     var offset = formatOffset(d.offset); | ||||
|     return ( | ||||
|       `${d.year}-${p2(d.month + 1)}-${p2(d.day)}` + | ||||
| @ -121,7 +111,7 @@ | ||||
|     ); | ||||
|   } | ||||
| 
 | ||||
|   function fromTimeZone(dt, tz) { | ||||
|   function toUTC(dt, tz) { | ||||
|     if ("string" === typeof dt) { | ||||
|       // Either of these formats should work:
 | ||||
|       // 2021-03-14 01:15:59
 | ||||
| @ -158,6 +148,11 @@ | ||||
|     return tzD3; | ||||
|   } | ||||
| 
 | ||||
|   function toUTCISOString(date, timeZone) { | ||||
|     var whole = toUTC(date, timeZone); | ||||
|     return toOffsetISOString(whole); | ||||
|   } | ||||
| 
 | ||||
|   function toLocalISOString(dateOrStr) { | ||||
|     var d; | ||||
|     if (dateOrStr) { | ||||
| @ -179,17 +174,15 @@ | ||||
|     return `${YYYY}-${MM}-${DD}T${hh}:${mm}:${ss}.${sss}${offset}`; | ||||
|   } | ||||
| 
 | ||||
|   exports.XTZ = { | ||||
|   XTZ = { | ||||
|     // bespoke date =>
 | ||||
|     // 2021-11-07T3:15:59-0500
 | ||||
|     // (todo?)
 | ||||
|     // xtzToISOString: formatAsOffsetISOString,
 | ||||
|     // (deprecated)
 | ||||
|     toOffsetISOString: toOffsetISOString, | ||||
| 
 | ||||
|     // -240 => -0400
 | ||||
|     formatOffset: formatOffset, | ||||
| 
 | ||||
|     // new Date() => "2021-11-07T03:15:59-0500"
 | ||||
|     toLocalISOString: toLocalISOString, | ||||
| 
 | ||||
|     // [ "2021-11-07T08:15:59Z", "America/New_York" ]
 | ||||
| @ -199,13 +192,11 @@ | ||||
| 
 | ||||
|     // [ "2021-11-07 03:15:59", "America/New_York" ]
 | ||||
|     // => "2021-11-07T03:15:59-0500" // 2021-11-07T08:15:59Z
 | ||||
|     toUTC: fromTimeZone, | ||||
|     fromTimeZone: fromTimeZone, | ||||
|     // deprecated
 | ||||
|     toUTCISOString: toOffsetISOString, | ||||
|     toUTC: toUTC, | ||||
|     toUTCISOString: toUTCISOString, | ||||
|   }; | ||||
| 
 | ||||
|   if ("undefined" != typeof module && module.exports) { | ||||
|     module.exports = exports.XTZ; | ||||
|     module.exports = XTZ; | ||||
|   } | ||||
| })(("undefined" === typeof module && window) || exports); | ||||
| })(); | ||||
|  | ||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user