From a520b9148cf42b3aa2b2535d97dad6bcd0e8806f Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 14 Oct 2023 00:19:49 +0200
Subject: [PATCH 01/39] Use Temporal API polyfill for development purpose

---
 package.json   |  3 +++
 pnpm-lock.yaml | 21 +++++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/package.json b/package.json
index 22b081c..1b3548b 100644
--- a/package.json
+++ b/package.json
@@ -65,5 +65,8 @@
     "overrides": {
       "has": "npm:@nolyfill/has@latest"
     }
+  },
+  "dependencies": {
+    "@js-temporal/polyfill": "^0.4.4"
   }
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index fd8983d..8787266 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -7,6 +7,11 @@ settings:
 overrides:
   has: npm:@nolyfill/has@latest
 
+dependencies:
+  '@js-temporal/polyfill':
+    specifier: ^0.4.4
+    version: 0.4.4
+
 devDependencies:
   '@size-limit/preset-small-lib':
     specifier: ^9.0.0
@@ -568,6 +573,14 @@ packages:
       '@jridgewell/sourcemap-codec': 1.4.15
     dev: true
 
+  /@js-temporal/polyfill@0.4.4:
+    resolution: {integrity: sha512-2X6bvghJ/JAoZO52lbgyAPFj8uCflhTo2g7nkFzEQdXd/D8rEeD4HtmTEpmtGCva260fcd66YNXBOYdnmHqSOg==}
+    engines: {node: '>=12'}
+    dependencies:
+      jsbi: 4.3.0
+      tslib: 2.6.2
+    dev: false
+
   /@nodelib/fs.scandir@2.1.5:
     resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
     engines: {node: '>= 8'}
@@ -1556,6 +1569,10 @@ packages:
       argparse: 2.0.1
     dev: true
 
+  /jsbi@4.3.0:
+    resolution: {integrity: sha512-SnZNcinB4RIcnEyZqFPdGPVgrg2AcnykiBy0sHVJQKHYeaLUvi3Exj+iaPpLnFVkDPZIV4U0yvgC9/R4uEAZ9g==}
+    dev: false
+
   /json-buffer@3.0.1:
     resolution: {integrity: sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==}
     dev: true
@@ -2242,6 +2259,10 @@ packages:
       read-pkg-up: 7.0.1
     dev: true
 
+  /tslib@2.6.2:
+    resolution: {integrity: sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==}
+    dev: false
+
   /type-check@0.4.0:
     resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==}
     engines: {node: '>= 0.8.0'}

From 45460b71b00e33961e6fafae57b2f05d18375005 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 14 Oct 2023 03:02:32 +0200
Subject: [PATCH 02/39] Start `duration` using the Temporal API

---
 src/temporal/duration.js     |  84 ++++++++++
 src/temporal/index.js        |   1 +
 tests/temporal/index.test.js | 302 +++++++++++++++++++++++++++++++++++
 3 files changed, 387 insertions(+)
 create mode 100644 src/temporal/duration.js
 create mode 100644 src/temporal/index.js
 create mode 100644 tests/temporal/index.test.js

diff --git a/src/temporal/duration.js b/src/temporal/duration.js
new file mode 100644
index 0000000..c6abb72
--- /dev/null
+++ b/src/temporal/duration.js
@@ -0,0 +1,84 @@
+/**
+ * @todo
+ * Continue the work once the following issue is clarified:
+ * https://github.com/tc39/proposal-temporal/issues/2711:
+ * - check decimal parameters
+ * - check balancing (https://tc39.es/proposal-temporal/docs/balancing.html)
+ * - add support for sub-second units (ms, mis, ns)
+ */
+
+import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+
+// Date.prototype.toTemporalInstant = toTemporalInstant
+
+/**
+ * Create `datetime="P3DT2H8M32.541S"` duration attribute for `<time>`.
+ * https://html.spec.whatwg.org/multipage/text-level-semantics.html#attr-time-datetime
+ * https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#concept-duration
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTimeElement/datetime
+ *
+ * See also: https://www.brucelawson.co.uk/2012/best-of-time/
+ *
+ * @param {DurationObject} duration
+ * @param {boolean} convertExcess
+ * @returns {string}
+ */
+export function duration(duration = {}, convertExcess = true) {
+
+  // Set default values for missing keys.
+  let { w = 0, d = 0, h = 0, m = 0, s = 0 } = duration
+
+  // At least one duration must be different than zero.
+  // if (![w, d, h, m, s].some(value => value)) {
+  //   return 'PT0S'
+  // }
+
+  /**
+   * @var {import('@js-temporal/polyfill').DurationLike} temporalDuration
+   */
+  // const temporalDuration = {
+  //   ...(w ? { weeks: w } : null),
+  //   // ...('w' in duration ? { weeks: duration.w } : null),
+  //   ...(d ? { days: d } : null),
+  //   // ...('d' in duration ? { days: duration.d } : null),
+  //   ...(h ? { hours: h } : null),
+  //   // ...('h' in duration ? { hours: duration.h } : null),
+  //   ...(m ? { minutes: m } : null),
+  //   // ...('m' in duration ? { minutes: duration.m } : null),
+  //   ...(s ? { seconds: s } : null),
+  //   // ...('s' in duration ? { seconds: duration.s } : null),
+  // }
+
+  // let dur = Temporal.Duration.from(temporalDuration)
+
+  /**
+   * “non-integer numerical arguments are rounded to the nearest integer, towards zero”
+   * https://tc39.es/proposal-temporal/docs/duration.html#new-Temporal-Duration
+   */
+  // let dur = new Temporal.Duration(0, 0, w, d, h, m, s)
+  let dur = new Temporal.Duration(0, 0, Math.floor(w), Math.floor(d), Math.floor(h), Math.floor(m), Math.floor(s))
+
+  if (convertExcess) {
+    dur = dur.round({ largestUnit: 'weeks', relativeTo: '2019-01-01' })
+  }
+
+  return dur.toString()
+}
+
+/**
+ * @typedef {Object} DurationObject
+ *
+ * @property {number=} y – Number of years
+ * @property {number=} mo – Number of months
+ * @property {number=} w – Number of weeks
+ * @property {number=} d – Number of days
+ * @property {number=} h – Number of hours
+ * @property {number=} m – Number of minutes
+ * @property {number=} s – Number of seconds
+ * @property {number=} ms – Number of milliseconds
+ * @property {number=} mis – Number of microseconds
+ * @property {number=} ns – Number of nanoseconds
+*
+ * The chosen propertie abbreviations follow the spec algorithm:
+ * https://tc39.es/proposal-temporal/#sec-temporal.duration
+ */
diff --git a/src/temporal/index.js b/src/temporal/index.js
new file mode 100644
index 0000000..ca5d669
--- /dev/null
+++ b/src/temporal/index.js
@@ -0,0 +1 @@
+export { duration } from './duration.js'
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
new file mode 100644
index 0000000..86c3974
--- /dev/null
+++ b/tests/temporal/index.test.js
@@ -0,0 +1,302 @@
+import { describe, expect, test } from 'vitest'
+
+import {
+  DateTime,
+  datetime,
+  utc,
+  datetimeTz,
+  tzOffset,
+  daysBetween,
+  weekNumber,
+  setTimeSeparator,
+  setTzSeparator,
+} from '../../src'
+
+import { duration } from '../../src/temporal'
+
+/**
+ * These config methods are currently not exported in the main bundle (though
+ * they are used by `setXxSeparator` functions). There’s no reason to move
+ * them to the main without any new entry in the configuration objects.
+ */
+import { setConfig } from '../../src/config/datetime.js'
+import { setTzConfig } from '../../src/config/tz.js'
+
+const togoIndependanceDay = new Date(1960, 3, 27)
+const date = togoIndependanceDay // alias for the sake of brevity
+
+const firstCerealHarvest = new Date(-23000, 6, 7)
+const foundationOfSyracuse = new Date(-733, 6, 7)
+const birthOfChineseEmpressWuZetian = new Date(624, 1, 17) // https://en.wikipedia.org/wiki/Wu_Zetian
+const january1st = new Date(2021, 0, 1, 10, 10, 12)
+const january11th = new Date(2021, 0, 11, 10, 10, 12)
+const january19th = new Date(2021, 0, 19, 10, 10, 12)
+const december31th2020 = new Date(2020, 11, 31, 10, 10, 12)
+const december31th2020OneMinuteLater = new Date(2020, 11, 31, 10, 11, 12)
+const december31th2021 = new Date(2021, 11, 31, 10, 10, 12)
+const year10k = new Date(10000, 0, 1)
+
+const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
+
+describe.todo('datetime', () => {
+  test('is a function', () => expect(datetime).toBeInstanceOf(Function))
+  test('wrong type', () => expect(() => datetime(123)).toThrow(TypeError))
+
+  test('()', () => expect(datetime()).toBe(datetime((new Date()))))
+
+  test('no precision', () => expect(datetime(date)).toBe('1960-04-27'))
+  test('no precision before the 10th', () => expect(datetime(january1st)).toBe('2021-01-01'))
+
+  test('day', () => expect(datetime(date, 'day')).toBe('1960-04-27'))
+  test('year', () => expect(datetime(date, 'year')).toBe('1960'))
+
+  test('3 digits year before 0', () => expect(datetime(foundationOfSyracuse, 'year')).toBe('-0733'))
+  test('3 digits year', () => expect(datetime(birthOfChineseEmpressWuZetian, 'year')).toBe('0624'))
+  test('5 digits year before 0', () => expect(datetime(firstCerealHarvest, 'year')).toBe('-23000'))
+  test('5 digits year after 9999', () => expect(datetime(year10k, 'year')).toBe('10000'))
+
+  test('month', () => expect(datetime(date, 'month')).toBe('1960-04'))
+  test('yearless', () => expect(datetime(date, 'yearless')).toBe('04-27'))
+  test('yearless and year before 0', () => expect(datetime(foundationOfSyracuse, 'yearless')).toBe('07-07'))
+  test('yearless and 3 digits year', () => expect(datetime(birthOfChineseEmpressWuZetian, 'yearless')).toBe('02-17'))
+
+  test('time', () => expect(datetime(date, 'time')).toBe('00:00'))
+  test('second', () => expect(datetime(date, 'second')).toBe('00:00:00'))
+  test('ms', () => expect(datetime(date, 'ms')).toBe('00:00:00.000'))
+
+  test('datetime', () => expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00'))
+  test('datetime second', () => expect(datetime(date, 'datetime second')).toBe('1960-04-27T00:00:00'))
+  test('datetime ms', () => expect(datetime(date, 'datetime ms')).toBe('1960-04-27T00:00:00.000'))
+
+  test('week on 1960-04-27', () => expect(datetime(date, 'week')).toBe('1960-W17'))
+  test('week on 2021-01-01', () => expect(datetime(january1st, 'week')).toBe('2021-W53'))
+  test('week on 2021-01-11', () => expect(datetime(january11th, 'week')).toBe('2021-W02'))
+  test('week on 2021-01-19', () => expect(datetime(january19th, 'week')).toBe('2021-W03'))
+  test('week on 2020-12-31', () => expect(datetime(december31th2020, 'week')).toBe('2020-W53'))
+  test('week on 2021-12-31', () => expect(datetime(december31th2021, 'week')).toBe('2021-W52'))
+
+  // These ones can’t be tested providing an exact value as the output depends on client timezone.
+
+  test('time utc', () => expect(datetime(date, 'time utc')).toBe(date.toJSON().substr(11, 5) + 'Z'))
+  test('second utc', () => expect(datetime(date, 'second utc')).toBe(date.toJSON().substr(11, 8) + 'Z'))
+  test('ms utc', () => expect(datetime(date, 'ms utc')).toBe(date.toJSON().substr(11, 12) + 'Z'))
+
+  test('datetime utc', () => expect(datetime(date, 'datetime utc')).toBe(date.toJSON().substr(0, 16) + 'Z'))
+  test('datetime second utc', () => expect(datetime(date, 'datetime second utc')).toBe(date.toJSON().substr(0, 19) + 'Z'))
+  test('datetime ms utc', () => expect(datetime(date, 'datetime ms utc')).toBe(date.toJSON()))
+
+  test('unsupported precision', () => expect(datetime(date, 'n00t')).toBe('1960-04-27'))
+})
+
+describe.todo('utc', () => {
+  test('is a function', () => expect(utc).toBeInstanceOf(Function))
+  test('wrong type', () => expect(() => utc(123)).toThrow(TypeError))
+  test('()', () => expect(utc()).toBe(utc((new Date()))))
+
+  // These ones can’t be tested providing an exact value as the output depends on client timezone.
+  test('no precision', () => expect(utc(date)).toBe(date.toJSON().substr(0, 16) + 'Z'))
+  test('time', () => expect(utc(date, 'time')).toBe(date.toJSON().substr(11, 5) + 'Z'))
+  test('second', () => expect(utc(date, 'second')).toBe(date.toJSON().substr(11, 8) + 'Z'))
+  test('ms', () => expect(utc(date, 'ms')).toBe(date.toJSON().substr(11, 12) + 'Z'))
+  test('datetime', () => expect(utc(date, 'datetime')).toBe(date.toJSON().substr(0, 16) + 'Z'))
+  test('datetime second', () => expect(utc(date, 'datetime second')).toBe(date.toJSON().substr(0, 19) + 'Z'))
+  test('datetime ms', () => expect(utc(date, 'datetime ms')).toBe(date.toJSON()))
+
+  test('unsupported precision', () => expect(utc(date, 'n00t')).toBe('1960-04-27'))
+})
+
+describe.skip('duration', () => {
+  const durationObject = { w: 3, d: 5, h: 10, m: 43, s: 2.61 }
+  const durationWithTooHighValues = { w: 3, d: 19, h: 36, m: 53, s: 175.3 }
+  const durationInHours = { h: 17 }
+  const durationInDays = { d: 43 }
+
+  test('is a function', () => expect(duration).toBeInstanceOf(Function))
+  test('()', () => expect(() => duration(null)).toThrow())
+  test('()', () => expect(duration()).toBe('PT0S'))
+  test('empty object {}', () => expect(duration({})).toBe('PT0S'))
+  test('empty object {}', () => expect(duration({}, false)).toBe('PT0S'))
+
+  test('complete object', () => expect(duration(durationObject)).toBe('P3W5DT10H43M2.61S'))
+  test('complete object with too high values', () => expect(duration(durationWithTooHighValues)).toBe('P5W6DT12H55M55.3S'))
+  test('hours only', () => expect(duration(durationInHours)).toBe('PT17H'))
+  test('days only', () => expect(duration(durationInDays)).toBe('P6W1D'))
+
+  test('complete object without converting the excess', () => expect(duration(durationObject, false)).toBe('P3W5DT10H43M2.61S'))
+  test('complete object with too high values without converting the excess', () => expect(duration(durationWithTooHighValues, false)).toBe('P3W19DT36H53M175.3S'))
+  test('hours only without converting the excess', () => expect(duration(durationInHours, false)).toBe('PT17H'))
+  test('days only without converting the excess', () => expect(duration(durationInDays, false)).toBe('P43D'))
+})
+
+describe.todo('tzOffset', () => {
+  test('is a function', () => expect(tzOffset).toBeInstanceOf(Function))
+  test('0', () => expect(tzOffset(0)).toBe('Z'))
+  test('-3', () => expect(tzOffset(-3)).toBe('-03:00'))
+  test('0, -30', () => expect(tzOffset(0, -30)).toBe('-00:30'))
+  test('0, 30', () => expect(tzOffset(0, 30)).toBe('+00:30'))
+  test('1', () => expect(tzOffset(1)).toBe('+01:00'))
+  test('-4.5', () => expect(tzOffset(-4.5)).toBe('-04:30'))
+  test('4, 30', () => expect(tzOffset(4, 30)).toBe('+04:30'))
+  test('12, 45', () => expect(tzOffset(12, 45)).toBe('+12:45'))
+  test('12.75', () => expect(tzOffset(12.75)).toBe('+12:45'))
+  test('-8', () => expect(tzOffset(-8)).toBe('-08:00'))
+  test('2, -200', () => expect(tzOffset(2, -200)).toBe('-01:20'))
+  test('-35', () => expect(tzOffset(-35)).toBe('-11:00'))
+  test('62.75', () => expect(tzOffset(62.75)).toBe('+14:45'))
+  test('-12, 0, true', () => expect(tzOffset(-12, 0, true)).toBe('-12:00'))
+  test('-12, -20, true', () => expect(tzOffset(-12, -20, true)).toBe('+11:40'))
+  test('-13, -20, true', () => expect(tzOffset(-13, -20, true)).toBe('+10:40'))
+  test('14, 45, true', () => expect(tzOffset(14, 45, true)).toBe('-09:15'))
+  test('62.75, 0, true', () => expect(tzOffset(62.75, 0, true)).toBe('-09:15'))
+  test('non number', () => expect(() => tzOffset('Z')).toThrow(TypeError))
+
+  // This one can’t be tested providing an exact value as the output depends on client timezone and daylight time saving.
+  test('()', () => expect(tzOffset()).toBe(tzOffset(0, tzOffsetInMinutes)))
+})
+
+describe.todo('datetimeTz', () => {
+  test('is a function', () => expect(datetimeTz).toBeInstanceOf(Function))
+  test('wrong type', () => expect(() => datetimeTz(123)).toThrow(TypeError))
+
+  test('()', () => expect(datetimeTz()).toBe(datetimeTz((new Date()))))
+
+  test('no precision', () => expect(datetimeTz(date)).toBe('1960-04-27T00:00' + tzOffset(0, tzOffsetInMinutes)))
+  test('no offset', () => expect(datetimeTz(date, 'time')).toBe('00:00' + tzOffset(0, tzOffsetInMinutes)))
+
+  test('time 0', () => expect(datetimeTz(date, 'time', 0)).toBe('00:00Z'))
+  test('time +4', () => expect(datetimeTz(date, 'time', 4)).toBe('00:00+04:00'))
+  test('second -3', () => expect(datetimeTz(date, 'second', -3)).toBe('00:00:00-03:00'))
+  test('ms +3.5', () => expect(datetimeTz(date, 'ms', 3.5)).toBe('00:00:00.000+03:30'))
+
+  test('datetime +12:45', () => expect(datetimeTz(date, 'datetime', 12, 45)).toBe('1960-04-27T00:00+12:45'))
+  test('datetime +17, 30, true', () => expect(datetimeTz(date, 'datetime', 17, 30, true)).toBe('1960-04-27T00:00-06:30'))
+  test('datetime second -6', () => expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00'))
+  test('datetime ms +1', () => expect(datetimeTz(date, 'datetime ms', 1)).toBe('1960-04-27T00:00:00.000+01:00'))
+
+  // These ones can’t be tested providing an exact value as the output depends on client timezone.
+
+  test('time utc', () => expect(datetimeTz(date, 'time utc')).toBe(date.toJSON().substr(11, 5) + 'Z'))
+  test('second utc', () => expect(datetimeTz(date, 'second utc')).toBe(date.toJSON().substr(11, 8) + 'Z'))
+  test('ms utc', () => expect(datetimeTz(date, 'ms utc')).toBe(date.toJSON().substr(11, 12) + 'Z'))
+
+  test('datetime utc', () => expect(datetimeTz(date, 'datetime utc')).toBe(date.toJSON().substr(0, 16) + 'Z'))
+  test('datetime second utc', () => expect(datetimeTz(date, 'datetime second utc')).toBe(date.toJSON().substr(0, 19) + 'Z'))
+  test('datetime ms utc', () => expect(datetimeTz(date, 'datetime ms utc')).toBe(date.toJSON()))
+})
+
+describe.todo('setTzSeparator', () => {
+  test('is a function', () => expect(setTzSeparator).toBeInstanceOf(Function))
+
+  test('no timezone separator', () => {
+    setTzSeparator()
+    expect(tzOffset(3)).toBe('+0300')
+  })
+
+  test('empty string timezone separator', () => {
+    setTzSeparator('')
+    expect(tzOffset(3)).toBe('+0300')
+  })
+
+  test(': as timezone separator', () => {
+    setTzSeparator(':')
+    expect(tzOffset(3)).toBe('+03:00')
+  })
+
+  test('invalid separator', () => expect(() => setTzSeparator(42)).toThrow(Error))
+
+  test('empty string timezone separator with datetimeTz', () => {
+    setTzSeparator('')
+    expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-0600')
+  })
+})
+
+describe.todo('setTzConfig', () => {
+  test('is a function', () => expect(setTzConfig).toBeInstanceOf(Function))
+
+  test('empty string timezone separator using setTzConfig', () => {
+    setTzConfig({ separator: '' })
+    expect(tzOffset(3)).toBe('+0300')
+  })
+
+  test(': as timezone separator using setTzConfig', () => {
+    setTzConfig({ separator: ':' })
+    expect(tzOffset(3)).toBe('+03:00')
+  })
+
+  test('invalid separator using setTzConfig', () => expect(() => setTzConfig({ separator: 42 })).toThrow(Error))
+
+  test(': as timezone separator with datetimeTz', () => {
+    setTzConfig({ separator: ':' })
+    expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00')
+  })
+})
+
+describe.todo('weekNumber', () => {
+  test('is a function', () => expect(weekNumber).toBeInstanceOf(Function))
+  test('1960-04-27', () => expect(weekNumber(date)).toBe(17))
+  test('2021-01-01', () => expect(weekNumber(january1st)).toBe(53))
+  test('2021-01-11', () => expect(weekNumber(january11th)).toBe(2))
+  test('2020-12-31', () => expect(weekNumber(december31th2020)).toBe(53))
+  test('2021-12-31', () => expect(weekNumber(december31th2021)).toBe(52))
+})
+
+describe.todo('daysBetween', () => {
+  test('is a function', () => expect(daysBetween).toBeInstanceOf(Function))
+  test('1/1 and 11/1', () => expect(daysBetween(january1st, january11th)).toBe(10))
+  test('11/1 and 1/1', () => expect(daysBetween(january11th, january1st)).toBe(-10))
+  test('same day, different time', () => expect(daysBetween(december31th2020, december31th2020OneMinuteLater)).toBe(0))
+})
+
+const summer = new DateTime(2021, 5, 21)
+const twoWeeksAfterSummer = new DateTime(2021, 6, 5)
+
+describe.todo('DateTime class', () => {
+  test('extends Date', () => expect(summer).toBeInstanceOf(Date))
+  test('.getWeek', () => expect(summer.getWeek()).toBe(25))
+  test(".to('day')", () => expect(summer.to('day')).toBe('2021-06-21'))
+  test('.setWeek', () => expect(summer.setWeek(27)).toBe(twoWeeksAfterSummer.getTime()))
+  test(".to('month')", () => expect(twoWeeksAfterSummer.to('month')).toBe('2021-07'))
+  test('weeks is changed when day changes', () => {
+    summer.setDate(summer.getDate() + 14)
+    return expect(summer.getWeek()).toBe(29)
+  })
+})
+
+// These tests are at the end as they change the widely-used separator config.
+
+describe.todo('setTimeSeparator', () => {
+  test('is a function', () => expect(setTimeSeparator).toBeInstanceOf(Function))
+
+  test('no time separator', () => {
+    setTimeSeparator()
+    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
+  })
+
+  test('T as time separator', () => {
+    setTimeSeparator('T')
+    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
+  })
+
+  test('space as time separator', () => {
+    setTimeSeparator(' ')
+    expect(datetime(date, 'datetime')).toBe('1960-04-27 00:00')
+  })
+
+  test('invalid separator', () => expect(() => setTimeSeparator(42)).toThrow(Error))
+})
+
+describe.todo('setConfig', () => {
+  test('is a function', () => expect(setConfig).toBeInstanceOf(Function))
+
+  test('T as time separator using setConfig', () => {
+    setConfig({ separator: 'T' })
+    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
+  })
+
+  test('space as time separator using setConfig', () => {
+    setConfig({ separator: ' ' })
+    expect(datetime(date, 'datetime')).toBe('1960-04-27 00:00')
+  })
+
+  test('invalid separator using setConfig', () => expect(() => setConfig({ separator: 42 })).toThrow(Error))
+})

From ddc9c0fd6f23e2b9f9c393cf0255a65a1c732271 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 14 Oct 2023 03:28:11 +0200
Subject: [PATCH 03/39] Add `weekNumber` using the Temporal API

---
 src/temporal/utils/date.js   | 21 +++++++++++++++++++++
 tests/temporal/index.test.js |  4 ++--
 2 files changed, 23 insertions(+), 2 deletions(-)
 create mode 100644 src/temporal/utils/date.js

diff --git a/src/temporal/utils/date.js b/src/temporal/utils/date.js
new file mode 100644
index 0000000..5cb8274
--- /dev/null
+++ b/src/temporal/utils/date.js
@@ -0,0 +1,21 @@
+/**
+ * @todo
+ * - weekNumber could accept more Temporal type, maybe
+ * - make sur to understand zone datetime (https://tc39.es/proposal-temporal/docs/zoneddatetime.html#weekOfYear)
+ */
+
+import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+Date.prototype.toTemporalInstant = toTemporalInstant
+
+/**
+ * Get the week number (`1`–`53`) of a date according to local time, as defined
+ * by the WHATWG and the ISO-8601 specs:
+ *
+ * - a week starts on Monday (https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#concept-week);
+ * - the first week of the year includes a Thursday;
+ * - week numbers go from 1 to 53 (https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#week-number-of-the-last-day).
+ *
+ * @param {Date} date
+ * @returns {number}
+ */
+export const weekNumber = date => date.toTemporalInstant().toZonedDateTimeISO('UTC').weekOfYear
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index 86c3974..71b8a53 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -7,7 +7,6 @@ import {
   datetimeTz,
   tzOffset,
   daysBetween,
-  weekNumber,
   setTimeSeparator,
   setTzSeparator,
 } from '../../src'
@@ -21,6 +20,7 @@ import { duration } from '../../src/temporal'
  */
 import { setConfig } from '../../src/config/datetime.js'
 import { setTzConfig } from '../../src/config/tz.js'
+import { weekNumber } from '../../src/temporal/utils/date'
 
 const togoIndependanceDay = new Date(1960, 3, 27)
 const date = togoIndependanceDay // alias for the sake of brevity
@@ -231,7 +231,7 @@ describe.todo('setTzConfig', () => {
   })
 })
 
-describe.todo('weekNumber', () => {
+describe('weekNumber', () => {
   test('is a function', () => expect(weekNumber).toBeInstanceOf(Function))
   test('1960-04-27', () => expect(weekNumber(date)).toBe(17))
   test('2021-01-01', () => expect(weekNumber(january1st)).toBe(53))

From 835282b1a37badd0aa10fecd661af8d38e8e9c0d Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 14 Oct 2023 19:40:17 +0200
Subject: [PATCH 04/39] Add `daysBetween` using the Temporal API

---
 src/temporal/utils/date.js     | 19 ++++++++++++++-----
 src/temporal/utils/temporal.js |  3 +++
 tests/temporal/index.test.js   |  5 ++---
 3 files changed, 19 insertions(+), 8 deletions(-)
 create mode 100644 src/temporal/utils/temporal.js

diff --git a/src/temporal/utils/date.js b/src/temporal/utils/date.js
index 5cb8274..ee4fb43 100644
--- a/src/temporal/utils/date.js
+++ b/src/temporal/utils/date.js
@@ -1,11 +1,19 @@
 /**
  * @todo
- * - weekNumber could accept more Temporal type, maybe
- * - make sur to understand zone datetime (https://tc39.es/proposal-temporal/docs/zoneddatetime.html#weekOfYear)
+ * - `weekNumber` and `daysBetween` could accept Temporal objects as parameters
+ * - make sur to understand zoned datetime (https://tc39.es/proposal-temporal/docs/zoneddatetime.html#weekOfYear)
  */
 
-import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
-Date.prototype.toTemporalInstant = toTemporalInstant
+import { dateToPlainDate } from './temporal'
+
+/**
+ * Calculate the difference between 2 dates in days, discarding the time of day.
+ *
+ * @param {Date} date The oldest of the two dates.
+ * @param {Date} furtherDate Another date, greater than the first one.
+ * @returns {number}
+ */
+export const daysBetween = (date, furtherDate) => dateToPlainDate(date).until(dateToPlainDate(furtherDate)).days
 
 /**
  * Get the week number (`1`–`53`) of a date according to local time, as defined
@@ -18,4 +26,5 @@ Date.prototype.toTemporalInstant = toTemporalInstant
  * @param {Date} date
  * @returns {number}
  */
-export const weekNumber = date => date.toTemporalInstant().toZonedDateTimeISO('UTC').weekOfYear
+export const weekNumber = date => dateToPlainDate(date).weekOfYear
+// export const weekNumber = date => date.toTemporalInstant().toZonedDateTimeISO('UTC').weekOfYear
diff --git a/src/temporal/utils/temporal.js b/src/temporal/utils/temporal.js
new file mode 100644
index 0000000..c7617dc
--- /dev/null
+++ b/src/temporal/utils/temporal.js
@@ -0,0 +1,3 @@
+import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+
+export const dateToPlainDate = d => new Temporal.PlainDate(d.getFullYear(), d.getMonth() + 1, d.getDate())
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index 71b8a53..a4b059d 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -6,12 +6,12 @@ import {
   utc,
   datetimeTz,
   tzOffset,
-  daysBetween,
   setTimeSeparator,
   setTzSeparator,
 } from '../../src'
 
 import { duration } from '../../src/temporal'
+import { daysBetween, weekNumber } from '../../src/temporal/utils/date'
 
 /**
  * These config methods are currently not exported in the main bundle (though
@@ -20,7 +20,6 @@ import { duration } from '../../src/temporal'
  */
 import { setConfig } from '../../src/config/datetime.js'
 import { setTzConfig } from '../../src/config/tz.js'
-import { weekNumber } from '../../src/temporal/utils/date'
 
 const togoIndependanceDay = new Date(1960, 3, 27)
 const date = togoIndependanceDay // alias for the sake of brevity
@@ -240,7 +239,7 @@ describe('weekNumber', () => {
   test('2021-12-31', () => expect(weekNumber(december31th2021)).toBe(52))
 })
 
-describe.todo('daysBetween', () => {
+describe('daysBetween', () => {
   test('is a function', () => expect(daysBetween).toBeInstanceOf(Function))
   test('1/1 and 11/1', () => expect(daysBetween(january1st, january11th)).toBe(10))
   test('11/1 and 1/1', () => expect(daysBetween(january11th, january1st)).toBe(-10))

From 874200abc89bc08e1e6c55c7e68be8f007bf6bd2 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Tue, 17 Oct 2023 06:16:30 +0200
Subject: [PATCH 05/39] Transfer decimals parameters in Temporal duration

Constructor does not accept decimals.
---
 src/temporal/duration.js | 39 +++++++++++++++++++++++++++++++++++----
 1 file changed, 35 insertions(+), 4 deletions(-)

diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index c6abb72..d847c50 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -8,6 +8,7 @@
  */
 
 import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+import { round } from '../utils/math'
 
 // Date.prototype.toTemporalInstant = toTemporalInstant
 
@@ -26,9 +27,40 @@ import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
 export function duration(duration = {}, convertExcess = true) {
 
   // Set default values for missing keys.
-  let { w = 0, d = 0, h = 0, m = 0, s = 0 } = duration
+  let { w = 0, d = 0, h = 0, m = 0, s = 0, ms = 0 } = duration
 
-  // At least one duration must be different than zero.
+  // Transfer decimals, not accepted by Temporal.Duration polyfill.
+
+  if (!Number.isInteger(w)) {
+    d += w / 7
+    w = Math.floor(w)
+  }
+
+  if (!Number.isInteger(d)) {
+    h += d / 24
+    d = Math.floor(d)
+  }
+
+  if (!Number.isInteger(h)) {
+    m += h / 24
+    h = Math.floor(h)
+  }
+
+  if (!Number.isInteger(m)) {
+    s += m / 60
+    m = Math.floor(m)
+  }
+
+  if (!Number.isInteger(s)) {
+    ms += round(s % 1 * 1000) // rounding avoid precision issues
+    s = Math.floor(s)
+  }
+
+
+  /**
+   * At least one duration must be different than zero.
+   * @todo Check if needed once done.
+   */
   // if (![w, d, h, m, s].some(value => value)) {
   //   return 'PT0S'
   // }
@@ -55,8 +87,7 @@ export function duration(duration = {}, convertExcess = true) {
    * “non-integer numerical arguments are rounded to the nearest integer, towards zero”
    * https://tc39.es/proposal-temporal/docs/duration.html#new-Temporal-Duration
    */
-  // let dur = new Temporal.Duration(0, 0, w, d, h, m, s)
-  let dur = new Temporal.Duration(0, 0, Math.floor(w), Math.floor(d), Math.floor(h), Math.floor(m), Math.floor(s))
+  let dur = new Temporal.Duration(0, 0, w, d, h, m, s, ms)
 
   if (convertExcess) {
     dur = dur.round({ largestUnit: 'weeks', relativeTo: '2019-01-01' })

From 4dbe584926a9aea7417bf2a0e416ccf6f6796fe4 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Tue, 17 Oct 2023 13:01:53 +0200
Subject: [PATCH 06/39] Improve transfer of decimals in `Temporal.Duration`

---
 src/temporal/duration.js     | 79 ++++++++++++------------------------
 tests/temporal/index.test.js |  2 +
 2 files changed, 28 insertions(+), 53 deletions(-)

diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index d847c50..6204335 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -1,8 +1,5 @@
 /**
  * @todo
- * Continue the work once the following issue is clarified:
- * https://github.com/tc39/proposal-temporal/issues/2711:
- * - check decimal parameters
  * - check balancing (https://tc39.es/proposal-temporal/docs/balancing.html)
  * - add support for sub-second units (ms, mis, ns)
  */
@@ -26,67 +23,43 @@ import { round } from '../utils/math'
  */
 export function duration(duration = {}, convertExcess = true) {
 
-  // Set default values for missing keys.
-  let { w = 0, d = 0, h = 0, m = 0, s = 0, ms = 0 } = duration
-
-  // Transfer decimals, not accepted by Temporal.Duration polyfill.
-
-  if (!Number.isInteger(w)) {
-    d += w / 7
-    w = Math.floor(w)
+  if (!duration) {
+    throw new Error('No duration provided.')
   }
 
-  if (!Number.isInteger(d)) {
-    h += d / 24
-    d = Math.floor(d)
-  }
+  // Set default values for missing keys.
 
-  if (!Number.isInteger(h)) {
-    m += h / 24
-    h = Math.floor(h)
-  }
+  duration = Object.assign({ w: 0, d: 0, h: 0, m: 0, s: 0, ms: 0 }, duration)
 
-  if (!Number.isInteger(m)) {
-    s += m / 60
-    m = Math.floor(m)
+  /**
+   * At least one duration must be different than zero.
+   * Not needed with the Temporal API, only here for
+   * early return.
+   */
+  if (!Object.values(duration).some(value => value)) {
+    return 'PT0S'
   }
 
-  if (!Number.isInteger(s)) {
-    ms += round(s % 1 * 1000) // rounding avoid precision issues
-    s = Math.floor(s)
+  // Transfer decimals as they aren’t accepted by `Temporal.Duration` constructor.
+
+  const processDecimals = (unit, smallerUnit, howManySmallInUnit) => {
+    if (!Number.isInteger(duration[unit])) {
+      duration[smallerUnit] += duration[unit] / howManySmallInUnit
+      duration[unit] = Math.floor(duration[unit])
+    }
   }
 
+  processDecimals('w', 'd', 7)
+  processDecimals('d', 'h', 24)
+  processDecimals('h', 'm', 60)
+  processDecimals('m', 's', 60)
+  processDecimals('s', 'ms', 1) // last item of the chain (`ms`) is a special use case, we process it in the next line
+  duration.ms = round((duration.ms - duration.s) * 1000) //
 
-  /**
-   * At least one duration must be different than zero.
-   * @todo Check if needed once done.
-   */
-  // if (![w, d, h, m, s].some(value => value)) {
-  //   return 'PT0S'
-  // }
+  let { w = 0, d = 0, h = 0, m = 0, s = 0, ms = 0 } = duration
 
-  /**
-   * @var {import('@js-temporal/polyfill').DurationLike} temporalDuration
-   */
-  // const temporalDuration = {
-  //   ...(w ? { weeks: w } : null),
-  //   // ...('w' in duration ? { weeks: duration.w } : null),
-  //   ...(d ? { days: d } : null),
-  //   // ...('d' in duration ? { days: duration.d } : null),
-  //   ...(h ? { hours: h } : null),
-  //   // ...('h' in duration ? { hours: duration.h } : null),
-  //   ...(m ? { minutes: m } : null),
-  //   // ...('m' in duration ? { minutes: duration.m } : null),
-  //   ...(s ? { seconds: s } : null),
-  //   // ...('s' in duration ? { seconds: duration.s } : null),
-  // }
-
-  // let dur = Temporal.Duration.from(temporalDuration)
+  // Create a Duration object
 
-  /**
-   * “non-integer numerical arguments are rounded to the nearest integer, towards zero”
-   * https://tc39.es/proposal-temporal/docs/duration.html#new-Temporal-Duration
-   */
   let dur = new Temporal.Duration(0, 0, w, d, h, m, s, ms)
 
   if (convertExcess) {
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index a4b059d..32eb8a4 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -107,6 +107,7 @@ describe.todo('utc', () => {
 describe.skip('duration', () => {
   const durationObject = { w: 3, d: 5, h: 10, m: 43, s: 2.61 }
   const durationWithTooHighValues = { w: 3, d: 19, h: 36, m: 53, s: 175.3 }
+  const durationWithDecimal = { w: 3, d: 22, h: 48, m: 53, s: 175.3 }
   const durationInHours = { h: 17 }
   const durationInDays = { d: 43 }
 
@@ -118,6 +119,7 @@ describe.skip('duration', () => {
 
   test('complete object', () => expect(duration(durationObject)).toBe('P3W5DT10H43M2.61S'))
   test('complete object with too high values', () => expect(duration(durationWithTooHighValues)).toBe('P5W6DT12H55M55.3S'))
+  test('decimals', () => expect(duration(durationWithDecimal)).toBe('P6W3DT55M55.3S'))
   test('hours only', () => expect(duration(durationInHours)).toBe('PT17H'))
   test('days only', () => expect(duration(durationInDays)).toBe('P6W1D'))
 

From 8fb0b57d40c9265936765777ab1e9ecaf6757704 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Tue, 17 Oct 2023 19:04:53 +0200
Subject: [PATCH 07/39] Move Temporal API polyfill to peer dependencies

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1b3548b..f69c3dc 100644
--- a/package.json
+++ b/package.json
@@ -66,7 +66,7 @@
       "has": "npm:@nolyfill/has@latest"
     }
   },
-  "dependencies": {
+  "peerDependencies": {
     "@js-temporal/polyfill": "^0.4.4"
   }
 }

From 56a0b61d6f22f98d332300a01ad230aee6b23a31 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Tue, 17 Oct 2023 19:06:19 +0200
Subject: [PATCH 08/39] Add `size-limit` section for `Temporal` implementation

---
 package.json | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/package.json b/package.json
index f69c3dc..831f075 100644
--- a/package.json
+++ b/package.json
@@ -25,6 +25,10 @@
     {
       "path": "src/index.js",
       "brotli": true
+    },
+    {
+      "path": "src/temporal/index.js",
+      "brotli": true
     }
   ],
   "files": [

From f89f1a851ff831902d7e9f149685d6352771984e Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Thu, 19 Oct 2023 20:45:42 +0200
Subject: [PATCH 09/39] Run Temporal duration tests

---
 tests/temporal/index.test.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index 32eb8a4..d19d6ef 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -104,7 +104,7 @@ describe.todo('utc', () => {
   test('unsupported precision', () => expect(utc(date, 'n00t')).toBe('1960-04-27'))
 })
 
-describe.skip('duration', () => {
+describe('duration', () => {
   const durationObject = { w: 3, d: 5, h: 10, m: 43, s: 2.61 }
   const durationWithTooHighValues = { w: 3, d: 19, h: 36, m: 53, s: 175.3 }
   const durationWithDecimal = { w: 3, d: 22, h: 48, m: 53, s: 175.3 }

From a771a0ea2883853e31da74729a43c177fe72860c Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 25 Nov 2023 05:45:48 +0100
Subject: [PATCH 10/39] Add `datetime` using the Temporal API

---
 src/temporal/datetime.js     | 89 ++++++++++++++++++++++++++++++++++++
 src/temporal/index.js        |  1 +
 tests/temporal/index.test.js |  5 +-
 3 files changed, 92 insertions(+), 3 deletions(-)
 create mode 100644 src/temporal/datetime.js

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
new file mode 100644
index 0000000..7baf2c5
--- /dev/null
+++ b/src/temporal/datetime.js
@@ -0,0 +1,89 @@
+import { weekNumber } from './utils/date.js'
+import { p } from '../utils/string.js'
+import { tzOffset } from '../timezone.js'
+import { config } from '../config/datetime'
+import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+
+Date.prototype.toTemporalInstant = toTemporalInstant
+
+/**
+ * Create `datetime="2021-12-02"` attribute for `<time>`.
+ *
+ * Support all format from the spec.
+ * https://html.spec.whatwg.org/multipage/text-level-semantics.html#attr-time-datetime
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTimeElement/datetime
+ *
+ * See also: https://www.brucelawson.co.uk/2012/best-of-time/
+ *
+ * @param {Date=} date
+ * @param {Precision=} precision
+ * @returns {string}
+ */
+export function datetime(date = new Date(), precision = 'day') {
+  if (!(date instanceof Date)) {
+    throw new TypeError('Input date should be of type `Date`')
+  }
+
+  const instant = date.toTemporalInstant();
+  const zoned = instant.toZonedDateTimeISO(Temporal.Now.timeZoneId())
+
+  const yearISO = y => {
+
+    // Year 0 doesn’t exists in real life, but does in the ISO-8601 spec.
+    const sign = y < 0 ? '-' : '' // no sign if year is not negative
+
+    // Remove sign (stored separately, see previous line).
+    y = Math.abs(y)
+
+    let bigYearDigits = ''
+
+    // Cut last 4 digits of the year from the others to ease further computation.
+    if (y > 9999) {
+      [bigYearDigits, y] = (y / 10000).toFixed(4).split('.')
+    }
+
+    return sign + bigYearDigits + y.toString().padStart(4, 0)
+  }
+
+  // const iso = date.toISOString();
+
+  const temporalFormat = {
+    year: () => yearISO(Temporal.PlainYearMonth.from(zoned).year), // 1960
+    // year: () => date.getFullYear(), // 1960
+    month: () => Temporal.PlainYearMonth.from(zoned), // 1960-04
+    day: () => Temporal.PlainDate.from(zoned), // 1960-04-27
+
+    week: () => date.getFullYear() + '-W' + p(weekNumber(date)), // 1960-W17
+    yearless: () => Temporal.PlainMonthDay.from(zoned), // 04-27
+
+    time: () => Temporal.PlainTime.from(zoned).toString({ smallestUnit: 'minutes' }), // 00:00
+    second: () => Temporal.PlainTime.from(zoned), // 00:00:00
+    ms: () => Temporal.PlainTime.from(zoned).toString({ smallestUnit: 'milliseconds' }), // 00:00:00.123
+
+    datetime: () => Temporal.PlainDateTime.from(zoned).toString({ smallestUnit: 'minutes' }), // 1960-04-27T00:00
+    'datetime second': () => Temporal.PlainDateTime.from(zoned), // 1960-04-27T00:00:00
+    'datetime ms': () => Temporal.PlainDateTime.from(zoned).toString({ smallestUnit: 'milliseconds' }), // 1960-04-27T00:00:00.123
+
+    'datetime utc': () => instant.toString({ smallestUnit: 'minute' }), // 1960-04-26T23:00Z
+    'datetime second utc': () => instant, // 1960-04-26T23:00:00Z
+    'datetime ms utc': () => instant.toString({ fractionalSecondDigits: 3 }), // 1960-04-26T23:00:00.000Z
+
+    'time utc': () =>
+      instant.toString({ smallestUnit: 'minute' }).substr(11, 6), // 23:00Z
+    'second utc': () => instant.toString().substr(11, 9), // 23:00:00Z
+    'ms utc': () =>
+      instant.toString({ fractionalSecondDigits: 3 }).substr(11, 13), // 23:00:00.000Z
+  }
+
+  return (temporalFormat[precision] || temporalFormat.day)().toString().replace('T', config.separator)
+}
+
+/**
+ * Supported precision keywords.
+ *
+ * @typedef { 'day' | 'year' | 'yearless' | 'month' | 'week' |
+ *            'time' | 'second' | 'ms' |
+ *            'time utc' | 'second utc' | 'ms utc' |
+ *            'datetime' | 'datetime second' | 'datetime ms' |
+ *            'datetime utc' | 'datetime second utc' | 'datetime ms utc' } Precision
+ */
diff --git a/src/temporal/index.js b/src/temporal/index.js
index ca5d669..df931b3 100644
--- a/src/temporal/index.js
+++ b/src/temporal/index.js
@@ -1 +1,2 @@
 export { duration } from './duration.js'
+export { datetime } from './datetime.js'
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index d19d6ef..04736ad 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -2,7 +2,6 @@ import { describe, expect, test } from 'vitest'
 
 import {
   DateTime,
-  datetime,
   utc,
   datetimeTz,
   tzOffset,
@@ -10,7 +9,7 @@ import {
   setTzSeparator,
 } from '../../src'
 
-import { duration } from '../../src/temporal'
+import { duration, datetime } from '../../src/temporal'
 import { daysBetween, weekNumber } from '../../src/temporal/utils/date'
 
 /**
@@ -37,7 +36,7 @@ const year10k = new Date(10000, 0, 1)
 
 const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
 
-describe.todo('datetime', () => {
+describe('datetime', () => {
   test('is a function', () => expect(datetime).toBeInstanceOf(Function))
   test('wrong type', () => expect(() => datetime(123)).toThrow(TypeError))
 

From 4f7e1badd6e2479fc80008743ff349786ac16a9d Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 25 Nov 2023 05:47:50 +0100
Subject: [PATCH 11/39] Add `utc` using the Temporal API

---
 src/temporal/datetime.js     | 15 +++++++++++++++
 src/temporal/index.js        |  2 +-
 tests/temporal/index.test.js |  5 ++---
 3 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index 7baf2c5..ae91fde 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -78,6 +78,21 @@ export function datetime(date = new Date(), precision = 'day') {
   return (temporalFormat[precision] || temporalFormat.day)().toString().replace('T', config.separator)
 }
 
+/**
+ * Shortcut for `datetime` with UTC output.
+ *
+ * For exemple, these two are the same:
+ * - `datetime(someDate, 'somePrecision utc')`
+ * - `utc(someDate, 'somePrecision')`
+ *
+ *
+ * @param {Date=} date
+ * @param {'datetime'|'datetime second'|'datetime ms'|'time'|'second'|'ms'} precision
+ * @returns {string}
+ */
+export const utc = (date = new Date(), precision = 'datetime') =>
+  datetime(date, `${precision} utc`)
+
 /**
  * Supported precision keywords.
  *
diff --git a/src/temporal/index.js b/src/temporal/index.js
index df931b3..c07ba97 100644
--- a/src/temporal/index.js
+++ b/src/temporal/index.js
@@ -1,2 +1,2 @@
 export { duration } from './duration.js'
-export { datetime } from './datetime.js'
+export { datetime, utc } from './datetime.js'
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index 04736ad..065051f 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -2,14 +2,13 @@ import { describe, expect, test } from 'vitest'
 
 import {
   DateTime,
-  utc,
   datetimeTz,
   tzOffset,
   setTimeSeparator,
   setTzSeparator,
 } from '../../src'
 
-import { duration, datetime } from '../../src/temporal'
+import { duration, datetime, utc } from '../../src/temporal'
 import { daysBetween, weekNumber } from '../../src/temporal/utils/date'
 
 /**
@@ -86,7 +85,7 @@ describe('datetime', () => {
   test('unsupported precision', () => expect(datetime(date, 'n00t')).toBe('1960-04-27'))
 })
 
-describe.todo('utc', () => {
+describe('utc', () => {
   test('is a function', () => expect(utc).toBeInstanceOf(Function))
   test('wrong type', () => expect(() => utc(123)).toThrow(TypeError))
   test('()', () => expect(utc()).toBe(utc((new Date()))))

From e769ec1c3d774f9b6c52c2e518a244efe64058f1 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 25 Nov 2023 16:05:38 +0100
Subject: [PATCH 12/39] Add `tzOffset` using the Temporal API

---
 src/temporal/config/datetime.js | 38 +++++++++++++
 src/temporal/config/index.js    |  2 +
 src/temporal/config/tz.js       | 38 +++++++++++++
 src/temporal/index.js           |  1 +
 src/temporal/timezone.js        | 96 +++++++++++++++++++++++++++++++++
 src/temporal/utils/const.js     |  8 +++
 src/temporal/utils/string.js    |  8 +++
 tests/temporal/index.test.js    |  5 +-
 8 files changed, 193 insertions(+), 3 deletions(-)
 create mode 100644 src/temporal/config/datetime.js
 create mode 100644 src/temporal/config/index.js
 create mode 100644 src/temporal/config/tz.js
 create mode 100644 src/temporal/timezone.js
 create mode 100644 src/temporal/utils/const.js
 create mode 100644 src/temporal/utils/string.js

diff --git a/src/temporal/config/datetime.js b/src/temporal/config/datetime.js
new file mode 100644
index 0000000..69d3174
--- /dev/null
+++ b/src/temporal/config/datetime.js
@@ -0,0 +1,38 @@
+/**
+ * @typedef {Object} DateTimeOptions
+ * @property {('T'|' ')=} separator
+ */
+
+/**
+ * @type DateTimeOptions
+ */
+export const config = {
+  separator: 'T',
+}
+
+/**
+ * Set datetime related configuration
+ *
+ * @param {DateTimeOptions} options
+ * @returns {DateTimeOptions}
+ */
+export const setConfig = options => {
+
+  /**
+   * The separator can only be 'T' or ' '.
+   * https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#local-dates-and-times
+   */
+  if (options.separator != 'T' && options.separator != ' ') {
+    throw new Error(`Invalid timezone separator. Use 'T' or ' '.`)
+  }
+
+  return Object.assign(config, options)
+}
+
+/**
+ * Set separator between date and time
+ *
+ * @param {('T'|' ')=} separator
+ * @returns {DateTimeOptions}
+ */
+export const setTimeSeparator = (separator = 'T') => setConfig({ separator })
diff --git a/src/temporal/config/index.js b/src/temporal/config/index.js
new file mode 100644
index 0000000..d935312
--- /dev/null
+++ b/src/temporal/config/index.js
@@ -0,0 +1,2 @@
+export { setTimeSeparator } from './datetime.js'
+export { setTzSeparator } from './tz.js'
diff --git a/src/temporal/config/tz.js b/src/temporal/config/tz.js
new file mode 100644
index 0000000..b7b1214
--- /dev/null
+++ b/src/temporal/config/tz.js
@@ -0,0 +1,38 @@
+/**
+ * @typedef {Object} TimezoneOptions
+ * @property {(':'|'')=} separator
+ */
+
+/**
+ * @type TimezoneOptions
+ */
+export const tzConfig = {
+  separator: ':',
+}
+
+/**
+ * Set timezone related configuration
+ *
+ * @param {TimezoneOptions} options
+ * @returns {TimezoneOptions}
+ */
+export const setTzConfig = options => {
+
+  /**
+   * The separator can only be ':' or ''.
+   * https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#time-zones
+   */
+  if (options.separator != ':' && options.separator != '') {
+    throw new Error(`Invalid timezone separator. Use ':' or ''.`)
+  }
+
+  return Object.assign(tzConfig, options)
+}
+
+/**
+ * Set timezone separator
+ *
+ * @param {(':'|'')=} separator
+ * @returns {TimezoneOptions}
+ */
+export const setTzSeparator = (separator = '') => setTzConfig({ separator })
diff --git a/src/temporal/index.js b/src/temporal/index.js
index c07ba97..606790b 100644
--- a/src/temporal/index.js
+++ b/src/temporal/index.js
@@ -1,2 +1,3 @@
 export { duration } from './duration.js'
 export { datetime, utc } from './datetime.js'
+export { tzOffset } from './timezone.js'
diff --git a/src/temporal/timezone.js b/src/temporal/timezone.js
new file mode 100644
index 0000000..277e1f5
--- /dev/null
+++ b/src/temporal/timezone.js
@@ -0,0 +1,96 @@
+import {
+  MINUTES_PER_DAY,
+  REAL_LIFE_LOWER_TIMEZONE,
+  REAL_LIFE_UPPER_TIMEZONE,
+  LOCAL_TZ_OFFSET,
+} from './utils/const.js'
+
+import { p } from './utils/string.js'
+import { tzConfig } from './config/tz.js'
+
+import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
+
+Date.prototype.toTemporalInstant = toTemporalInstant
+
+/**
+ * Create `datetime="+04:00"` timezone attribute for `<time>`.
+ * https://html.spec.whatwg.org/multipage/text-level-semantics.html#attr-time-datetime
+ * https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#concept-timezone
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTimeElement/datetime
+ *
+ * @param {number=} hours The number of hours from UTC
+ * @param {number=} minutes The number of minutes from UTC
+ * @param {boolean=} inRealLifeBoundaries Make sure the timezone stays in spec boundaries.
+ * @returns {string}
+ */
+export function tzOffset(hours = 0, minutes = 0, inRealLifeBoundaries = false) {
+
+  // No arguments received: the local timezone offset is returned.
+  if (!('0' in arguments)) {
+    return tzOffset(0, LOCAL_TZ_OFFSET)
+  }
+
+  if (typeof hours != 'number' || typeof minutes != 'number') {
+    throw new TypeError('hours and (optional) minutes must be numbers.')
+  }
+
+  // Convert given offset in minutes and ignore the decimal part.
+  minutes = Math.trunc(hours * 60 + minutes)
+
+  // Compute minutes to remove in order to suppress the excess of minutes.
+  const suppressMinutesExcess = limit => Math.floor(minutes / limit) * MINUTES_PER_DAY
+
+  if (inRealLifeBoundaries) {
+
+    /**
+     * Because lower and upper boundaries are not necessarily symetric,
+     * suppressing the minutes excess can lead to another excess but
+     * on the other side (e.g. by jumping from beyond +14 to -12).
+     */
+
+    // Upper boundary
+    if (minutes > REAL_LIFE_UPPER_TIMEZONE) {
+      minutes -= suppressMinutesExcess(REAL_LIFE_UPPER_TIMEZONE)
+      return tzOffset(0, minutes, true)
+    }
+
+    // Lower boundary
+    if (minutes < REAL_LIFE_LOWER_TIMEZONE) {
+      minutes += suppressMinutesExcess(REAL_LIFE_LOWER_TIMEZONE)
+      return tzOffset(0, minutes, true)
+    }
+  }
+
+  if (minutes == 0) { return 'Z' }
+
+  const utcMidnight = Temporal.ZonedDateTime.from({
+    timeZone: 'UTC',
+    year: 2023,
+    month: 11,
+    day: 11,
+  })
+
+  /**
+   * The timezone offset must stay between -23:59 and +23:59:
+   * https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#concept-timezone
+   * Using `Temporal.ZonedDatetime.add` helps with overflow while `.from`
+   * ignores it.
+   */
+  let zonedTime = utcMidnight.add({ minutes })
+
+  /**
+   * Offset sign: `+` (UTC > 0) or `-` (UTC < 0).
+   * We don’t have condition when minutes is 0: `'Z'` was returned earlier.
+   */
+  const sign =
+    Temporal.ZonedDateTime.compare(utcMidnight, zonedTime) > 0
+      ? '-'
+      : '+'
+
+  if (sign == '-') {
+    // time goes from -21:00 to 03:00
+    zonedTime = zonedTime.subtract({ minutes: minutes * 2 })
+  }
+
+  return `${sign}${p(zonedTime.hour)}${tzConfig.separator}${p(zonedTime.minute)}`
+}
diff --git a/src/temporal/utils/const.js b/src/temporal/utils/const.js
new file mode 100644
index 0000000..5fcc57c
--- /dev/null
+++ b/src/temporal/utils/const.js
@@ -0,0 +1,8 @@
+export const MINUTES_PER_DAY = 60 * 24
+export const MILLISECONDS_PER_DAY = 1000 * 60 * 60 * 24
+export const MILLISECONDS_PER_WEEK = MILLISECONDS_PER_DAY * 7
+export const REAL_LIFE_LOWER_TIMEZONE = -12 * 60
+export const REAL_LIFE_UPPER_TIMEZONE = 14 * 60
+
+// Local timezone offset from UTC, in minutes
+export const LOCAL_TZ_OFFSET = (new Date()).getTimezoneOffset() * -1
diff --git a/src/temporal/utils/string.js b/src/temporal/utils/string.js
new file mode 100644
index 0000000..23fa33c
--- /dev/null
+++ b/src/temporal/utils/string.js
@@ -0,0 +1,8 @@
+/**
+ * padStart a stringable variable by the provided number of 0.
+ *
+ * @param {*} value A stringable value (string, number…).
+ * @param {number=} length The number of 0 at the beginning of the result.
+ * @returns {string}
+ */
+export const p = (value, length = 2) => value.toString().padStart(length, '0')
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index 065051f..70f62d7 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -3,12 +3,11 @@ import { describe, expect, test } from 'vitest'
 import {
   DateTime,
   datetimeTz,
-  tzOffset,
   setTimeSeparator,
   setTzSeparator,
 } from '../../src'
 
-import { duration, datetime, utc } from '../../src/temporal'
+import { duration, datetime, utc, tzOffset } from '../../src/temporal'
 import { daysBetween, weekNumber } from '../../src/temporal/utils/date'
 
 /**
@@ -127,7 +126,7 @@ describe('duration', () => {
   test('days only without converting the excess', () => expect(duration(durationInDays, false)).toBe('P43D'))
 })
 
-describe.todo('tzOffset', () => {
+describe('tzOffset', () => {
   test('is a function', () => expect(tzOffset).toBeInstanceOf(Function))
   test('0', () => expect(tzOffset(0)).toBe('Z'))
   test('-3', () => expect(tzOffset(-3)).toBe('-03:00'))

From 377ca56cf119fe9f358802b2872ca7dac39064bc Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 25 Nov 2023 16:22:10 +0100
Subject: [PATCH 13/39] Add `datetimeTz` using the Temporal API

---
 src/temporal/datetime.js     | 32 +++++++++++++++++++++++++++++++-
 src/temporal/index.js        |  2 +-
 tests/temporal/index.test.js |  5 ++---
 3 files changed, 34 insertions(+), 5 deletions(-)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index ae91fde..3e179ed 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -2,7 +2,7 @@ import { weekNumber } from './utils/date.js'
 import { p } from '../utils/string.js'
 import { tzOffset } from '../timezone.js'
 import { config } from '../config/datetime'
-import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
 
 Date.prototype.toTemporalInstant = toTemporalInstant
 
@@ -93,6 +93,36 @@ export function datetime(date = new Date(), precision = 'day') {
 export const utc = (date = new Date(), precision = 'datetime') =>
   datetime(date, `${precision} utc`)
 
+/**
+ * Create `datetime="2021-12-02T17:34-06:00"` attribute for `<time>`.
+ *
+ * @param {Date=} date
+ * @param {Precision=} precision
+ * @param {number=} offsetHours
+ * @param {number=} offsetMinutes
+ * @param {boolean=} inRealLifeBoundaries
+ * @returns {string}
+ */
+export function datetimeTz(
+  date = new Date(),
+  precision = 'datetime',
+  offsetHours = 0,
+  offsetMinutes = 0,
+  inRealLifeBoundaries = false,
+) {
+  let timezoneOffset = ''
+
+  if (!precision.includes('utc')) {
+    // ignore request for UTC conversion
+    timezoneOffset =
+      '2' in arguments // see similar line in tzOffset()
+        ? tzOffset(offsetHours, offsetMinutes, inRealLifeBoundaries)
+        : tzOffset()
+  }
+
+  return datetime(date, precision) + timezoneOffset
+}
+
 /**
  * Supported precision keywords.
  *
diff --git a/src/temporal/index.js b/src/temporal/index.js
index 606790b..90545a8 100644
--- a/src/temporal/index.js
+++ b/src/temporal/index.js
@@ -1,3 +1,3 @@
 export { duration } from './duration.js'
-export { datetime, utc } from './datetime.js'
+export { datetime, datetimeTz, utc } from './datetime.js'
 export { tzOffset } from './timezone.js'
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index 70f62d7..c7091c7 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -2,12 +2,11 @@ import { describe, expect, test } from 'vitest'
 
 import {
   DateTime,
-  datetimeTz,
   setTimeSeparator,
   setTzSeparator,
 } from '../../src'
 
-import { duration, datetime, utc, tzOffset } from '../../src/temporal'
+import { duration, datetime, datetimeTz, utc, tzOffset } from '../../src/temporal'
 import { daysBetween, weekNumber } from '../../src/temporal/utils/date'
 
 /**
@@ -152,7 +151,7 @@ describe('tzOffset', () => {
   test('()', () => expect(tzOffset()).toBe(tzOffset(0, tzOffsetInMinutes)))
 })
 
-describe.todo('datetimeTz', () => {
+describe('datetimeTz', () => {
   test('is a function', () => expect(datetimeTz).toBeInstanceOf(Function))
   test('wrong type', () => expect(() => datetimeTz(123)).toThrow(TypeError))
 

From b8d8f95d7270a19d1481fbd266f69cdf1ef911bc Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 25 Nov 2023 16:30:23 +0100
Subject: [PATCH 14/39] =?UTF-8?q?Unmark=20=E2=80=9Ctodo=E2=80=9D=20on=20co?=
 =?UTF-8?q?nfig=20tests?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/temporal/datetime.js     |  6 +++---
 src/temporal/index.js        |  5 ++++-
 tests/temporal/index.test.js | 27 ++++++++++++++++++---------
 3 files changed, 25 insertions(+), 13 deletions(-)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index 3e179ed..1faaf1d 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -1,7 +1,7 @@
 import { weekNumber } from './utils/date.js'
-import { p } from '../utils/string.js'
-import { tzOffset } from '../timezone.js'
-import { config } from '../config/datetime'
+import { p } from './utils/string.js'
+import { tzOffset } from './timezone.js'
+import { config } from './config/datetime'
 import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
 
 Date.prototype.toTemporalInstant = toTemporalInstant
diff --git a/src/temporal/index.js b/src/temporal/index.js
index 90545a8..84eec66 100644
--- a/src/temporal/index.js
+++ b/src/temporal/index.js
@@ -1,3 +1,6 @@
+export { datetime, utc, datetimeTz } from './datetime.js'
 export { duration } from './duration.js'
-export { datetime, datetimeTz, utc } from './datetime.js'
 export { tzOffset } from './timezone.js'
+
+export { setTimeSeparator, setTzSeparator } from './config/index.js'
+export { daysBetween, weekNumber } from './utils/date.js'
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index c7091c7..c9a7f9e 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -2,20 +2,29 @@ import { describe, expect, test } from 'vitest'
 
 import {
   DateTime,
+} from '../../src'
+
+import {
+  // DateTime,
+  datetime,
+  utc,
+  datetimeTz,
+  duration,
+  tzOffset,
+  daysBetween,
+  weekNumber,
   setTimeSeparator,
   setTzSeparator,
-} from '../../src'
+} from '../../src/temporal'
 
-import { duration, datetime, datetimeTz, utc, tzOffset } from '../../src/temporal'
-import { daysBetween, weekNumber } from '../../src/temporal/utils/date'
 
 /**
  * These config methods are currently not exported in the main bundle (though
  * they are used by `setXxSeparator` functions). There’s no reason to move
  * them to the main without any new entry in the configuration objects.
  */
-import { setConfig } from '../../src/config/datetime.js'
-import { setTzConfig } from '../../src/config/tz.js'
+import { setConfig } from '../../src/temporal/config/datetime.js'
+import { setTzConfig } from '../../src/temporal/config/tz.js'
 
 const togoIndependanceDay = new Date(1960, 3, 27)
 const date = togoIndependanceDay // alias for the sake of brevity
@@ -181,7 +190,7 @@ describe('datetimeTz', () => {
   test('datetime ms utc', () => expect(datetimeTz(date, 'datetime ms utc')).toBe(date.toJSON()))
 })
 
-describe.todo('setTzSeparator', () => {
+describe('setTzSeparator', () => {
   test('is a function', () => expect(setTzSeparator).toBeInstanceOf(Function))
 
   test('no timezone separator', () => {
@@ -207,7 +216,7 @@ describe.todo('setTzSeparator', () => {
   })
 })
 
-describe.todo('setTzConfig', () => {
+describe('setTzConfig', () => {
   test('is a function', () => expect(setTzConfig).toBeInstanceOf(Function))
 
   test('empty string timezone separator using setTzConfig', () => {
@@ -261,7 +270,7 @@ describe.todo('DateTime class', () => {
 
 // These tests are at the end as they change the widely-used separator config.
 
-describe.todo('setTimeSeparator', () => {
+describe('setTimeSeparator', () => {
   test('is a function', () => expect(setTimeSeparator).toBeInstanceOf(Function))
 
   test('no time separator', () => {
@@ -282,7 +291,7 @@ describe.todo('setTimeSeparator', () => {
   test('invalid separator', () => expect(() => setTimeSeparator(42)).toThrow(Error))
 })
 
-describe.todo('setConfig', () => {
+describe('setConfig', () => {
   test('is a function', () => expect(setConfig).toBeInstanceOf(Function))
 
   test('T as time separator using setConfig', () => {

From bf80426028032337d59f4a4631b697d5d29d208e Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 25 Nov 2023 17:08:15 +0100
Subject: [PATCH 15/39] Add `DateTime` class using the Temporal API

---
 src/temporal/datetime-class.js | 48 ++++++++++++++++++++++++++++++++++
 src/temporal/index.js          |  2 ++
 tests/temporal/index.test.js   |  6 +----
 3 files changed, 51 insertions(+), 5 deletions(-)
 create mode 100644 src/temporal/datetime-class.js

diff --git a/src/temporal/datetime-class.js b/src/temporal/datetime-class.js
new file mode 100644
index 0000000..7c63256
--- /dev/null
+++ b/src/temporal/datetime-class.js
@@ -0,0 +1,48 @@
+import { MILLISECONDS_PER_WEEK } from './utils/const.js'
+import { datetime, weekNumber } from './index.js'
+import { Temporal } from '@js-temporal/polyfill'
+
+export class DateTime extends Date {
+
+  /**
+   * Returns the week of the year (`1`–`53`) of the specified date according to
+   * local time, as defined by the WHATWG and the ISO-8601 specs:
+   *
+   * - a week starts on Monday (https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#concept-week);
+   * - the first week of the year includes a Thursday;
+   * - week numbers go from 1 to 53 (https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#week-number-of-the-last-day).
+   *
+   * @returns {number}
+   */
+  getWeek = () => weekNumber(this)
+
+  /**
+   * Set the week number.
+   *
+   * @param {number} weekNumber
+   * @returns {number} Milliseconds since midnight on January 1, 1970, UTC
+   */
+  setWeek(weekNumber) {
+    const weeksDiffInMs = (weekNumber - this.getWeek()) * MILLISECONDS_PER_WEEK
+
+    /**
+     * Temporal API is less efficient here, it’s probably better with a
+     * Temporal object while this class is really `Date` focused as
+     * it extends it. Commented code: Temporal implementation.
+     */
+    // const temporalThis = Temporal.Instant.fromEpochMilliseconds(
+    //   this.getTime() + weeksDiffInMs
+    // )
+    // return this.setTime(temporalThis.epochMilliseconds)
+
+    return this.setTime(this.getTime() + weeksDiffInMs)
+  }
+
+  /**
+   * Converts a date to a string following the ISO 8601 Extended Format.
+   *
+   * @param {import('./datetime.js').Precision} precision
+   * @returns {string}
+   */
+  to = precision => datetime(this, precision)
+}
diff --git a/src/temporal/index.js b/src/temporal/index.js
index 84eec66..f72c094 100644
--- a/src/temporal/index.js
+++ b/src/temporal/index.js
@@ -4,3 +4,5 @@ export { tzOffset } from './timezone.js'
 
 export { setTimeSeparator, setTzSeparator } from './config/index.js'
 export { daysBetween, weekNumber } from './utils/date.js'
+
+export { DateTime } from './datetime-class.js'
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
index c9a7f9e..e8579c4 100644
--- a/tests/temporal/index.test.js
+++ b/tests/temporal/index.test.js
@@ -2,10 +2,6 @@ import { describe, expect, test } from 'vitest'
 
 import {
   DateTime,
-} from '../../src'
-
-import {
-  // DateTime,
   datetime,
   utc,
   datetimeTz,
@@ -256,7 +252,7 @@ describe('daysBetween', () => {
 const summer = new DateTime(2021, 5, 21)
 const twoWeeksAfterSummer = new DateTime(2021, 6, 5)
 
-describe.todo('DateTime class', () => {
+describe('DateTime class', () => {
   test('extends Date', () => expect(summer).toBeInstanceOf(Date))
   test('.getWeek', () => expect(summer.getWeek()).toBe(25))
   test(".to('day')", () => expect(summer.to('day')).toBe('2021-06-21'))

From 3dcf3ff0f1d8b5059f04950dad5a8c07e888cfc4 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 25 Nov 2023 17:29:43 +0100
Subject: [PATCH 16/39] Fix path in Temporal duration
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Wasn’t using the right one.
---
 src/temporal/duration.js   |  4 ++--
 src/temporal/utils/math.js | 11 +++++++++++
 2 files changed, 13 insertions(+), 2 deletions(-)
 create mode 100644 src/temporal/utils/math.js

diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index 6204335..470eedd 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -4,10 +4,10 @@
  * - add support for sub-second units (ms, mis, ns)
  */
 
-import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
-import { round } from '../utils/math'
 
 // Date.prototype.toTemporalInstant = toTemporalInstant
+import { Temporal } from '@js-temporal/polyfill'
+import { round } from './utils/math'
 
 /**
  * Create `datetime="P3DT2H8M32.541S"` duration attribute for `<time>`.
diff --git a/src/temporal/utils/math.js b/src/temporal/utils/math.js
new file mode 100644
index 0000000..fab1220
--- /dev/null
+++ b/src/temporal/utils/math.js
@@ -0,0 +1,11 @@
+/**
+ * Round a number to the provided precision.
+ *
+ * @param {number} number The number to round.
+ * @param {number=} precision The rounding precision.
+ * @returns {number}
+ */
+export const round = (number, precision = 0) => {
+  precision = 10 ** precision
+  return Math.round(number * precision) / precision
+}

From 82ab5c59fb3a2c1975f4be3a23d1e082bbc8e432 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 11:01:34 +0200
Subject: [PATCH 17/39] Duplicate test from non-Temporal implementation

---
 src/temporal/config/datetime.test.js |  63 ++++++
 src/temporal/config/tz.test.js       |  55 +++++
 src/temporal/datetime-class.test.js  |  70 ++++++
 src/temporal/datetime.test.js        | 317 +++++++++++++++++++++++++++
 src/temporal/duration.test.js        |  99 +++++++++
 src/temporal/timezone.test.js        |  99 +++++++++
 src/temporal/utils/date.test.js      |  71 ++++++
 tests/temporal/index.test.js         | 304 -------------------------
 8 files changed, 774 insertions(+), 304 deletions(-)
 create mode 100644 src/temporal/config/datetime.test.js
 create mode 100644 src/temporal/config/tz.test.js
 create mode 100644 src/temporal/datetime-class.test.js
 create mode 100644 src/temporal/datetime.test.js
 create mode 100644 src/temporal/duration.test.js
 create mode 100644 src/temporal/timezone.test.js
 create mode 100644 src/temporal/utils/date.test.js
 delete mode 100644 tests/temporal/index.test.js

diff --git a/src/temporal/config/datetime.test.js b/src/temporal/config/datetime.test.js
new file mode 100644
index 0000000..1039d04
--- /dev/null
+++ b/src/temporal/config/datetime.test.js
@@ -0,0 +1,63 @@
+import { describe, expect, test } from 'vitest'
+
+import { datetime, setTimeSeparator } from '../index.js'
+
+import { setConfig } from './datetime.js'
+
+const togoIndependanceDay = new Date(1960, 3, 27)
+const date = togoIndependanceDay // alias for the sake of brevity
+
+describe('setTimeSeparator', () => {
+
+  test('is a function', () => {
+    expect(setTimeSeparator).toBeInstanceOf(Function)
+  })
+
+  test('throws with invalid separator', () => {
+    expect(() => setTimeSeparator(42)).toThrow(Error)
+  })
+
+  test('no time separator', () => {
+    setTimeSeparator()
+    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
+  })
+
+  test('T as time separator', () => {
+    setTimeSeparator('T')
+    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
+  })
+
+  test('space as time separator', () => {
+    setTimeSeparator(' ')
+    expect(datetime(date, 'datetime')).toBe('1960-04-27 00:00')
+  })
+})
+
+describe('setConfig', () => {
+
+  test('is a function', () => {
+    expect(setConfig).toBeInstanceOf(Function)
+  })
+
+  test('throws without parameter', () => {
+    expect(() => setConfig()).toThrow(TypeError)
+  })
+
+  test('throws without proper parameter', () => {
+    expect(() => setConfig({})).toThrow(Error)
+  })
+
+  test('throws with invalid separator', () => {
+    expect(() => setConfig({ separator: 42 })).toThrow(Error)
+  })
+
+  test('T as time separator using datetime', () => {
+    setConfig({ separator: 'T' })
+    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
+  })
+
+  test('space as time separator using datetime', () => {
+    setConfig({ separator: ' ' })
+    expect(datetime(date, 'datetime')).toBe('1960-04-27 00:00')
+  })
+})
diff --git a/src/temporal/config/tz.test.js b/src/temporal/config/tz.test.js
new file mode 100644
index 0000000..05c6f7d
--- /dev/null
+++ b/src/temporal/config/tz.test.js
@@ -0,0 +1,55 @@
+import { describe, expect, test } from 'vitest'
+
+import { datetimeTz, tzOffset, setTzSeparator } from '../index.js'
+
+import { setTzConfig } from './tz.js'
+
+const togoIndependanceDay = new Date(1960, 3, 27)
+const date = togoIndependanceDay // alias for the sake of brevity
+
+describe('setTzSeparator', () => {
+  test('is a function', () => expect(setTzSeparator).toBeInstanceOf(Function))
+  test('throws with invalid separator', () => expect(() => setTzSeparator(42)).toThrow(Error))
+
+  test('no timezone separator', () => {
+    setTzSeparator()
+    expect(tzOffset(3)).toBe('+0300')
+  })
+
+  test('empty string timezone separator', () => {
+    setTzSeparator('')
+    expect(tzOffset(3)).toBe('+0300')
+  })
+
+  test(': as timezone separator', () => {
+    setTzSeparator(':')
+    expect(tzOffset(3)).toBe('+03:00')
+  })
+
+  test('empty string timezone separator with datetimeTz', () => {
+    setTzSeparator('')
+    expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-0600')
+  })
+})
+
+describe('setTzConfig', () => {
+  test('is a function', () => expect(setTzConfig).toBeInstanceOf(Function))
+  test('throws without parameter', () => expect(() => setTzConfig()).toThrow(TypeError))
+  test('throws without proper parameter', () => expect(() => setTzConfig({})).toThrow(Error))
+  test('throws with invalid separator', () => expect(() => setTzConfig({ separator: 42 })).toThrow(Error))
+
+  test('empty string timezone separator using tzOffset', () => {
+    setTzConfig({ separator: '' })
+    expect(tzOffset(3)).toBe('+0300')
+  })
+
+  test(': as timezone separator using tzOffset', () => {
+    setTzConfig({ separator: ':' })
+    expect(tzOffset(3)).toBe('+03:00')
+  })
+
+  test(': as timezone separator with datetimeTz', () => {
+    setTzConfig({ separator: ':' })
+    expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00')
+  })
+})
diff --git a/src/temporal/datetime-class.test.js b/src/temporal/datetime-class.test.js
new file mode 100644
index 0000000..c5c8748
--- /dev/null
+++ b/src/temporal/datetime-class.test.js
@@ -0,0 +1,70 @@
+import { beforeEach, describe, expect, test } from 'vitest'
+
+import { DateTime, datetime } from './index.js'
+import { MILLISECONDS_PER_DAY } from './utils/const.js'
+
+const FOURTEEN_DAYS_IN_MS = MILLISECONDS_PER_DAY * 14
+
+describe('DateTime class', () => {
+  /** @type {Date} */ let summer
+  /** @type {Date} */ let twoWeeksIntoSummer
+  /** @type {Date} */ let winter
+  /** @type {Date} */ let twoWeeksIntoWinter
+
+  beforeEach(() => {
+    summer = new DateTime(2021, 5, 21)
+    twoWeeksIntoSummer = new DateTime(summer.getTime() + FOURTEEN_DAYS_IN_MS) // same as `new DateTime(2021, 6, 5)`
+
+    winter = new DateTime(2021, 11, 21)
+    twoWeeksIntoWinter = new DateTime(winter.getTime() + FOURTEEN_DAYS_IN_MS) // same as `new DateTime(2022, 1, 4)`
+  })
+
+  test('extends the Date class', () => {
+    expect(summer).toBeInstanceOf(DateTime)
+    expect(summer).toBeInstanceOf(Date)
+  })
+
+  describe('.to() == datetime()', () => {
+
+    test('with default precision', () => {
+      expect(summer.to()).toBe('2021-06-21')
+      expect(datetime(summer)).toBe('2021-06-21')
+    })
+
+    test(`with 'month' precision`, () => {
+      expect(twoWeeksIntoSummer.to('month')).toBe('2021-07')
+      expect(datetime(twoWeeksIntoSummer, 'month')).toBe('2021-07')
+    })
+
+    test(`with 'week' precision, after the week is changed to a new year`, () => {
+      winter.setDate(winter.getDate() + 14)
+
+      expect(winter.to('week')).toBe(twoWeeksIntoWinter.to('week'))
+      expect(winter.to('week')).toBe('2022-W01')
+      expect(datetime(winter, 'week')).toBe('2022-W01')
+    })
+  })
+
+  describe('.getWeek()', () => {
+
+    test('returns the week number', () => {
+      expect(summer.getWeek()).toBe(25)
+    })
+
+    test('returns the week number after the date is changed', () => {
+      summer.setDate(summer.getDate() + 14)
+
+      expect(summer.getWeek()).toBe(twoWeeksIntoSummer.getWeek())
+    })
+
+    test('returns the week number after the date is changed to a new year', () => {
+      winter.setDate(winter.getDate() + 14)
+
+      expect(winter.getWeek()).toBe(twoWeeksIntoWinter.getWeek())
+    })
+  })
+
+  test('.setWeek() returns the timestamp of the changed date', () => {
+    expect(summer.setWeek(27)).toBe(twoWeeksIntoSummer.getTime())
+  })
+})
diff --git a/src/temporal/datetime.test.js b/src/temporal/datetime.test.js
new file mode 100644
index 0000000..8e33489
--- /dev/null
+++ b/src/temporal/datetime.test.js
@@ -0,0 +1,317 @@
+import { describe, expect, test } from 'vitest'
+
+import { datetime, datetimeTz, tzOffset, utc } from './index.js'
+import { getNormalizeDay } from './utils/date.js'
+
+const togoIndependanceDay = new Date(1960, 3, 27)
+const date = togoIndependanceDay // alias for the sake of brevity
+
+const firstCerealHarvest = new Date(-23000, 6, 7)
+const foundationOfSyracuse = new Date(-733, 6, 7)
+const birthOfChineseEmpressWuZetian = new Date(624, 1, 17) // https://en.wikipedia.org/wiki/Wu_Zetian
+const january1st2021 = new Date(2021, 0, 1, 10, 10, 12)
+const january11th = new Date(2021, 0, 11, 10, 10, 12)
+const january19th = new Date(2021, 0, 19, 10, 10, 12)
+const december31th2020 = new Date(2020, 11, 31, 10, 10, 12)
+const december31th2021 = new Date(2021, 11, 31, 10, 10, 12)
+const year10k = new Date(10000, 0, 1)
+
+const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
+
+describe('datetime', () => {
+
+  test('is a function', () => {
+    expect(datetime).toBeInstanceOf(Function)
+  })
+
+  test('throws on wrong date type', () => {
+    expect(() => datetime(123)).toThrow(TypeError)
+  })
+
+  test('“now” as default date parameter', () => {
+    expect(datetime()).toBe(datetime((new Date())))
+  })
+
+  test('no precision', () => expect(datetime(date)).toBe('1960-04-27'))
+  test('no precision before the 10th', () => expect(datetime(january1st2021)).toBe('2021-01-01'))
+
+  describe('precision, no UTC', () => {
+
+    test('day', () => {
+      expect(datetime(date, 'day')).toBe('1960-04-27')
+    })
+
+    test('year', () => {
+      expect(datetime(date, 'year')).toBe('1960')
+    })
+
+    test('month', () => {
+      expect(datetime(date, 'month')).toBe('1960-04')
+    })
+
+    test('yearless', () => {
+      expect(datetime(date, 'yearless')).toBe('04-27')
+    })
+
+    test('time', () => {
+      expect(datetime(date, 'time')).toBe('00:00')
+    })
+
+    test('second', () => {
+      expect(datetime(date, 'second')).toBe('00:00:00')
+    })
+
+    test('ms', () => {
+      expect(datetime(date, 'ms')).toBe('00:00:00.000')
+    })
+
+    test('datetime', () => {
+      expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
+    })
+
+    test('datetime second', () => {
+      expect(datetime(date, 'datetime second')).toBe('1960-04-27T00:00:00')
+    })
+
+    test('datetime ms', () => {
+      expect(datetime(date, 'datetime ms')).toBe('1960-04-27T00:00:00.000')
+    })
+  })
+
+  describe('week', () => {
+
+    test('week on 1960-04-27 is 1960-W17', () => {
+      expect(datetime(date, 'week')).toBe('1960-W17')
+    })
+
+    test('week on 2020-12-31 is 2020-W53', () => {
+      expect(datetime(december31th2020, 'week')).toBe('2020-W53')
+    })
+
+    // 1st day of the year is after Thurdsay
+    test('week on 2021-01-01 is 2020-W53', () => {
+      expect(getNormalizeDay(january1st2021)).toBeGreaterThan(4)
+      expect(datetime(january1st2021, 'week')).toBe('2020-W53')
+    })
+
+    test('week on 2021-01-08 is 2021-W01', () => {
+      expect(datetime(new Date(2021, 0, 8), 'week')).toBe('2021-W01')
+    })
+
+    test('week on 2021-01-11 is 2021-W02', () => {
+      expect(datetime(january11th, 'week')).toBe('2021-W02')
+    })
+
+    test('week on 2021-01-19 is 2021-W03', () => {
+      expect(datetime(january19th, 'week')).toBe('2021-W03')
+    })
+
+    // 1st day of the month is after Thurdsay, but it’s not in January
+    test('week on 2021-03-01 is 2021-W17', () => {
+      const march1st2021 = new Date(2021, 4, 1)
+      expect(getNormalizeDay(march1st2021)).toBeGreaterThan(4)
+      expect(datetime(march1st2021, 'week')).toBe('2021-W17')
+    })
+
+    test('week on 2021-12-31 is 2021-W52', () => {
+      expect(datetime(december31th2021, 'week')).toBe('2021-W52')
+    })
+  })
+
+  // These ones can’t be tested providing an exact value as the output depends on client timezone.
+  describe('precision, UTC', () => {
+
+    test('time utc', () => {
+      expect(datetime(date, 'time utc')).toBe(date.toJSON().substr(11, 5) + 'Z')
+    })
+
+    test('second utc', () => {
+      expect(datetime(date, 'second utc')).toBe(date.toJSON().substr(11, 8) + 'Z')
+    })
+
+    test('ms utc', () => {
+      expect(datetime(date, 'ms utc')).toBe(date.toJSON().substr(11, 12) + 'Z')
+    })
+
+    test('datetime utc', () => {
+      expect(datetime(date, 'datetime utc')).toBe(date.toJSON().substr(0, 16) + 'Z')
+    })
+
+    test('datetime second utc', () => {
+      expect(datetime(date, 'datetime second utc')).toBe(date.toJSON().substr(0, 19) + 'Z')
+    })
+
+    test('datetime ms utc', () => {
+      expect(datetime(date, 'datetime ms utc')).toBe(date.toJSON())
+    })
+  })
+
+  describe('year and yearless, but for years outside the ISO-8601 range', () => {
+
+    test('3 digits year before 0', () => {
+      expect(datetime(foundationOfSyracuse, 'year')).toBe('-0733')
+    })
+
+    test('3 digits year', () => {
+      expect(datetime(birthOfChineseEmpressWuZetian, 'year')).toBe('0624')
+    })
+
+    test('5 digits year before 0', () => {
+      expect(datetime(firstCerealHarvest, 'year')).toBe('-23000')
+    })
+
+    test('5 digits year after 9999', () => {
+      expect(datetime(year10k, 'year')).toBe('10000')
+    })
+
+    test('yearless and year before 0', () => {
+      expect(datetime(foundationOfSyracuse, 'yearless')).toBe('07-07')
+    })
+
+    test('yearless and 3 digits year', () => {
+      expect(datetime(birthOfChineseEmpressWuZetian, 'yearless')).toBe('02-17')
+    })
+  })
+
+  test('unsupported precision falls back on the default one', () => {
+    expect(datetime(date, 'n00t')).toBe('1960-04-27')
+  })
+})
+
+describe('datetimeTz', () => {
+
+  test('is a function', () => {
+    expect(datetimeTz).toBeInstanceOf(Function)
+  })
+
+  test('throws on wrong date type', () => {
+    expect(() => datetimeTz(123)).toThrow(TypeError)
+  })
+
+  test('“now” as default date parameter', () => {
+    expect(datetimeTz()).toBe(datetimeTz((new Date())))
+  })
+
+  test('no precision', () => {
+    expect(datetimeTz(date)).toBe('1960-04-27T00:00' + tzOffset(0, tzOffsetInMinutes))
+  })
+
+  test('no offset', () => {
+    expect(datetimeTz(date, 'time')).toBe('00:00' + tzOffset(0, tzOffsetInMinutes))
+  })
+
+  describe('precision, no UTC', () => {
+
+    test('time 0', () => {
+      expect(datetimeTz(date, 'time', 0)).toBe('00:00Z')
+    })
+
+    test('time +4', () => {
+      expect(datetimeTz(date, 'time', 4)).toBe('00:00+04:00')
+    })
+
+    test('second -3', () => {
+      expect(datetimeTz(date, 'second', -3)).toBe('00:00:00-03:00')
+    })
+
+    test('ms +3.5', () => {
+      expect(datetimeTz(date, 'ms', 3.5)) .toBe('00:00:00.000+03:30')
+    })
+
+    test('datetime +12:45', () => {
+      expect(datetimeTz(date, 'datetime', 12, 45)).toBe('1960-04-27T00:00+12:45')
+    })
+
+    test('datetime +17, 30, true', () => {
+      expect(datetimeTz(date, 'datetime', 17, 30, true)).toBe('1960-04-27T00:00-06:30')
+    })
+
+    test('datetime second -6', () => {
+      expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00')
+    })
+
+    test('datetime ms +1', () => {
+      expect(datetimeTz(date, 'datetime ms', 1)).toBe('1960-04-27T00:00:00.000+01:00')
+    })
+  })
+
+  // These ones can’t be tested providing an exact value as the output depends on client timezone.
+
+  describe('precision, UTC', () => {
+
+    test('time utc', () => {
+      expect(datetimeTz(date, 'time utc')).toBe(date.toJSON().substr(11, 5) + 'Z')
+    })
+
+    test('second utc', () => {
+      expect(datetimeTz(date, 'second utc')).toBe(date.toJSON().substr(11, 8) + 'Z')
+    })
+
+    test('ms utc', () => {
+      expect(datetimeTz(date, 'ms utc')).toBe(date.toJSON().substr(11, 12) + 'Z')
+    })
+
+    test('datetime utc', () => {
+      expect(datetimeTz(date, 'datetime utc')).toBe(date.toJSON().substr(0, 16) + 'Z')
+    })
+
+    test('datetime second utc', () => {
+      expect(datetimeTz(date, 'datetime second utc')).toBe(date.toJSON().substr(0, 19) + 'Z')
+    })
+
+    test('datetime ms utc', () => {
+      expect(datetimeTz(date, 'datetime ms utc')).toBe(date.toJSON())
+    })
+  })
+})
+
+describe('utc', () => {
+  test('is a function', () => {
+    expect(utc).toBeInstanceOf(Function)
+  })
+
+  test('throws on wrong date type', () => {
+    expect(() => utc(123)).toThrow(TypeError)
+  })
+
+  test('“now” as default date parameter', () => {
+    expect(utc()).toBe(utc((new Date())))
+  })
+
+  // These ones can’t be tested providing an exact value as the output depends on client timezone.
+
+  describe('precision', () => {
+
+    test(`'datetime' is the default precision`, () => {
+      expect(utc(date)).toBe(date.toJSON().substr(0, 16) + 'Z')
+    })
+
+    test('time', () => {
+      expect(utc(date, 'time')).toBe(date.toJSON().substr(11, 5) + 'Z')
+    })
+
+    test('second', () => {
+      expect(utc(date, 'second')).toBe(date.toJSON().substr(11, 8) + 'Z')
+    })
+
+    test('ms', () => {
+      expect(utc(date, 'ms')).toBe(date.toJSON().substr(11, 12) + 'Z')
+    })
+
+    test('datetime', () => {
+      expect(utc(date, 'datetime')).toBe(date.toJSON().substr(0, 16) + 'Z')
+    })
+
+    test('datetime second', () => {
+      expect(utc(date, 'datetime second')).toBe(date.toJSON().substr(0, 19) + 'Z')
+    })
+
+    test('datetime ms', () => {
+      expect(utc(date, 'datetime ms')).toBe(date.toJSON())
+    })
+  })
+
+  test('unsupported precision falls back on the default one', () => {
+    expect(utc(date, 'n00t')).toBe('1960-04-27')
+  })
+})
diff --git a/src/temporal/duration.test.js b/src/temporal/duration.test.js
new file mode 100644
index 0000000..ef382ec
--- /dev/null
+++ b/src/temporal/duration.test.js
@@ -0,0 +1,99 @@
+import { describe, expect, test } from 'vitest'
+
+import { duration } from './index.js'
+
+describe('duration', () => {
+  const durationObject = { w: 3, d: 5, h: 10, m: 43, s: 2.61 }
+  const durationWithTooHighValues = { w: 3, d: 19, h: 36, m: 53, s: 175.3 }
+  const durationInHours = { h: 17 }
+  const durationInDays = { d: 43 }
+
+  test('is a function', () => {
+    expect(duration).toBeInstanceOf(Function)
+  })
+
+  test('duration(null) throws', () => {
+    expect(() => duration(null)).toThrow(Error)
+  })
+
+  describe('empty or missing object', () => {
+
+    test('duration()', () => {
+      expect(duration()).toBe('PT0S')
+    })
+
+    test('duration({})        is PT0S', () => {
+      expect(duration({})).toBe('PT0S')
+    })
+
+    test('duration({}, true)  is PT0S', () => {
+      expect(duration({}, true)).toBe('PT0S')
+    })
+
+    test('duration({}, false) is PT0S', () => {
+      expect(duration({}, false)).toBe('PT0S')
+    })
+  })
+
+  describe('complete object', () => {
+
+    test('{ w: 3, d: 5, h: 10, m: 43, s: 2.61 } is P3W5DT10H43M2.61S', () => {
+      expect(duration(durationObject)).toBe('P3W5DT10H43M2.61S')
+    })
+
+    test('with too high values', () => {
+      expect(duration(durationWithTooHighValues)).toBe('P5W6DT12H55M55.3S')
+    })
+  })
+
+  describe('partial object', () => {
+
+    test('hours only', () => {
+      expect(duration(durationInHours)).toBe('PT17H')
+    })
+
+    test('days only', () => {
+      expect(duration(durationInDays)).toBe('P6W1D')
+    })
+
+  })
+
+  describe('conversion of excess values', () => {
+
+    test('is enabled by default', () => {
+      expect(duration(durationWithTooHighValues)).toBe(duration(durationWithTooHighValues, true))
+    })
+
+    test('disabled: full object without excess', () => {
+      expect(duration(durationObject, false)).toBe('P3W5DT10H43M2.61S')
+    })
+
+    test('disabled: full object with excess', () => {
+      expect(duration(durationWithTooHighValues, false)).toBe('P3W19DT36H53M175.3S')
+    })
+
+    test('disabled: partial object without excess', () => {
+      expect(duration(durationInHours, false)).toBe('PT17H')
+    })
+
+    test('disabled: partial object with excess', () => {
+      expect(duration(durationInDays, false)).toBe('P43D')
+    })
+
+    test('enabled: full object without excess', () => {
+      expect(duration(durationObject, true)).toBe('P3W5DT10H43M2.61S')
+    })
+
+    test('enabled: full object with excess', () => {
+      expect(duration(durationWithTooHighValues, true)).toBe('P5W6DT12H55M55.3S')
+    })
+
+    test('enabled: partial object without excess', () => {
+      expect(duration(durationInHours, true)).toBe('PT17H')
+    })
+
+    test('enabled: partial object with excess', () => {
+      expect(duration(durationInDays, true)).toBe('P6W1D')
+    })
+  })
+})
diff --git a/src/temporal/timezone.test.js b/src/temporal/timezone.test.js
new file mode 100644
index 0000000..ef5afba
--- /dev/null
+++ b/src/temporal/timezone.test.js
@@ -0,0 +1,99 @@
+import { describe, expect, test } from 'vitest'
+
+import { tzOffset } from './index.js'
+
+const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
+
+describe('tzOffset', () => {
+
+  test('is a function', () => {
+    expect(tzOffset).toBeInstanceOf(Function)
+  })
+
+  test('tzOffset(Z) throws', () => {
+    expect(() => tzOffset('Z')).toThrow(TypeError)
+  })
+
+  // This one can’t be tested providing an exact value as the output depends on client timezone and daylight time saving.
+  test('tzOffset() is the local timezone offset from UTC, in minutes', () => {
+    expect(tzOffset()).toBe(tzOffset(0, tzOffsetInMinutes))
+  })
+
+  describe('in boundaries', () => {
+
+    test('tzOffset(-8)      is -08:00', () => {
+      expect(tzOffset(-8)).toBe('-08:00')
+    })
+
+    test('tzOffset(-4.5)    is -04:30', () => {
+      expect(tzOffset(-4.5)).toBe('-04:30')
+    })
+
+    test('tzOffset(0, -30)  is -00:30', () => {
+      expect(tzOffset(0, -30)).toBe('-00:30')
+    })
+
+    test('tzOffset(0)       is Z', () => {
+      expect(tzOffset(0)).toBe('Z')
+    })
+
+    test('tzOffset(0, 30)   is +00:30', () => {
+      expect(tzOffset(0, 30)).toBe('+00:30')
+    })
+
+    test('tzOffset(1)       is +01:00', () => {
+      expect(tzOffset(1)).toBe('+01:00')
+    })
+
+    test('tzOffset(2, -200) is -01:20', () => {
+      expect(tzOffset(2, -200)).toBe('-01:20')
+    })
+
+    test('tzOffset(4, 30)   is +04:30', () => {
+      expect(tzOffset(4, 30)).toBe('+04:30')
+    })
+
+    test('tzOffset(12, 45)  is +12:45', () => {
+      expect(tzOffset(12, 45)).toBe('+12:45')
+    })
+
+    test('tzOffset(12.75)   is +12:45', () => {
+      expect(tzOffset(12.75)).toBe('+12:45')
+    })
+  })
+
+  describe('out of boundaries', () => {
+
+    test('tzOffset(-35)            is -11:00', () => {
+      expect(tzOffset(-35)).toBe('-11:00')
+    })
+
+    test('tzOffset(-35, 0, true)   is +13:00', () => {
+      expect(tzOffset(-35, 0, true)).toBe('+13:00')
+    })
+
+    test('tzOffset(62.75)          is +14:45', () => {
+      expect(tzOffset(62.75)).toBe('+14:45')
+    })
+
+    test('tzOffset(-12, 0, true)   is -12:00', () => {
+      expect(tzOffset(-12, 0, true)).toBe('-12:00')
+    })
+
+    test('tzOffset(-12, -20, true) is +11:40', () => {
+      expect(tzOffset(-12, -20, true)).toBe('+11:40')
+    })
+
+    test('tzOffset(-13, -20, true) is +10:40', () => {
+      expect(tzOffset(-13, -20, true)).toBe('+10:40')
+    })
+
+    test('tzOffset(14, 45, true)   is -09:15', () => {
+      expect(tzOffset(14, 45, true)).toBe('-09:15')
+    })
+
+    test('tzOffset(62.75, 0, true) is -09:15', () => {
+      expect(tzOffset(62.75, 0, true)).toBe('-09:15')
+    })
+  })
+})
diff --git a/src/temporal/utils/date.test.js b/src/temporal/utils/date.test.js
new file mode 100644
index 0000000..a65527a
--- /dev/null
+++ b/src/temporal/utils/date.test.js
@@ -0,0 +1,71 @@
+import { describe, expect, test } from 'vitest'
+
+import { daysBetween, weekNumber } from '../index.js'
+
+const togoIndependanceDay = new Date(1960, 3, 27)
+const january1st2021 = new Date(2021, 0, 1, 10, 10, 12)
+const january11th = new Date(2021, 0, 11, 10, 10, 12)
+const december31th2020 = new Date(2020, 11, 31, 10, 10, 12)
+const december31th2020OneMinuteLater = new Date(2020, 11, 31, 10, 11, 12)
+const december31th2021 = new Date(2021, 11, 31, 10, 10, 12)
+const january2nd2022 = new Date(2022, 0, 2, 10, 10, 12)
+const january3rd2022 = new Date(2022, 0, 3, 10, 10, 12)
+
+describe('weekNumber', () => {
+
+  test('is a function', () => {
+    expect(weekNumber).toBeInstanceOf(Function)
+  })
+
+  describe('weeks without year overlap', () => {
+
+    test('1960-04-27 is week 17', () => {
+      expect(weekNumber(togoIndependanceDay)).toBe(17)
+    })
+
+    test('2021-01-11 is week 2', () => {
+      expect(weekNumber(january11th)).toBe(2)
+    })
+  })
+
+  describe('weeks with potential year overlap', () => {
+
+    test('2020-12-31 is week 53', () => {
+      expect(weekNumber(december31th2020)).toBe(53)
+    })
+
+    test('2021-01-01 is week 53', () => {
+      expect(weekNumber(january1st2021)).toBe(53)
+    })
+
+    test('2021-12-31 is week 52', () => {
+      expect(weekNumber(december31th2021)).toBe(52)
+    })
+
+    test('2022-01-02 is week 52', () => {
+      expect(weekNumber(january2nd2022)).toBe(52)
+    })
+
+    test('2022-01-03 is week 1', () => {
+      expect(weekNumber(january3rd2022)).toBe(1)
+    })
+  })
+
+})
+
+describe('daysBetween', () => {
+
+  test('is a function', () => expect(daysBetween).toBeInstanceOf(Function))
+
+  test('10 days between 1/1 and 11/1', () => {
+    expect(daysBetween(january1st2021, january11th)).toBe(10)
+  })
+
+  test('-10 days between 11/1 and 1/1', () => {
+    expect(daysBetween(january11th, january1st2021)).toBe(-10)
+  })
+
+  test('same day, different time', () => {
+    expect(daysBetween(december31th2020, december31th2020OneMinuteLater)).toBe(0)
+  })
+})
diff --git a/tests/temporal/index.test.js b/tests/temporal/index.test.js
deleted file mode 100644
index e8579c4..0000000
--- a/tests/temporal/index.test.js
+++ /dev/null
@@ -1,304 +0,0 @@
-import { describe, expect, test } from 'vitest'
-
-import {
-  DateTime,
-  datetime,
-  utc,
-  datetimeTz,
-  duration,
-  tzOffset,
-  daysBetween,
-  weekNumber,
-  setTimeSeparator,
-  setTzSeparator,
-} from '../../src/temporal'
-
-
-/**
- * These config methods are currently not exported in the main bundle (though
- * they are used by `setXxSeparator` functions). There’s no reason to move
- * them to the main without any new entry in the configuration objects.
- */
-import { setConfig } from '../../src/temporal/config/datetime.js'
-import { setTzConfig } from '../../src/temporal/config/tz.js'
-
-const togoIndependanceDay = new Date(1960, 3, 27)
-const date = togoIndependanceDay // alias for the sake of brevity
-
-const firstCerealHarvest = new Date(-23000, 6, 7)
-const foundationOfSyracuse = new Date(-733, 6, 7)
-const birthOfChineseEmpressWuZetian = new Date(624, 1, 17) // https://en.wikipedia.org/wiki/Wu_Zetian
-const january1st = new Date(2021, 0, 1, 10, 10, 12)
-const january11th = new Date(2021, 0, 11, 10, 10, 12)
-const january19th = new Date(2021, 0, 19, 10, 10, 12)
-const december31th2020 = new Date(2020, 11, 31, 10, 10, 12)
-const december31th2020OneMinuteLater = new Date(2020, 11, 31, 10, 11, 12)
-const december31th2021 = new Date(2021, 11, 31, 10, 10, 12)
-const year10k = new Date(10000, 0, 1)
-
-const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
-
-describe('datetime', () => {
-  test('is a function', () => expect(datetime).toBeInstanceOf(Function))
-  test('wrong type', () => expect(() => datetime(123)).toThrow(TypeError))
-
-  test('()', () => expect(datetime()).toBe(datetime((new Date()))))
-
-  test('no precision', () => expect(datetime(date)).toBe('1960-04-27'))
-  test('no precision before the 10th', () => expect(datetime(january1st)).toBe('2021-01-01'))
-
-  test('day', () => expect(datetime(date, 'day')).toBe('1960-04-27'))
-  test('year', () => expect(datetime(date, 'year')).toBe('1960'))
-
-  test('3 digits year before 0', () => expect(datetime(foundationOfSyracuse, 'year')).toBe('-0733'))
-  test('3 digits year', () => expect(datetime(birthOfChineseEmpressWuZetian, 'year')).toBe('0624'))
-  test('5 digits year before 0', () => expect(datetime(firstCerealHarvest, 'year')).toBe('-23000'))
-  test('5 digits year after 9999', () => expect(datetime(year10k, 'year')).toBe('10000'))
-
-  test('month', () => expect(datetime(date, 'month')).toBe('1960-04'))
-  test('yearless', () => expect(datetime(date, 'yearless')).toBe('04-27'))
-  test('yearless and year before 0', () => expect(datetime(foundationOfSyracuse, 'yearless')).toBe('07-07'))
-  test('yearless and 3 digits year', () => expect(datetime(birthOfChineseEmpressWuZetian, 'yearless')).toBe('02-17'))
-
-  test('time', () => expect(datetime(date, 'time')).toBe('00:00'))
-  test('second', () => expect(datetime(date, 'second')).toBe('00:00:00'))
-  test('ms', () => expect(datetime(date, 'ms')).toBe('00:00:00.000'))
-
-  test('datetime', () => expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00'))
-  test('datetime second', () => expect(datetime(date, 'datetime second')).toBe('1960-04-27T00:00:00'))
-  test('datetime ms', () => expect(datetime(date, 'datetime ms')).toBe('1960-04-27T00:00:00.000'))
-
-  test('week on 1960-04-27', () => expect(datetime(date, 'week')).toBe('1960-W17'))
-  test('week on 2021-01-01', () => expect(datetime(january1st, 'week')).toBe('2021-W53'))
-  test('week on 2021-01-11', () => expect(datetime(january11th, 'week')).toBe('2021-W02'))
-  test('week on 2021-01-19', () => expect(datetime(january19th, 'week')).toBe('2021-W03'))
-  test('week on 2020-12-31', () => expect(datetime(december31th2020, 'week')).toBe('2020-W53'))
-  test('week on 2021-12-31', () => expect(datetime(december31th2021, 'week')).toBe('2021-W52'))
-
-  // These ones can’t be tested providing an exact value as the output depends on client timezone.
-
-  test('time utc', () => expect(datetime(date, 'time utc')).toBe(date.toJSON().substr(11, 5) + 'Z'))
-  test('second utc', () => expect(datetime(date, 'second utc')).toBe(date.toJSON().substr(11, 8) + 'Z'))
-  test('ms utc', () => expect(datetime(date, 'ms utc')).toBe(date.toJSON().substr(11, 12) + 'Z'))
-
-  test('datetime utc', () => expect(datetime(date, 'datetime utc')).toBe(date.toJSON().substr(0, 16) + 'Z'))
-  test('datetime second utc', () => expect(datetime(date, 'datetime second utc')).toBe(date.toJSON().substr(0, 19) + 'Z'))
-  test('datetime ms utc', () => expect(datetime(date, 'datetime ms utc')).toBe(date.toJSON()))
-
-  test('unsupported precision', () => expect(datetime(date, 'n00t')).toBe('1960-04-27'))
-})
-
-describe('utc', () => {
-  test('is a function', () => expect(utc).toBeInstanceOf(Function))
-  test('wrong type', () => expect(() => utc(123)).toThrow(TypeError))
-  test('()', () => expect(utc()).toBe(utc((new Date()))))
-
-  // These ones can’t be tested providing an exact value as the output depends on client timezone.
-  test('no precision', () => expect(utc(date)).toBe(date.toJSON().substr(0, 16) + 'Z'))
-  test('time', () => expect(utc(date, 'time')).toBe(date.toJSON().substr(11, 5) + 'Z'))
-  test('second', () => expect(utc(date, 'second')).toBe(date.toJSON().substr(11, 8) + 'Z'))
-  test('ms', () => expect(utc(date, 'ms')).toBe(date.toJSON().substr(11, 12) + 'Z'))
-  test('datetime', () => expect(utc(date, 'datetime')).toBe(date.toJSON().substr(0, 16) + 'Z'))
-  test('datetime second', () => expect(utc(date, 'datetime second')).toBe(date.toJSON().substr(0, 19) + 'Z'))
-  test('datetime ms', () => expect(utc(date, 'datetime ms')).toBe(date.toJSON()))
-
-  test('unsupported precision', () => expect(utc(date, 'n00t')).toBe('1960-04-27'))
-})
-
-describe('duration', () => {
-  const durationObject = { w: 3, d: 5, h: 10, m: 43, s: 2.61 }
-  const durationWithTooHighValues = { w: 3, d: 19, h: 36, m: 53, s: 175.3 }
-  const durationWithDecimal = { w: 3, d: 22, h: 48, m: 53, s: 175.3 }
-  const durationInHours = { h: 17 }
-  const durationInDays = { d: 43 }
-
-  test('is a function', () => expect(duration).toBeInstanceOf(Function))
-  test('()', () => expect(() => duration(null)).toThrow())
-  test('()', () => expect(duration()).toBe('PT0S'))
-  test('empty object {}', () => expect(duration({})).toBe('PT0S'))
-  test('empty object {}', () => expect(duration({}, false)).toBe('PT0S'))
-
-  test('complete object', () => expect(duration(durationObject)).toBe('P3W5DT10H43M2.61S'))
-  test('complete object with too high values', () => expect(duration(durationWithTooHighValues)).toBe('P5W6DT12H55M55.3S'))
-  test('decimals', () => expect(duration(durationWithDecimal)).toBe('P6W3DT55M55.3S'))
-  test('hours only', () => expect(duration(durationInHours)).toBe('PT17H'))
-  test('days only', () => expect(duration(durationInDays)).toBe('P6W1D'))
-
-  test('complete object without converting the excess', () => expect(duration(durationObject, false)).toBe('P3W5DT10H43M2.61S'))
-  test('complete object with too high values without converting the excess', () => expect(duration(durationWithTooHighValues, false)).toBe('P3W19DT36H53M175.3S'))
-  test('hours only without converting the excess', () => expect(duration(durationInHours, false)).toBe('PT17H'))
-  test('days only without converting the excess', () => expect(duration(durationInDays, false)).toBe('P43D'))
-})
-
-describe('tzOffset', () => {
-  test('is a function', () => expect(tzOffset).toBeInstanceOf(Function))
-  test('0', () => expect(tzOffset(0)).toBe('Z'))
-  test('-3', () => expect(tzOffset(-3)).toBe('-03:00'))
-  test('0, -30', () => expect(tzOffset(0, -30)).toBe('-00:30'))
-  test('0, 30', () => expect(tzOffset(0, 30)).toBe('+00:30'))
-  test('1', () => expect(tzOffset(1)).toBe('+01:00'))
-  test('-4.5', () => expect(tzOffset(-4.5)).toBe('-04:30'))
-  test('4, 30', () => expect(tzOffset(4, 30)).toBe('+04:30'))
-  test('12, 45', () => expect(tzOffset(12, 45)).toBe('+12:45'))
-  test('12.75', () => expect(tzOffset(12.75)).toBe('+12:45'))
-  test('-8', () => expect(tzOffset(-8)).toBe('-08:00'))
-  test('2, -200', () => expect(tzOffset(2, -200)).toBe('-01:20'))
-  test('-35', () => expect(tzOffset(-35)).toBe('-11:00'))
-  test('62.75', () => expect(tzOffset(62.75)).toBe('+14:45'))
-  test('-12, 0, true', () => expect(tzOffset(-12, 0, true)).toBe('-12:00'))
-  test('-12, -20, true', () => expect(tzOffset(-12, -20, true)).toBe('+11:40'))
-  test('-13, -20, true', () => expect(tzOffset(-13, -20, true)).toBe('+10:40'))
-  test('14, 45, true', () => expect(tzOffset(14, 45, true)).toBe('-09:15'))
-  test('62.75, 0, true', () => expect(tzOffset(62.75, 0, true)).toBe('-09:15'))
-  test('non number', () => expect(() => tzOffset('Z')).toThrow(TypeError))
-
-  // This one can’t be tested providing an exact value as the output depends on client timezone and daylight time saving.
-  test('()', () => expect(tzOffset()).toBe(tzOffset(0, tzOffsetInMinutes)))
-})
-
-describe('datetimeTz', () => {
-  test('is a function', () => expect(datetimeTz).toBeInstanceOf(Function))
-  test('wrong type', () => expect(() => datetimeTz(123)).toThrow(TypeError))
-
-  test('()', () => expect(datetimeTz()).toBe(datetimeTz((new Date()))))
-
-  test('no precision', () => expect(datetimeTz(date)).toBe('1960-04-27T00:00' + tzOffset(0, tzOffsetInMinutes)))
-  test('no offset', () => expect(datetimeTz(date, 'time')).toBe('00:00' + tzOffset(0, tzOffsetInMinutes)))
-
-  test('time 0', () => expect(datetimeTz(date, 'time', 0)).toBe('00:00Z'))
-  test('time +4', () => expect(datetimeTz(date, 'time', 4)).toBe('00:00+04:00'))
-  test('second -3', () => expect(datetimeTz(date, 'second', -3)).toBe('00:00:00-03:00'))
-  test('ms +3.5', () => expect(datetimeTz(date, 'ms', 3.5)).toBe('00:00:00.000+03:30'))
-
-  test('datetime +12:45', () => expect(datetimeTz(date, 'datetime', 12, 45)).toBe('1960-04-27T00:00+12:45'))
-  test('datetime +17, 30, true', () => expect(datetimeTz(date, 'datetime', 17, 30, true)).toBe('1960-04-27T00:00-06:30'))
-  test('datetime second -6', () => expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00'))
-  test('datetime ms +1', () => expect(datetimeTz(date, 'datetime ms', 1)).toBe('1960-04-27T00:00:00.000+01:00'))
-
-  // These ones can’t be tested providing an exact value as the output depends on client timezone.
-
-  test('time utc', () => expect(datetimeTz(date, 'time utc')).toBe(date.toJSON().substr(11, 5) + 'Z'))
-  test('second utc', () => expect(datetimeTz(date, 'second utc')).toBe(date.toJSON().substr(11, 8) + 'Z'))
-  test('ms utc', () => expect(datetimeTz(date, 'ms utc')).toBe(date.toJSON().substr(11, 12) + 'Z'))
-
-  test('datetime utc', () => expect(datetimeTz(date, 'datetime utc')).toBe(date.toJSON().substr(0, 16) + 'Z'))
-  test('datetime second utc', () => expect(datetimeTz(date, 'datetime second utc')).toBe(date.toJSON().substr(0, 19) + 'Z'))
-  test('datetime ms utc', () => expect(datetimeTz(date, 'datetime ms utc')).toBe(date.toJSON()))
-})
-
-describe('setTzSeparator', () => {
-  test('is a function', () => expect(setTzSeparator).toBeInstanceOf(Function))
-
-  test('no timezone separator', () => {
-    setTzSeparator()
-    expect(tzOffset(3)).toBe('+0300')
-  })
-
-  test('empty string timezone separator', () => {
-    setTzSeparator('')
-    expect(tzOffset(3)).toBe('+0300')
-  })
-
-  test(': as timezone separator', () => {
-    setTzSeparator(':')
-    expect(tzOffset(3)).toBe('+03:00')
-  })
-
-  test('invalid separator', () => expect(() => setTzSeparator(42)).toThrow(Error))
-
-  test('empty string timezone separator with datetimeTz', () => {
-    setTzSeparator('')
-    expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-0600')
-  })
-})
-
-describe('setTzConfig', () => {
-  test('is a function', () => expect(setTzConfig).toBeInstanceOf(Function))
-
-  test('empty string timezone separator using setTzConfig', () => {
-    setTzConfig({ separator: '' })
-    expect(tzOffset(3)).toBe('+0300')
-  })
-
-  test(': as timezone separator using setTzConfig', () => {
-    setTzConfig({ separator: ':' })
-    expect(tzOffset(3)).toBe('+03:00')
-  })
-
-  test('invalid separator using setTzConfig', () => expect(() => setTzConfig({ separator: 42 })).toThrow(Error))
-
-  test(': as timezone separator with datetimeTz', () => {
-    setTzConfig({ separator: ':' })
-    expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00')
-  })
-})
-
-describe('weekNumber', () => {
-  test('is a function', () => expect(weekNumber).toBeInstanceOf(Function))
-  test('1960-04-27', () => expect(weekNumber(date)).toBe(17))
-  test('2021-01-01', () => expect(weekNumber(january1st)).toBe(53))
-  test('2021-01-11', () => expect(weekNumber(january11th)).toBe(2))
-  test('2020-12-31', () => expect(weekNumber(december31th2020)).toBe(53))
-  test('2021-12-31', () => expect(weekNumber(december31th2021)).toBe(52))
-})
-
-describe('daysBetween', () => {
-  test('is a function', () => expect(daysBetween).toBeInstanceOf(Function))
-  test('1/1 and 11/1', () => expect(daysBetween(january1st, january11th)).toBe(10))
-  test('11/1 and 1/1', () => expect(daysBetween(january11th, january1st)).toBe(-10))
-  test('same day, different time', () => expect(daysBetween(december31th2020, december31th2020OneMinuteLater)).toBe(0))
-})
-
-const summer = new DateTime(2021, 5, 21)
-const twoWeeksAfterSummer = new DateTime(2021, 6, 5)
-
-describe('DateTime class', () => {
-  test('extends Date', () => expect(summer).toBeInstanceOf(Date))
-  test('.getWeek', () => expect(summer.getWeek()).toBe(25))
-  test(".to('day')", () => expect(summer.to('day')).toBe('2021-06-21'))
-  test('.setWeek', () => expect(summer.setWeek(27)).toBe(twoWeeksAfterSummer.getTime()))
-  test(".to('month')", () => expect(twoWeeksAfterSummer.to('month')).toBe('2021-07'))
-  test('weeks is changed when day changes', () => {
-    summer.setDate(summer.getDate() + 14)
-    return expect(summer.getWeek()).toBe(29)
-  })
-})
-
-// These tests are at the end as they change the widely-used separator config.
-
-describe('setTimeSeparator', () => {
-  test('is a function', () => expect(setTimeSeparator).toBeInstanceOf(Function))
-
-  test('no time separator', () => {
-    setTimeSeparator()
-    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
-  })
-
-  test('T as time separator', () => {
-    setTimeSeparator('T')
-    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
-  })
-
-  test('space as time separator', () => {
-    setTimeSeparator(' ')
-    expect(datetime(date, 'datetime')).toBe('1960-04-27 00:00')
-  })
-
-  test('invalid separator', () => expect(() => setTimeSeparator(42)).toThrow(Error))
-})
-
-describe('setConfig', () => {
-  test('is a function', () => expect(setConfig).toBeInstanceOf(Function))
-
-  test('T as time separator using setConfig', () => {
-    setConfig({ separator: 'T' })
-    expect(datetime(date, 'datetime')).toBe('1960-04-27T00:00')
-  })
-
-  test('space as time separator using setConfig', () => {
-    setConfig({ separator: ' ' })
-    expect(datetime(date, 'datetime')).toBe('1960-04-27 00:00')
-  })
-
-  test('invalid separator using setConfig', () => expect(() => setConfig({ separator: 42 })).toThrow(Error))
-})

From 78c218ae81a6a2fff79c4cf96a5abf8f26844c06 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 11:02:00 +0200
Subject: [PATCH 18/39] Add missing date utils in Temporal implementation

---
 src/temporal/datetime.js   | 2 +-
 src/temporal/duration.js   | 1 -
 src/temporal/utils/date.js | 8 ++++++++
 3 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index 1faaf1d..ae86727 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -24,7 +24,7 @@ export function datetime(date = new Date(), precision = 'day') {
     throw new TypeError('Input date should be of type `Date`')
   }
 
-  const instant = date.toTemporalInstant();
+  const instant = date.toTemporalInstant()
   const zoned = instant.toZonedDateTimeISO(Temporal.Now.timeZoneId())
 
   const yearISO = y => {
diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index 470eedd..2fee95e 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -4,7 +4,6 @@
  * - add support for sub-second units (ms, mis, ns)
  */
 
-
 // Date.prototype.toTemporalInstant = toTemporalInstant
 import { Temporal } from '@js-temporal/polyfill'
 import { round } from './utils/math'
diff --git a/src/temporal/utils/date.js b/src/temporal/utils/date.js
index ee4fb43..9c707f0 100644
--- a/src/temporal/utils/date.js
+++ b/src/temporal/utils/date.js
@@ -28,3 +28,11 @@ export const daysBetween = (date, furtherDate) => dateToPlainDate(date).until(da
  */
 export const weekNumber = date => dateToPlainDate(date).weekOfYear
 // export const weekNumber = date => date.toTemporalInstant().toZonedDateTimeISO('UTC').weekOfYear
+
+/**
+ * Get the day index of the week, but Sunday is now 7 instead of 0.
+ *
+ * @param {Date} date
+ * @returns {number}
+ */
+export const getNormalizeDay = date => date.getDay() || 7

From e8e094ec29feda5c76ede060350e6186ebdcb552 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 14:46:57 +0200
Subject: [PATCH 19/39] Update day index util for `Temporal`

---
 src/temporal/datetime.test.js | 6 +++---
 src/temporal/utils/date.js    | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/temporal/datetime.test.js b/src/temporal/datetime.test.js
index 8e33489..4a7d52b 100644
--- a/src/temporal/datetime.test.js
+++ b/src/temporal/datetime.test.js
@@ -1,7 +1,7 @@
 import { describe, expect, test } from 'vitest'
 
 import { datetime, datetimeTz, tzOffset, utc } from './index.js'
-import { getNormalizeDay } from './utils/date.js'
+import { getTemporalDay } from './utils/date.js'
 
 const togoIndependanceDay = new Date(1960, 3, 27)
 const date = togoIndependanceDay // alias for the sake of brevity
@@ -90,7 +90,7 @@ describe('datetime', () => {
 
     // 1st day of the year is after Thurdsay
     test('week on 2021-01-01 is 2020-W53', () => {
-      expect(getNormalizeDay(january1st2021)).toBeGreaterThan(4)
+      expect(getTemporalDay(january1st2021)).toBeGreaterThan(4)
       expect(datetime(january1st2021, 'week')).toBe('2020-W53')
     })
 
@@ -109,7 +109,7 @@ describe('datetime', () => {
     // 1st day of the month is after Thurdsay, but it’s not in January
     test('week on 2021-03-01 is 2021-W17', () => {
       const march1st2021 = new Date(2021, 4, 1)
-      expect(getNormalizeDay(march1st2021)).toBeGreaterThan(4)
+      expect(getTemporalDay(march1st2021)).toBeGreaterThan(4)
       expect(datetime(march1st2021, 'week')).toBe('2021-W17')
     })
 
diff --git a/src/temporal/utils/date.js b/src/temporal/utils/date.js
index 9c707f0..9e594e2 100644
--- a/src/temporal/utils/date.js
+++ b/src/temporal/utils/date.js
@@ -35,4 +35,4 @@ export const weekNumber = date => dateToPlainDate(date).weekOfYear
  * @param {Date} date
  * @returns {number}
  */
-export const getNormalizeDay = date => date.getDay() || 7
+export const getTemporalDay = date => dateToPlainDate(date).dayOfWeek

From 9f13bbf1e485311d8ac01ff7e7715dfd483864f6 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 14:50:25 +0200
Subject: [PATCH 20/39] Fix `datetime` with `'week'` precision

---
 src/temporal/datetime.js | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index ae86727..da9f5a0 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -1,4 +1,3 @@
-import { weekNumber } from './utils/date.js'
 import { p } from './utils/string.js'
 import { tzOffset } from './timezone.js'
 import { config } from './config/datetime'
@@ -53,7 +52,7 @@ export function datetime(date = new Date(), precision = 'day') {
     month: () => Temporal.PlainYearMonth.from(zoned), // 1960-04
     day: () => Temporal.PlainDate.from(zoned), // 1960-04-27
 
-    week: () => date.getFullYear() + '-W' + p(weekNumber(date)), // 1960-W17
+    week: () => zoned.yearOfWeek + '-W' + p(zoned.weekOfYear), // 1960-W17
     yearless: () => Temporal.PlainMonthDay.from(zoned), // 04-27
 
     time: () => Temporal.PlainTime.from(zoned).toString({ smallestUnit: 'minutes' }), // 00:00

From e95470565a9d1e2616f2feb49664ebe5d2c34c8d Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 14:54:01 +0200
Subject: [PATCH 21/39] Lint Temporal implementation

---
 src/temporal/datetime-class.js | 2 +-
 src/temporal/utils/temporal.js | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/temporal/datetime-class.js b/src/temporal/datetime-class.js
index 7c63256..1fb9dd0 100644
--- a/src/temporal/datetime-class.js
+++ b/src/temporal/datetime-class.js
@@ -1,6 +1,6 @@
 import { MILLISECONDS_PER_WEEK } from './utils/const.js'
 import { datetime, weekNumber } from './index.js'
-import { Temporal } from '@js-temporal/polyfill'
+// import { Temporal } from '@js-temporal/polyfill'
 
 export class DateTime extends Date {
 
diff --git a/src/temporal/utils/temporal.js b/src/temporal/utils/temporal.js
index c7617dc..b57aab9 100644
--- a/src/temporal/utils/temporal.js
+++ b/src/temporal/utils/temporal.js
@@ -1,3 +1,4 @@
-import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+// import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
+import { Temporal } from '@js-temporal/polyfill'
 
 export const dateToPlainDate = d => new Temporal.PlainDate(d.getFullYear(), d.getMonth() + 1, d.getDate())

From cf2f59c78d47cb371ddc71a812f50b977bbea045 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 15:39:37 +0200
Subject: [PATCH 22/39] Remove unused `Temporal` imports

---
 src/temporal/datetime-class.js | 1 -
 src/temporal/utils/temporal.js | 1 -
 2 files changed, 2 deletions(-)

diff --git a/src/temporal/datetime-class.js b/src/temporal/datetime-class.js
index 1fb9dd0..6886253 100644
--- a/src/temporal/datetime-class.js
+++ b/src/temporal/datetime-class.js
@@ -1,6 +1,5 @@
 import { MILLISECONDS_PER_WEEK } from './utils/const.js'
 import { datetime, weekNumber } from './index.js'
-// import { Temporal } from '@js-temporal/polyfill'
 
 export class DateTime extends Date {
 
diff --git a/src/temporal/utils/temporal.js b/src/temporal/utils/temporal.js
index b57aab9..2d9170d 100644
--- a/src/temporal/utils/temporal.js
+++ b/src/temporal/utils/temporal.js
@@ -1,4 +1,3 @@
-// import { Temporal, Intl, toTemporalInstant } from '@js-temporal/polyfill'
 import { Temporal } from '@js-temporal/polyfill'
 
 export const dateToPlainDate = d => new Temporal.PlainDate(d.getFullYear(), d.getMonth() + 1, d.getDate())

From 8d6475ce0c1db7056b71cfaef9e8674efaa02957 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 16:48:49 +0200
Subject: [PATCH 23/39] Add `temporal-polyfill` to enable testing against
 multiple polyfills

---
 package.json   |  3 ++-
 pnpm-lock.yaml | 13 +++++++++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 0fdf21d..28d44df 100644
--- a/package.json
+++ b/package.json
@@ -68,6 +68,7 @@
     }
   },
   "peerDependencies": {
-    "@js-temporal/polyfill": "^0.4.4"
+    "@js-temporal/polyfill": "^0.4.4",
+    "temporal-polyfill": "^0.2.4"
   }
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index d8ea13c..910f37f 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -12,6 +12,9 @@ dependencies:
   '@js-temporal/polyfill':
     specifier: ^0.4.4
     version: 0.4.4
+  temporal-polyfill:
+    specifier: ^0.2.4
+    version: 0.2.4
 
 devDependencies:
   '@eslint/js':
@@ -2415,6 +2418,16 @@ packages:
     engines: {node: '>= 0.4'}
     dev: true
 
+  /temporal-polyfill@0.2.4:
+    resolution: {integrity: sha512-WA5p0CjQTkMjF9m8sP4wSYgpqI8m2d4q7wPUyaJOWhy4bI9mReLb2yGvTV4qf/DPMTe6H6M/Dig5KmTMB7ev6Q==}
+    dependencies:
+      temporal-spec: 0.2.4
+    dev: false
+
+  /temporal-spec@0.2.4:
+    resolution: {integrity: sha512-lDMFv4nKQrSjlkHKAlHVqKrBG4DyFfa9F74cmBZ3Iy3ed8yvWnlWSIdi4IKfSqwmazAohBNwiN64qGx4y5Q3IQ==}
+    dev: false
+
   /test-exclude@6.0.0:
     resolution: {integrity: sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==}
     engines: {node: '>=8'}

From 783729ce412f1159490f714fcd8f52bfaf910ba0 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 16:51:33 +0200
Subject: [PATCH 24/39] Add commented imports to `temporal-polyfill`

---
 src/temporal/datetime.js       | 1 +
 src/temporal/duration.js       | 1 +
 src/temporal/timezone.js       | 1 +
 src/temporal/utils/temporal.js | 1 +
 4 files changed, 4 insertions(+)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index da9f5a0..2e55454 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -2,6 +2,7 @@ import { p } from './utils/string.js'
 import { tzOffset } from './timezone.js'
 import { config } from './config/datetime'
 import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
+// import { Temporal, toTemporalInstant } from 'temporal-polyfill'
 
 Date.prototype.toTemporalInstant = toTemporalInstant
 
diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index 2fee95e..d13cf69 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -6,6 +6,7 @@
 
 // Date.prototype.toTemporalInstant = toTemporalInstant
 import { Temporal } from '@js-temporal/polyfill'
+// import { Temporal } from 'temporal-polyfill'
 import { round } from './utils/math'
 
 /**
diff --git a/src/temporal/timezone.js b/src/temporal/timezone.js
index 277e1f5..99a8df9 100644
--- a/src/temporal/timezone.js
+++ b/src/temporal/timezone.js
@@ -9,6 +9,7 @@ import { p } from './utils/string.js'
 import { tzConfig } from './config/tz.js'
 
 import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
+// import { Temporal, toTemporalInstant } from 'temporal-polyfill'
 
 Date.prototype.toTemporalInstant = toTemporalInstant
 
diff --git a/src/temporal/utils/temporal.js b/src/temporal/utils/temporal.js
index 2d9170d..f0cc91d 100644
--- a/src/temporal/utils/temporal.js
+++ b/src/temporal/utils/temporal.js
@@ -1,3 +1,4 @@
 import { Temporal } from '@js-temporal/polyfill'
+// import { Temporal } from 'temporal-polyfill'
 
 export const dateToPlainDate = d => new Temporal.PlainDate(d.getFullYear(), d.getMonth() + 1, d.getDate())

From 8032721e8656decc11baec733ad7f11e40544c92 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 17:23:25 +0200
Subject: [PATCH 25/39] Remove unused code

---
 src/temporal/duration.js | 1 -
 src/temporal/timezone.js | 6 ++----
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index d13cf69..56d2c42 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -4,7 +4,6 @@
  * - add support for sub-second units (ms, mis, ns)
  */
 
-// Date.prototype.toTemporalInstant = toTemporalInstant
 import { Temporal } from '@js-temporal/polyfill'
 // import { Temporal } from 'temporal-polyfill'
 import { round } from './utils/math'
diff --git a/src/temporal/timezone.js b/src/temporal/timezone.js
index 99a8df9..17740cc 100644
--- a/src/temporal/timezone.js
+++ b/src/temporal/timezone.js
@@ -8,10 +8,8 @@ import {
 import { p } from './utils/string.js'
 import { tzConfig } from './config/tz.js'
 
-import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
-// import { Temporal, toTemporalInstant } from 'temporal-polyfill'
-
-Date.prototype.toTemporalInstant = toTemporalInstant
+import { Temporal } from '@js-temporal/polyfill'
+// import { Temporal } from 'temporal-polyfill'
 
 /**
  * Create `datetime="+04:00"` timezone attribute for `<time>`.

From 219389c794fc067bd0a8b8e67e0fa37b4a5f662d Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 18:43:57 +0200
Subject: [PATCH 26/39] Add missing file extension in JS imports

---
 src/temporal/datetime.js   | 2 +-
 src/temporal/duration.js   | 2 +-
 src/temporal/utils/date.js | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index 2e55454..5303c61 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -1,6 +1,6 @@
 import { p } from './utils/string.js'
 import { tzOffset } from './timezone.js'
-import { config } from './config/datetime'
+import { config } from './config/datetime.js'
 import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
 // import { Temporal, toTemporalInstant } from 'temporal-polyfill'
 
diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index 56d2c42..4074757 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -6,7 +6,7 @@
 
 import { Temporal } from '@js-temporal/polyfill'
 // import { Temporal } from 'temporal-polyfill'
-import { round } from './utils/math'
+import { round } from './utils/math.js'
 
 /**
  * Create `datetime="P3DT2H8M32.541S"` duration attribute for `<time>`.
diff --git a/src/temporal/utils/date.js b/src/temporal/utils/date.js
index 9e594e2..fedcb7b 100644
--- a/src/temporal/utils/date.js
+++ b/src/temporal/utils/date.js
@@ -4,7 +4,7 @@
  * - make sur to understand zoned datetime (https://tc39.es/proposal-temporal/docs/zoneddatetime.html#weekOfYear)
  */
 
-import { dateToPlainDate } from './temporal'
+import { dateToPlainDate } from './temporal.js'
 
 /**
  * Calculate the difference between 2 dates in days, discarding the time of day.

From f396e6609b168905ea1f400f038e7d2f77878eec Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 21:12:17 +0200
Subject: [PATCH 27/39] Add some notes in Temporal util

---
 src/temporal/utils/temporal.js | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/temporal/utils/temporal.js b/src/temporal/utils/temporal.js
index f0cc91d..1a7479b 100644
--- a/src/temporal/utils/temporal.js
+++ b/src/temporal/utils/temporal.js
@@ -1,4 +1,9 @@
 import { Temporal } from '@js-temporal/polyfill'
 // import { Temporal } from 'temporal-polyfill'
 
+// Date.prototype.toTemporalInstant = toTemporalInstant
+
 export const dateToPlainDate = d => new Temporal.PlainDate(d.getFullYear(), d.getMonth() + 1, d.getDate())
+
+/** @todo check https://tc39.es/proposal-temporal/docs/cookbook.html#date-only-values-legacy-date--temporalplaindate */
+// export const dateToPlainDate = d => d.toTemporalInstant().toZonedDateTimeISO(Temporal.Now.timeZoneId()).toPlainDate()

From 2985e0339edf889fb322a99d354410f895703c38 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 22:02:26 +0200
Subject: [PATCH 28/39] Destructure `Temporal` classes where it shorten the
 code

---
 src/temporal/datetime.js | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index 5303c61..ba07a93 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -24,8 +24,10 @@ export function datetime(date = new Date(), precision = 'day') {
     throw new TypeError('Input date should be of type `Date`')
   }
 
+  const { Now, PlainDate, PlainDateTime, PlainMonthDay, PlainTime, PlainYearMonth, } = Temporal
+
   const instant = date.toTemporalInstant()
-  const zoned = instant.toZonedDateTimeISO(Temporal.Now.timeZoneId())
+  const zoned = instant.toZonedDateTimeISO(Now.timeZoneId())
 
   const yearISO = y => {
 
@@ -48,21 +50,21 @@ export function datetime(date = new Date(), precision = 'day') {
   // const iso = date.toISOString();
 
   const temporalFormat = {
-    year: () => yearISO(Temporal.PlainYearMonth.from(zoned).year), // 1960
+    year: () => yearISO(PlainYearMonth.from(zoned).year), // 1960
     // year: () => date.getFullYear(), // 1960
-    month: () => Temporal.PlainYearMonth.from(zoned), // 1960-04
-    day: () => Temporal.PlainDate.from(zoned), // 1960-04-27
+    month: () => PlainYearMonth.from(zoned), // 1960-04
+    day: () => PlainDate.from(zoned), // 1960-04-27
 
     week: () => zoned.yearOfWeek + '-W' + p(zoned.weekOfYear), // 1960-W17
-    yearless: () => Temporal.PlainMonthDay.from(zoned), // 04-27
+    yearless: () => PlainMonthDay.from(zoned), // 04-27
 
-    time: () => Temporal.PlainTime.from(zoned).toString({ smallestUnit: 'minutes' }), // 00:00
-    second: () => Temporal.PlainTime.from(zoned), // 00:00:00
-    ms: () => Temporal.PlainTime.from(zoned).toString({ smallestUnit: 'milliseconds' }), // 00:00:00.123
+    time: () => PlainTime.from(zoned).toString({ smallestUnit: 'minutes' }), // 00:00
+    second: () => PlainTime.from(zoned), // 00:00:00
+    ms: () => PlainTime.from(zoned).toString({ smallestUnit: 'milliseconds' }), // 00:00:00.123
 
-    datetime: () => Temporal.PlainDateTime.from(zoned).toString({ smallestUnit: 'minutes' }), // 1960-04-27T00:00
-    'datetime second': () => Temporal.PlainDateTime.from(zoned), // 1960-04-27T00:00:00
-    'datetime ms': () => Temporal.PlainDateTime.from(zoned).toString({ smallestUnit: 'milliseconds' }), // 1960-04-27T00:00:00.123
+    datetime: () => PlainDateTime.from(zoned).toString({ smallestUnit: 'minutes' }), // 1960-04-27T00:00
+    'datetime second': () => PlainDateTime.from(zoned), // 1960-04-27T00:00:00
+    'datetime ms': () => PlainDateTime.from(zoned).toString({ smallestUnit: 'milliseconds' }), // 1960-04-27T00:00:00.123
 
     'datetime utc': () => instant.toString({ smallestUnit: 'minute' }), // 1960-04-26T23:00Z
     'datetime second utc': () => instant, // 1960-04-26T23:00:00Z

From ca6e4b76971e191512ce2233296476b5671caea1 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 19 Apr 2024 22:15:36 +0200
Subject: [PATCH 29/39] Update JSDoc in Temporal implementation

---
 src/temporal/config/datetime.js |  4 ++--
 src/temporal/config/tz.js       |  4 ++--
 src/temporal/datetime-class.js  |  7 +++++++
 src/temporal/datetime.js        | 18 +++++++++---------
 src/temporal/duration.js        | 26 ++++++++++++++------------
 src/temporal/timezone.js        |  6 +++---
 src/temporal/utils/date.js      |  5 ++++-
 src/temporal/utils/math.js      |  2 +-
 src/temporal/utils/string.js    |  2 +-
 9 files changed, 43 insertions(+), 31 deletions(-)

diff --git a/src/temporal/config/datetime.js b/src/temporal/config/datetime.js
index 69d3174..5e2ee8d 100644
--- a/src/temporal/config/datetime.js
+++ b/src/temporal/config/datetime.js
@@ -1,6 +1,6 @@
 /**
  * @typedef {Object} DateTimeOptions
- * @property {('T'|' ')=} separator
+ * @property {('T'|' ')} separator
  */
 
 /**
@@ -32,7 +32,7 @@ export const setConfig = options => {
 /**
  * Set separator between date and time
  *
- * @param {('T'|' ')=} separator
+ * @param {('T'|' ')} [separator=T]
  * @returns {DateTimeOptions}
  */
 export const setTimeSeparator = (separator = 'T') => setConfig({ separator })
diff --git a/src/temporal/config/tz.js b/src/temporal/config/tz.js
index b7b1214..08fdc53 100644
--- a/src/temporal/config/tz.js
+++ b/src/temporal/config/tz.js
@@ -1,6 +1,6 @@
 /**
  * @typedef {Object} TimezoneOptions
- * @property {(':'|'')=} separator
+ * @property {(':'|'')} separator
  */
 
 /**
@@ -32,7 +32,7 @@ export const setTzConfig = options => {
 /**
  * Set timezone separator
  *
- * @param {(':'|'')=} separator
+ * @param {(':'|'')} [separator='']
  * @returns {TimezoneOptions}
  */
 export const setTzSeparator = (separator = '') => setTzConfig({ separator })
diff --git a/src/temporal/datetime-class.js b/src/temporal/datetime-class.js
index 6886253..f7e0e1c 100644
--- a/src/temporal/datetime-class.js
+++ b/src/temporal/datetime-class.js
@@ -11,6 +11,10 @@ export class DateTime extends Date {
    * - the first week of the year includes a Thursday;
    * - week numbers go from 1 to 53 (https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#week-number-of-the-last-day).
    *
+   * @todo: cache the result of weekNumber as long as date isn’t changed:
+   * compare the current object timestamp wuth a stored/cached one in
+   * order to decide if the cache is stale.
+   *
    * @returns {number}
    */
   getWeek = () => weekNumber(this)
@@ -18,6 +22,9 @@ export class DateTime extends Date {
   /**
    * Set the week number.
    *
+   * If the week number is outside the year range, the `DateTime` object is
+   * updated accordingly.
+   *
    * @param {number} weekNumber
    * @returns {number} Milliseconds since midnight on January 1, 1970, UTC
    */
diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index ba07a93..16141bf 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -15,8 +15,8 @@ Date.prototype.toTemporalInstant = toTemporalInstant
  *
  * See also: https://www.brucelawson.co.uk/2012/best-of-time/
  *
- * @param {Date=} date
- * @param {Precision=} precision
+ * @param {Date} [date=new Date()] - default to now
+ * @param {Precision} [precision='day']
  * @returns {string}
  */
 export function datetime(date = new Date(), precision = 'day') {
@@ -88,8 +88,8 @@ export function datetime(date = new Date(), precision = 'day') {
  * - `utc(someDate, 'somePrecision')`
  *
  *
- * @param {Date=} date
- * @param {'datetime'|'datetime second'|'datetime ms'|'time'|'second'|'ms'} precision
+ * @param {Date} [date=new Date()] - default to now
+ * @param {'datetime'|'datetime second'|'datetime ms'|'time'|'second'|'ms'} [precision=datetime]
  * @returns {string}
  */
 export const utc = (date = new Date(), precision = 'datetime') =>
@@ -98,11 +98,11 @@ export const utc = (date = new Date(), precision = 'datetime') =>
 /**
  * Create `datetime="2021-12-02T17:34-06:00"` attribute for `<time>`.
  *
- * @param {Date=} date
- * @param {Precision=} precision
- * @param {number=} offsetHours
- * @param {number=} offsetMinutes
- * @param {boolean=} inRealLifeBoundaries
+ * @param {Date} [date=new Date()] - default to now
+ * @param {Precision} [precision=datetime]
+ * @param {number} [offsetHours=0]
+ * @param {number} [offsetMinutes=0]
+ * @param {boolean} [inRealLifeBoundaries=false]
  * @returns {string}
  */
 export function datetimeTz(
diff --git a/src/temporal/duration.js b/src/temporal/duration.js
index 4074757..b6aa8b1 100644
--- a/src/temporal/duration.js
+++ b/src/temporal/duration.js
@@ -16,8 +16,10 @@ import { round } from './utils/math.js'
  *
  * See also: https://www.brucelawson.co.uk/2012/best-of-time/
  *
- * @param {DurationObject} duration
- * @param {boolean} convertExcess
+ * @param {DurationObject} [duration={}]
+ * @param {boolean} [convertExcess=true] Convert overflow values to their
+ *                                       higher unit (e.g. `{ m: 90 }`
+ *                                       equals `{ h: 1, m: 30 }`.
  * @returns {string}
  */
 export function duration(duration = {}, convertExcess = true) {
@@ -71,16 +73,16 @@ export function duration(duration = {}, convertExcess = true) {
 /**
  * @typedef {Object} DurationObject
  *
- * @property {number=} y – Number of years
- * @property {number=} mo – Number of months
- * @property {number=} w – Number of weeks
- * @property {number=} d – Number of days
- * @property {number=} h – Number of hours
- * @property {number=} m – Number of minutes
- * @property {number=} s – Number of seconds
- * @property {number=} ms – Number of milliseconds
- * @property {number=} mis – Number of microseconds
- * @property {number=} ns – Number of nanoseconds
+ * @property {number} [y=0] – Number of years
+ * @property {number} [mo=0] – Number of months
+ * @property {number} [w=0] – Number of weeks
+ * @property {number} [d=0] – Number of days
+ * @property {number} [h=0] – Number of hours
+ * @property {number} [m=0] – Number of minutes
+ * @property {number} [s=0] – Number of seconds
+ * @property {number} [ms=0] – Number of milliseconds
+ * @property {number} [mis=0] – Number of microseconds
+ * @property {number} [ns=0] – Number of nanoseconds
 *
  * The chosen propertie abbreviations follow the spec algorithm:
  * https://tc39.es/proposal-temporal/#sec-temporal.duration
diff --git a/src/temporal/timezone.js b/src/temporal/timezone.js
index 17740cc..1febd02 100644
--- a/src/temporal/timezone.js
+++ b/src/temporal/timezone.js
@@ -17,9 +17,9 @@ import { Temporal } from '@js-temporal/polyfill'
  * https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#concept-timezone
  * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTimeElement/datetime
  *
- * @param {number=} hours The number of hours from UTC
- * @param {number=} minutes The number of minutes from UTC
- * @param {boolean=} inRealLifeBoundaries Make sure the timezone stays in spec boundaries.
+ * @param {number} [hours=0] The number of hours from UTC
+ * @param {number} [minutes=0] The number of minutes from UTC
+ * @param {boolean} [inRealLifeBoundaries=false] Make sure the timezone stays in spec boundaries.
  * @returns {string}
  */
 export function tzOffset(hours = 0, minutes = 0, inRealLifeBoundaries = false) {
diff --git a/src/temporal/utils/date.js b/src/temporal/utils/date.js
index fedcb7b..f0ee775 100644
--- a/src/temporal/utils/date.js
+++ b/src/temporal/utils/date.js
@@ -9,6 +9,9 @@ import { dateToPlainDate } from './temporal.js'
 /**
  * Calculate the difference between 2 dates in days, discarding the time of day.
  *
+ * @todo Consider renaming it daysDiff when there’s a breaking change, since it
+ * can returns a negative number when date > furtherDate.
+ *
  * @param {Date} date The oldest of the two dates.
  * @param {Date} furtherDate Another date, greater than the first one.
  * @returns {number}
@@ -30,7 +33,7 @@ export const weekNumber = date => dateToPlainDate(date).weekOfYear
 // export const weekNumber = date => date.toTemporalInstant().toZonedDateTimeISO('UTC').weekOfYear
 
 /**
- * Get the day index of the week, but Sunday is now 7 instead of 0.
+ * Get the day index of the week, Monday is 1 and Sunday is 7.
  *
  * @param {Date} date
  * @returns {number}
diff --git a/src/temporal/utils/math.js b/src/temporal/utils/math.js
index fab1220..7d51717 100644
--- a/src/temporal/utils/math.js
+++ b/src/temporal/utils/math.js
@@ -2,7 +2,7 @@
  * Round a number to the provided precision.
  *
  * @param {number} number The number to round.
- * @param {number=} precision The rounding precision.
+ * @param {number} [precision=0] The rounding precision.
  * @returns {number}
  */
 export const round = (number, precision = 0) => {
diff --git a/src/temporal/utils/string.js b/src/temporal/utils/string.js
index 23fa33c..9116a75 100644
--- a/src/temporal/utils/string.js
+++ b/src/temporal/utils/string.js
@@ -2,7 +2,7 @@
  * padStart a stringable variable by the provided number of 0.
  *
  * @param {*} value A stringable value (string, number…).
- * @param {number=} length The number of 0 at the beginning of the result.
+ * @param {number} [length=2] The number of 0 at the beginning of the result.
  * @returns {string}
  */
 export const p = (value, length = 2) => value.toString().padStart(length, '0')

From f1c6a0e8cdc5f9485205166af9688cc4a7db7e5e Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 20 Apr 2024 14:38:15 +0200
Subject: [PATCH 30/39] Update `Temporal` timezone test to be on par with
 `main`

---
 src/temporal/timezone.test.js | 60 +++++++++++++++++++++++++++++------
 src/temporal/utils/const.js   | 16 ++++++++--
 2 files changed, 63 insertions(+), 13 deletions(-)

diff --git a/src/temporal/timezone.test.js b/src/temporal/timezone.test.js
index ef5afba..574fd3c 100644
--- a/src/temporal/timezone.test.js
+++ b/src/temporal/timezone.test.js
@@ -21,49 +21,89 @@ describe('tzOffset', () => {
 
   describe('in boundaries', () => {
 
-    test('tzOffset(-8)      is -08:00', () => {
+    test('tzOffset(-23, -59)  is -23:59', () => {
+      expect(tzOffset(-23, -59)).toBe('-23:59')
+    })
+
+    test('tzOffset(-9, -30)   is -09:30', () => {
+      expect(tzOffset(-9, -30)).toBe('-09:30')
+    })
+
+    test('tzOffset(-9, 30)    is -08:30', () => {
+      expect(tzOffset(-9, 30)).toBe('-08:30')
+    })
+
+    test('tzOffset(-8)        is -08:00', () => {
       expect(tzOffset(-8)).toBe('-08:00')
     })
 
-    test('tzOffset(-4.5)    is -04:30', () => {
+    test('tzOffset(-4.5)      is -04:30', () => {
       expect(tzOffset(-4.5)).toBe('-04:30')
     })
 
-    test('tzOffset(0, -30)  is -00:30', () => {
+    test('tzOffset(0, -30)    is -00:30', () => {
       expect(tzOffset(0, -30)).toBe('-00:30')
     })
 
-    test('tzOffset(0)       is Z', () => {
+    test('tzOffset(0)         is Z', () => {
       expect(tzOffset(0)).toBe('Z')
     })
 
-    test('tzOffset(0, 30)   is +00:30', () => {
+    test('tzOffset(0, 30)     is +00:30', () => {
       expect(tzOffset(0, 30)).toBe('+00:30')
     })
 
-    test('tzOffset(1)       is +01:00', () => {
+    test('tzOffset(1)         is +01:00', () => {
       expect(tzOffset(1)).toBe('+01:00')
     })
 
-    test('tzOffset(2, -200) is -01:20', () => {
+    test('tzOffset(2, -200)   is -01:20', () => {
       expect(tzOffset(2, -200)).toBe('-01:20')
     })
 
-    test('tzOffset(4, 30)   is +04:30', () => {
+    test('tzOffset(4, 30)     is +04:30', () => {
       expect(tzOffset(4, 30)).toBe('+04:30')
     })
 
-    test('tzOffset(12, 45)  is +12:45', () => {
+    test('tzOffset(12, 45)    is +12:45', () => {
       expect(tzOffset(12, 45)).toBe('+12:45')
     })
 
-    test('tzOffset(12.75)   is +12:45', () => {
+    test('tzOffset(12.75)     is +12:45', () => {
       expect(tzOffset(12.75)).toBe('+12:45')
     })
+
+    test('tzOffset(23, 59)    is +23:59', () => {
+      expect(tzOffset(23, 59)).toBe('+23:59')
+    })
   })
 
   describe('out of boundaries', () => {
 
+    test('tzOffset(-24)            is Z', () => {
+      expect(tzOffset(-24)).toBe('Z')
+    })
+
+    test('tzOffset(24)             is Z', () => {
+      expect(tzOffset(24)).toBe('Z')
+    })
+
+    test('tzOffset(-24, 0, true)   is Z', () => {
+      expect(tzOffset(-24, 0, true)).toBe('Z')
+    })
+
+    test('tzOffset(24, 0, true)    is Z', () => {
+      expect(tzOffset(24, 0, true)).toBe('Z')
+    })
+
+    test('tzOffset(-24, -1)        is -00:01', () => {
+      expect(tzOffset(-24, -1)).toBe('-00:01')
+    })
+
+    test('tzOffset(24, 1)          is 00:01', () => {
+      expect(tzOffset(24, 1)).toBe('+00:01')
+    })
+
     test('tzOffset(-35)            is -11:00', () => {
       expect(tzOffset(-35)).toBe('-11:00')
     })
diff --git a/src/temporal/utils/const.js b/src/temporal/utils/const.js
index 5fcc57c..1889e40 100644
--- a/src/temporal/utils/const.js
+++ b/src/temporal/utils/const.js
@@ -1,8 +1,18 @@
 export const MINUTES_PER_DAY = 60 * 24
 export const MILLISECONDS_PER_DAY = 1000 * 60 * 60 * 24
 export const MILLISECONDS_PER_WEEK = MILLISECONDS_PER_DAY * 7
-export const REAL_LIFE_LOWER_TIMEZONE = -12 * 60
-export const REAL_LIFE_UPPER_TIMEZONE = 14 * 60
 
-// Local timezone offset from UTC, in minutes
+/**
+ * The farthest timezone offset **behind** UTC time.
+ */
+export const REAL_LIFE_LOWER_TIMEZONE = -12 * 60 // -12:00
+
+/**
+ * The farthest timezone offset **ahead of** UTC time.
+ */
+export const REAL_LIFE_UPPER_TIMEZONE = 14 * 60 // +14:00
+
+/**
+ * Local timezone offset from UTC, in minutes.
+ */
 export const LOCAL_TZ_OFFSET = (new Date()).getTimezoneOffset() * -1

From 1a1f648a00db83145d7bbf1a178a3f20493e8edf Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 20 Apr 2024 14:38:55 +0200
Subject: [PATCH 31/39] Fix timezone offset overflow ignored when it should end
 being `'Z'`

---
 src/temporal/timezone.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/temporal/timezone.js b/src/temporal/timezone.js
index 1febd02..92dbcf2 100644
--- a/src/temporal/timezone.js
+++ b/src/temporal/timezone.js
@@ -77,6 +77,8 @@ export function tzOffset(hours = 0, minutes = 0, inRealLifeBoundaries = false) {
    */
   let zonedTime = utcMidnight.add({ minutes })
 
+  if (!zonedTime.hour && !zonedTime.minute) { return 'Z' }
+
   /**
    * Offset sign: `+` (UTC > 0) or `-` (UTC < 0).
    * We don’t have condition when minutes is 0: `'Z'` was returned earlier.

From 68317660c839e3bfc3fc4bb18ef74c60126a385d Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sun, 21 Apr 2024 14:54:44 +0200
Subject: [PATCH 32/39] Rename internal timezone boundaries variables

---
 src/temporal/timezone.js    | 12 ++++++------
 src/temporal/utils/const.js |  4 ++--
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/temporal/timezone.js b/src/temporal/timezone.js
index 92dbcf2..c670c23 100644
--- a/src/temporal/timezone.js
+++ b/src/temporal/timezone.js
@@ -1,7 +1,7 @@
 import {
   MINUTES_PER_DAY,
-  REAL_LIFE_LOWER_TIMEZONE,
-  REAL_LIFE_UPPER_TIMEZONE,
+  IANA_LOWER_TIMEZONE,
+  IANA_UPPER_TIMEZONE,
   LOCAL_TZ_OFFSET,
 } from './utils/const.js'
 
@@ -48,14 +48,14 @@ export function tzOffset(hours = 0, minutes = 0, inRealLifeBoundaries = false) {
      */
 
     // Upper boundary
-    if (minutes > REAL_LIFE_UPPER_TIMEZONE) {
-      minutes -= suppressMinutesExcess(REAL_LIFE_UPPER_TIMEZONE)
+    if (minutes > IANA_UPPER_TIMEZONE) {
+      minutes -= suppressMinutesExcess(IANA_UPPER_TIMEZONE)
       return tzOffset(0, minutes, true)
     }
 
     // Lower boundary
-    if (minutes < REAL_LIFE_LOWER_TIMEZONE) {
-      minutes += suppressMinutesExcess(REAL_LIFE_LOWER_TIMEZONE)
+    if (minutes < IANA_LOWER_TIMEZONE) {
+      minutes += suppressMinutesExcess(IANA_LOWER_TIMEZONE)
       return tzOffset(0, minutes, true)
     }
   }
diff --git a/src/temporal/utils/const.js b/src/temporal/utils/const.js
index 1889e40..e04fc0d 100644
--- a/src/temporal/utils/const.js
+++ b/src/temporal/utils/const.js
@@ -5,12 +5,12 @@ export const MILLISECONDS_PER_WEEK = MILLISECONDS_PER_DAY * 7
 /**
  * The farthest timezone offset **behind** UTC time.
  */
-export const REAL_LIFE_LOWER_TIMEZONE = -12 * 60 // -12:00
+export const IANA_LOWER_TIMEZONE = -12 * 60 // -12:00
 
 /**
  * The farthest timezone offset **ahead of** UTC time.
  */
-export const REAL_LIFE_UPPER_TIMEZONE = 14 * 60 // +14:00
+export const IANA_UPPER_TIMEZONE = 14 * 60 // +14:00
 
 /**
  * Local timezone offset from UTC, in minutes.

From 1dc86116331352256b721d79b422c0afe22ee513 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sun, 21 Apr 2024 15:16:30 +0200
Subject: [PATCH 33/39] Update `Temporal` to be on par with last `main` changes

---
 .size-limit.json                |  10 +++
 src/datetime.js                 |   1 -
 src/temporal/config/datetime.js |  10 +--
 src/temporal/config/index.js    |   6 +-
 src/temporal/config/tz.js       |  35 ++++++++---
 src/temporal/config/tz.test.js  | 105 ++++++++++++++++++++++++++------
 src/temporal/datetime.js        |  10 +--
 src/temporal/index.js           |   8 ++-
 src/temporal/timezone.js        |   6 +-
 src/temporal/timezone.test.js   |   7 +++
 10 files changed, 157 insertions(+), 41 deletions(-)

diff --git a/.size-limit.json b/.size-limit.json
index f53712a..4823586 100644
--- a/.size-limit.json
+++ b/.size-limit.json
@@ -64,11 +64,21 @@
       "path": "src/index.js",
       "import": "{ setTzConfig }"
     },
+    {
+      "name": "`setTzConfig` (Temporal)",
+      "path": "src/temporal/index.js",
+      "import": "{ setTzConfig }"
+    },
     {
       "name": "`setTzInRealWorldRange`",
       "path": "src/index.js",
       "import": "{ setTzInRealWorldRange }"
     },
+    {
+      "name": "`setTzInRealWorldRange` (Temporal)",
+      "path": "src/temporal/index.js",
+      "import": "{ setTzInRealWorldRange }"
+    },
     {
       "name": "`setTzSeparator`",
       "path": "src/index.js",
diff --git a/src/datetime.js b/src/datetime.js
index 15f9475..5fb17ac 100644
--- a/src/datetime.js
+++ b/src/datetime.js
@@ -106,7 +106,6 @@ export function datetime(date = new Date(), precision = 'day') {
  * - `datetime(someDate, 'somePrecision utc')`
  * - `utc(someDate, 'somePrecision')`
  *
- *
  * @param {Date} [date=new Date()] - default to now
  * @param {'datetime'|'datetime second'|'datetime ms'|'time'|'second'|'ms'} [precision=datetime]
  * @returns {string}
diff --git a/src/temporal/config/datetime.js b/src/temporal/config/datetime.js
index 5e2ee8d..576a79e 100644
--- a/src/temporal/config/datetime.js
+++ b/src/temporal/config/datetime.js
@@ -1,11 +1,11 @@
 /**
  * @typedef {Object} DateTimeOptions
- * @property {('T'|' ')} separator
+ * @property {('T'|' ')} separator The separator between date and time
+ *                                 (`'2024-04-21T10:34'`) can be a
+ *                                 'T' (default) or a space.
  */
 
-/**
- * @type DateTimeOptions
- */
+/** @type DateTimeOptions */
 export const config = {
   separator: 'T',
 }
@@ -32,7 +32,7 @@ export const setConfig = options => {
 /**
  * Set separator between date and time
  *
- * @param {('T'|' ')} [separator=T]
+ * @param {DateTimeOptions['separator']} [separator='T']
  * @returns {DateTimeOptions}
  */
 export const setTimeSeparator = (separator = 'T') => setConfig({ separator })
diff --git a/src/temporal/config/index.js b/src/temporal/config/index.js
index d935312..c3fff3a 100644
--- a/src/temporal/config/index.js
+++ b/src/temporal/config/index.js
@@ -1,2 +1,6 @@
 export { setTimeSeparator } from './datetime.js'
-export { setTzSeparator } from './tz.js'
+export {
+  setTzConfig,
+  setTzInRealWorldRange,
+  setTzSeparator,
+} from './tz.js'
diff --git a/src/temporal/config/tz.js b/src/temporal/config/tz.js
index 08fdc53..07b1084 100644
--- a/src/temporal/config/tz.js
+++ b/src/temporal/config/tz.js
@@ -1,38 +1,59 @@
 /**
  * @typedef {Object} TimezoneOptions
- * @property {(':'|'')} separator
+ *
+ * @property {boolean} [inRealWorldRange] Adapt the timezone value to be inside
+ *                                        the real-world IANA range. `false`
+ *                                         by default.
+ *
+ * @property {(':'|'')} [separator] The separator between hours and minutes
+ *                                  (`'+02:00'`) can be ':' (default) or
+ *                                  an empty string.
  */
 
-/**
- * @type TimezoneOptions
- */
+/** @type TimezoneOptions */
 export const tzConfig = {
+  inRealWorldRange: false,
   separator: ':',
 }
 
+const defaultConfig = { ...tzConfig }
+
 /**
  * Set timezone related configuration
  *
  * @param {TimezoneOptions} options
  * @returns {TimezoneOptions}
  */
-export const setTzConfig = options => {
+export const setTzConfig = (options = defaultConfig) => {
+  const { separator, inRealWorldRange } = options
 
   /**
    * The separator can only be ':' or ''.
    * https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#time-zones
    */
-  if (options.separator != ':' && options.separator != '') {
+  if ('separator' in options && separator != ':' && separator != '') {
     throw new Error(`Invalid timezone separator. Use ':' or ''.`)
   }
 
+  if ('inRealWorldRange' in options && typeof inRealWorldRange != 'boolean') {
+    throw new Error(`Invalid value for 'inRealWorldRange'. Use true or false.`)
+  }
+
   return Object.assign(tzConfig, options)
 }
 
 /**
  * Set timezone separator
  *
- * @param {(':'|'')} [separator='']
+ * @param {TimezoneOptions['separator']} [separator='']
  * @returns {TimezoneOptions}
  */
 export const setTzSeparator = (separator = '') => setTzConfig({ separator })
+
+/**
+ * Shift timezones to be inside the real-world (IANA) range
+ *
+ * @param {TimezoneOptions['inRealWorldRange']} [inRealWorldRange=false]
+ * @returns {TimezoneOptions}
+ */
+export const setTzInRealWorldRange = (inRealWorldRange = false) => setTzConfig({ inRealWorldRange })
diff --git a/src/temporal/config/tz.test.js b/src/temporal/config/tz.test.js
index 05c6f7d..ea5240a 100644
--- a/src/temporal/config/tz.test.js
+++ b/src/temporal/config/tz.test.js
@@ -1,15 +1,21 @@
-import { describe, expect, test } from 'vitest'
+import { beforeEach, describe, expect, test } from 'vitest'
 
-import { datetimeTz, tzOffset, setTzSeparator } from '../index.js'
-
-import { setTzConfig } from './tz.js'
+import { datetimeTz, tzOffset, setTzConfig, setTzInRealWorldRange, setTzSeparator } from '../index.js'
+import { tzConfig } from './tz.js'
 
 const togoIndependanceDay = new Date(1960, 3, 27)
 const date = togoIndependanceDay // alias for the sake of brevity
 
+// Reset default config between each test.
+const defaultConfig = { ...tzConfig }
+beforeEach(() => setTzConfig(defaultConfig))
+
 describe('setTzSeparator', () => {
   test('is a function', () => expect(setTzSeparator).toBeInstanceOf(Function))
-  test('throws with invalid separator', () => expect(() => setTzSeparator(42)).toThrow(Error))
+
+  test('throws with invalid separator', () => {
+    expect(() => setTzSeparator(42)).toThrow(Error)
+  })
 
   test('no timezone separator', () => {
     setTzSeparator()
@@ -32,24 +38,87 @@ describe('setTzSeparator', () => {
   })
 })
 
+describe('setTzInRealWorldRange', () => {
+  test('is a function', () => expect(setTzInRealWorldRange).toBeInstanceOf(Function))
+  test('throws with invalid value', () => expect(() => setTzInRealWorldRange(42)).toThrow(Error))
+
+  test('default value disables real-world range', () => {
+    expect(tzOffset(20)).toBe('+20:00')
+    setTzInRealWorldRange()
+    expect(tzOffset(20)).toBe('+20:00')
+  })
+
+  test('enable real-world range', () => {
+    expect(tzOffset(20)).toBe('+20:00')
+    setTzInRealWorldRange(true)
+    expect(tzOffset(20)).toBe('-04:00')
+  })
+
+  test('disable real-world range', () => {
+    setTzInRealWorldRange(false)
+    expect(tzOffset(20)).toBe('+20:00')
+  })
+
+  test('enable real-world range with datetimeTz', () => {
+    setTzInRealWorldRange(true)
+    expect(datetimeTz(date, 'datetime second', 20)).toBe('1960-04-27T00:00:00-04:00')
+  })
+})
+
 describe('setTzConfig', () => {
-  test('is a function', () => expect(setTzConfig).toBeInstanceOf(Function))
-  test('throws without parameter', () => expect(() => setTzConfig()).toThrow(TypeError))
-  test('throws without proper parameter', () => expect(() => setTzConfig({})).toThrow(Error))
-  test('throws with invalid separator', () => expect(() => setTzConfig({ separator: 42 })).toThrow(Error))
 
-  test('empty string timezone separator using tzOffset', () => {
-    setTzConfig({ separator: '' })
-    expect(tzOffset(3)).toBe('+0300')
+  describe('general', () => {
+    test('is a function', () => expect(setTzConfig).toBeInstanceOf(Function))
+
+    test('reset the default config without parameter', () => {
+      setTzConfig({ separator: '', inRealWorldRange: true })
+      expect(tzOffset(20)).toBe('-0400')
+
+      setTzConfig()
+      expect(tzOffset(20)).toBe('+20:00')
+    })
   })
 
-  test(': as timezone separator using tzOffset', () => {
-    setTzConfig({ separator: ':' })
-    expect(tzOffset(3)).toBe('+03:00')
+  describe('timezone separator', () => {
+    test('throws with invalid separator', () => expect(() => setTzConfig({ separator: 42 })).toThrow(Error))
+
+    test('empty string separator using tzOffset', () => {
+      setTzConfig({ separator: '' })
+      expect(tzOffset(3)).toBe('+0300')
+    })
+
+    test(': as separator using tzOffset', () => {
+      setTzConfig({ separator: ':' })
+      expect(tzOffset(3)).toBe('+03:00')
+    })
+
+    test(': as separator with datetimeTz', () => {
+      setTzConfig({ separator: ':' })
+      expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00')
+    })
   })
 
-  test(': as timezone separator with datetimeTz', () => {
-    setTzConfig({ separator: ':' })
-    expect(datetimeTz(date, 'datetime second', -6)).toBe('1960-04-27T00:00:00-06:00')
+  describe('real-world boundaries', () => {
+    test('throws with invalid value', () => expect(() => setTzConfig({ inRealWorldRange: 42 })).toThrow(Error))
+
+    test('inside boundaries using tzOffset', () => {
+      setTzConfig({ inRealWorldRange: true })
+      expect(tzOffset(20)).toBe('-04:00')
+    })
+
+    test('outside boundaries using tzOffset', () => {
+      setTzConfig({ inRealWorldRange: false })
+      expect(tzOffset(20)).toBe('+20:00')
+    })
+
+    test('inside boundaries using datetimeTz', () => {
+      setTzConfig({ inRealWorldRange: true })
+      expect(datetimeTz(date, 'datetime second', 20)).toBe('1960-04-27T00:00:00-04:00')
+    })
+
+    test('outside boundaries using datetimeTz', () => {
+      setTzConfig({ inRealWorldRange: false })
+      expect(datetimeTz(date, 'datetime second', 20)).toBe('1960-04-27T00:00:00+20:00')
+    })
   })
 })
diff --git a/src/temporal/datetime.js b/src/temporal/datetime.js
index 16141bf..ac5c699 100644
--- a/src/temporal/datetime.js
+++ b/src/temporal/datetime.js
@@ -1,6 +1,7 @@
 import { p } from './utils/string.js'
 import { tzOffset } from './timezone.js'
 import { config } from './config/datetime.js'
+import { tzConfig } from './config/tz.js'
 import { Temporal, toTemporalInstant } from '@js-temporal/polyfill'
 // import { Temporal, toTemporalInstant } from 'temporal-polyfill'
 
@@ -31,7 +32,7 @@ export function datetime(date = new Date(), precision = 'day') {
 
   const yearISO = y => {
 
-    // Year 0 doesn’t exists in real life, but does in the ISO-8601 spec.
+    // Year 0 doesn’t exists in real world, but does in the ISO-8601 spec.
     const sign = y < 0 ? '-' : '' // no sign if year is not negative
 
     // Remove sign (stored separately, see previous line).
@@ -87,7 +88,6 @@ export function datetime(date = new Date(), precision = 'day') {
  * - `datetime(someDate, 'somePrecision utc')`
  * - `utc(someDate, 'somePrecision')`
  *
- *
  * @param {Date} [date=new Date()] - default to now
  * @param {'datetime'|'datetime second'|'datetime ms'|'time'|'second'|'ms'} [precision=datetime]
  * @returns {string}
@@ -102,7 +102,7 @@ export const utc = (date = new Date(), precision = 'datetime') =>
  * @param {Precision} [precision=datetime]
  * @param {number} [offsetHours=0]
  * @param {number} [offsetMinutes=0]
- * @param {boolean} [inRealLifeBoundaries=false]
+ * @param {import('./config/tz.js').TimezoneOptions['inRealWorldRange']} [inRealWorldRange=false]
  * @returns {string}
  */
 export function datetimeTz(
@@ -110,7 +110,7 @@ export function datetimeTz(
   precision = 'datetime',
   offsetHours = 0,
   offsetMinutes = 0,
-  inRealLifeBoundaries = false,
+  inRealWorldRange = tzConfig.inRealWorldRange,
 ) {
   let timezoneOffset = ''
 
@@ -118,7 +118,7 @@ export function datetimeTz(
     // ignore request for UTC conversion
     timezoneOffset =
       '2' in arguments // see similar line in tzOffset()
-        ? tzOffset(offsetHours, offsetMinutes, inRealLifeBoundaries)
+        ? tzOffset(offsetHours, offsetMinutes, inRealWorldRange)
         : tzOffset()
   }
 
diff --git a/src/temporal/index.js b/src/temporal/index.js
index f72c094..77a550d 100644
--- a/src/temporal/index.js
+++ b/src/temporal/index.js
@@ -2,7 +2,13 @@ export { datetime, utc, datetimeTz } from './datetime.js'
 export { duration } from './duration.js'
 export { tzOffset } from './timezone.js'
 
-export { setTimeSeparator, setTzSeparator } from './config/index.js'
+export {
+  setTimeSeparator,
+  setTzConfig,
+  setTzInRealWorldRange,
+  setTzSeparator
+} from './config/index.js'
+
 export { daysBetween, weekNumber } from './utils/date.js'
 
 export { DateTime } from './datetime-class.js'
diff --git a/src/temporal/timezone.js b/src/temporal/timezone.js
index c670c23..be728d0 100644
--- a/src/temporal/timezone.js
+++ b/src/temporal/timezone.js
@@ -19,10 +19,10 @@ import { Temporal } from '@js-temporal/polyfill'
  *
  * @param {number} [hours=0] The number of hours from UTC
  * @param {number} [minutes=0] The number of minutes from UTC
- * @param {boolean} [inRealLifeBoundaries=false] Make sure the timezone stays in spec boundaries.
+ * @param {import('./config/tz.js').TimezoneOptions['inRealWorldRange']} [inRealWorldRange=false] Make sure the timezone stays in spec boundaries.
  * @returns {string}
  */
-export function tzOffset(hours = 0, minutes = 0, inRealLifeBoundaries = false) {
+export function tzOffset(hours = 0, minutes = 0, inRealWorldRange = tzConfig.inRealWorldRange) {
 
   // No arguments received: the local timezone offset is returned.
   if (!('0' in arguments)) {
@@ -39,7 +39,7 @@ export function tzOffset(hours = 0, minutes = 0, inRealLifeBoundaries = false) {
   // Compute minutes to remove in order to suppress the excess of minutes.
   const suppressMinutesExcess = limit => Math.floor(minutes / limit) * MINUTES_PER_DAY
 
-  if (inRealLifeBoundaries) {
+  if (inRealWorldRange) {
 
     /**
      * Because lower and upper boundaries are not necessarily symetric,
diff --git a/src/temporal/timezone.test.js b/src/temporal/timezone.test.js
index 574fd3c..dd00206 100644
--- a/src/temporal/timezone.test.js
+++ b/src/temporal/timezone.test.js
@@ -2,6 +2,13 @@ import { describe, expect, test } from 'vitest'
 
 import { tzOffset } from './index.js'
 
+import { Temporal } from '@js-temporal/polyfill'
+
+const tz = new Temporal.TimeZone('-23:59:59.999999999')
+console.log(tz.id)
+console.log(tz.toJSON())
+console.log(tz.toString())
+
 const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
 
 describe('tzOffset', () => {

From c3b05ca88afd8768a7b356487530dc035129d8e7 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sun, 21 Apr 2024 15:20:06 +0200
Subject: [PATCH 34/39] Comment unwanted code

---
 src/temporal/timezone.test.js | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/temporal/timezone.test.js b/src/temporal/timezone.test.js
index dd00206..d77a206 100644
--- a/src/temporal/timezone.test.js
+++ b/src/temporal/timezone.test.js
@@ -2,12 +2,12 @@ import { describe, expect, test } from 'vitest'
 
 import { tzOffset } from './index.js'
 
-import { Temporal } from '@js-temporal/polyfill'
+// import { Temporal } from '@js-temporal/polyfill'
 
-const tz = new Temporal.TimeZone('-23:59:59.999999999')
-console.log(tz.id)
-console.log(tz.toJSON())
-console.log(tz.toString())
+// const tz = new Temporal.TimeZone('-23:59:59.999999999')
+// console.log(tz.id)
+// console.log(tz.toJSON())
+// console.log(tz.toString())
 
 const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
 

From fb2262c2c9c7e47547f022984b25513c18516e0b Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Fri, 26 Apr 2024 11:41:27 +0200
Subject: [PATCH 35/39] Draft comparison chart

---
 src/temporal/README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 src/temporal/README.md

diff --git a/src/temporal/README.md b/src/temporal/README.md
new file mode 100644
index 0000000..9dcdec6
--- /dev/null
+++ b/src/temporal/README.md
@@ -0,0 +1,17 @@
+> [!INFO]  
+>
+> Work in progress document. Very drafty.
+
+## Parity between `Date` and `Temporal` implementations
+
+function | in `Date` | in `Temporal` | note
+---|---|---|---
+`tzOffset` | yes | yes | @todo accept a `Temporal.TimeZone` (or any temporal) and output its “real-world” timezone.
+`datetime` | yes | yes | @todo evaluate
+`utc` | yes | yes | @todo evaluate
+`datetimeTz` | yes | yes | @todo evaluate
+`DateTime` | yes | yes | @todo evaluate
+`duration` | yes | yes | @todo evaluate
+`daysBetween` | yes | yes | @todo evaluate
+`weekNumber` | yes | yes | @todo evaluate
+(config feature…)| yes | yes | @todo evaluate

From 2393d3191a27072669f72e0b3d4729b98582d925 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 27 Apr 2024 16:19:33 +0200
Subject: [PATCH 36/39] Move Temporal implementation having parity to another
 folder

---
 src/temporal-same-features/README.md            |  5 +++++
 .../config/datetime.js                          |  0
 .../config/datetime.test.js                     |  0
 .../config/index.js                             |  0
 .../config/tz.js                                |  0
 .../config/tz.test.js                           |  0
 .../datetime-class.js                           |  0
 .../datetime-class.test.js                      |  0
 .../datetime.js                                 |  0
 .../datetime.test.js                            |  0
 .../duration.js                                 |  0
 .../duration.test.js                            |  0
 .../index.js                                    |  0
 .../timezone.js                                 |  0
 .../timezone.test.js                            | 11 -----------
 .../utils/const.js                              |  0
 .../utils/date.js                               |  0
 .../utils/date.test.js                          |  0
 .../utils/math.js                               |  0
 .../utils/string.js                             |  0
 .../utils/temporal.js                           |  0
 src/temporal/README.md                          | 17 -----------------
 22 files changed, 5 insertions(+), 28 deletions(-)
 create mode 100644 src/temporal-same-features/README.md
 rename src/{temporal => temporal-same-features}/config/datetime.js (100%)
 rename src/{temporal => temporal-same-features}/config/datetime.test.js (100%)
 rename src/{temporal => temporal-same-features}/config/index.js (100%)
 rename src/{temporal => temporal-same-features}/config/tz.js (100%)
 rename src/{temporal => temporal-same-features}/config/tz.test.js (100%)
 rename src/{temporal => temporal-same-features}/datetime-class.js (100%)
 rename src/{temporal => temporal-same-features}/datetime-class.test.js (100%)
 rename src/{temporal => temporal-same-features}/datetime.js (100%)
 rename src/{temporal => temporal-same-features}/datetime.test.js (100%)
 rename src/{temporal => temporal-same-features}/duration.js (100%)
 rename src/{temporal => temporal-same-features}/duration.test.js (100%)
 rename src/{temporal => temporal-same-features}/index.js (100%)
 rename src/{temporal => temporal-same-features}/timezone.js (100%)
 rename src/{temporal => temporal-same-features}/timezone.test.js (94%)
 rename src/{temporal => temporal-same-features}/utils/const.js (100%)
 rename src/{temporal => temporal-same-features}/utils/date.js (100%)
 rename src/{temporal => temporal-same-features}/utils/date.test.js (100%)
 rename src/{temporal => temporal-same-features}/utils/math.js (100%)
 rename src/{temporal => temporal-same-features}/utils/string.js (100%)
 rename src/{temporal => temporal-same-features}/utils/temporal.js (100%)
 delete mode 100644 src/temporal/README.md

diff --git a/src/temporal-same-features/README.md b/src/temporal-same-features/README.md
new file mode 100644
index 0000000..c5a59f2
--- /dev/null
+++ b/src/temporal-same-features/README.md
@@ -0,0 +1,5 @@
+# datetime-attribute implemented with the `Temporal` API
+
+This folder contains the implementation of `datetime-attribute` using the [`Temporal` API](https://tc39.es/proposal-temporal/docs).
+
+It has feature parity with the initial `datetime-attribute`.
diff --git a/src/temporal/config/datetime.js b/src/temporal-same-features/config/datetime.js
similarity index 100%
rename from src/temporal/config/datetime.js
rename to src/temporal-same-features/config/datetime.js
diff --git a/src/temporal/config/datetime.test.js b/src/temporal-same-features/config/datetime.test.js
similarity index 100%
rename from src/temporal/config/datetime.test.js
rename to src/temporal-same-features/config/datetime.test.js
diff --git a/src/temporal/config/index.js b/src/temporal-same-features/config/index.js
similarity index 100%
rename from src/temporal/config/index.js
rename to src/temporal-same-features/config/index.js
diff --git a/src/temporal/config/tz.js b/src/temporal-same-features/config/tz.js
similarity index 100%
rename from src/temporal/config/tz.js
rename to src/temporal-same-features/config/tz.js
diff --git a/src/temporal/config/tz.test.js b/src/temporal-same-features/config/tz.test.js
similarity index 100%
rename from src/temporal/config/tz.test.js
rename to src/temporal-same-features/config/tz.test.js
diff --git a/src/temporal/datetime-class.js b/src/temporal-same-features/datetime-class.js
similarity index 100%
rename from src/temporal/datetime-class.js
rename to src/temporal-same-features/datetime-class.js
diff --git a/src/temporal/datetime-class.test.js b/src/temporal-same-features/datetime-class.test.js
similarity index 100%
rename from src/temporal/datetime-class.test.js
rename to src/temporal-same-features/datetime-class.test.js
diff --git a/src/temporal/datetime.js b/src/temporal-same-features/datetime.js
similarity index 100%
rename from src/temporal/datetime.js
rename to src/temporal-same-features/datetime.js
diff --git a/src/temporal/datetime.test.js b/src/temporal-same-features/datetime.test.js
similarity index 100%
rename from src/temporal/datetime.test.js
rename to src/temporal-same-features/datetime.test.js
diff --git a/src/temporal/duration.js b/src/temporal-same-features/duration.js
similarity index 100%
rename from src/temporal/duration.js
rename to src/temporal-same-features/duration.js
diff --git a/src/temporal/duration.test.js b/src/temporal-same-features/duration.test.js
similarity index 100%
rename from src/temporal/duration.test.js
rename to src/temporal-same-features/duration.test.js
diff --git a/src/temporal/index.js b/src/temporal-same-features/index.js
similarity index 100%
rename from src/temporal/index.js
rename to src/temporal-same-features/index.js
diff --git a/src/temporal/timezone.js b/src/temporal-same-features/timezone.js
similarity index 100%
rename from src/temporal/timezone.js
rename to src/temporal-same-features/timezone.js
diff --git a/src/temporal/timezone.test.js b/src/temporal-same-features/timezone.test.js
similarity index 94%
rename from src/temporal/timezone.test.js
rename to src/temporal-same-features/timezone.test.js
index d77a206..a02d294 100644
--- a/src/temporal/timezone.test.js
+++ b/src/temporal-same-features/timezone.test.js
@@ -1,14 +1,6 @@
 import { describe, expect, test } from 'vitest'
-
 import { tzOffset } from './index.js'
 
-// import { Temporal } from '@js-temporal/polyfill'
-
-// const tz = new Temporal.TimeZone('-23:59:59.999999999')
-// console.log(tz.id)
-// console.log(tz.toJSON())
-// console.log(tz.toString())
-
 const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
 
 describe('tzOffset', () => {
@@ -141,6 +133,3 @@ describe('tzOffset', () => {
 
     test('tzOffset(62.75, 0, true) is -09:15', () => {
       expect(tzOffset(62.75, 0, true)).toBe('-09:15')
-    })
-  })
-})
diff --git a/src/temporal/utils/const.js b/src/temporal-same-features/utils/const.js
similarity index 100%
rename from src/temporal/utils/const.js
rename to src/temporal-same-features/utils/const.js
diff --git a/src/temporal/utils/date.js b/src/temporal-same-features/utils/date.js
similarity index 100%
rename from src/temporal/utils/date.js
rename to src/temporal-same-features/utils/date.js
diff --git a/src/temporal/utils/date.test.js b/src/temporal-same-features/utils/date.test.js
similarity index 100%
rename from src/temporal/utils/date.test.js
rename to src/temporal-same-features/utils/date.test.js
diff --git a/src/temporal/utils/math.js b/src/temporal-same-features/utils/math.js
similarity index 100%
rename from src/temporal/utils/math.js
rename to src/temporal-same-features/utils/math.js
diff --git a/src/temporal/utils/string.js b/src/temporal-same-features/utils/string.js
similarity index 100%
rename from src/temporal/utils/string.js
rename to src/temporal-same-features/utils/string.js
diff --git a/src/temporal/utils/temporal.js b/src/temporal-same-features/utils/temporal.js
similarity index 100%
rename from src/temporal/utils/temporal.js
rename to src/temporal-same-features/utils/temporal.js
diff --git a/src/temporal/README.md b/src/temporal/README.md
deleted file mode 100644
index 9dcdec6..0000000
--- a/src/temporal/README.md
+++ /dev/null
@@ -1,17 +0,0 @@
-> [!INFO]  
->
-> Work in progress document. Very drafty.
-
-## Parity between `Date` and `Temporal` implementations
-
-function | in `Date` | in `Temporal` | note
----|---|---|---
-`tzOffset` | yes | yes | @todo accept a `Temporal.TimeZone` (or any temporal) and output its “real-world” timezone.
-`datetime` | yes | yes | @todo evaluate
-`utc` | yes | yes | @todo evaluate
-`datetimeTz` | yes | yes | @todo evaluate
-`DateTime` | yes | yes | @todo evaluate
-`duration` | yes | yes | @todo evaluate
-`daysBetween` | yes | yes | @todo evaluate
-`weekNumber` | yes | yes | @todo evaluate
-(config feature…)| yes | yes | @todo evaluate

From 5225558c1646804ab1fc503812af825711cfc9e1 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 27 Apr 2024 16:20:23 +0200
Subject: [PATCH 37/39] Start experimenting in a new folder

---
 src/temporal-experimenting/README.md | 32 ++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 src/temporal-experimenting/README.md

diff --git a/src/temporal-experimenting/README.md b/src/temporal-experimenting/README.md
new file mode 100644
index 0000000..e62499f
--- /dev/null
+++ b/src/temporal-experimenting/README.md
@@ -0,0 +1,32 @@
+> [!INFO]  
+>
+> Work in progress document. Very drafty.
+
+This folder will contain the implementation of `datetime-attribute` where functions will accept [`Temporal`](https://tc39.es/proposal-temporal/docs) objects while keeping current parameters.
+
+It’s possible that some functions will not require to accept a `Temporal` object because what they accomplish is maybe already available as a `Temporal.{className}` feature.
+
+It’s also possible that new functions are created to facilitate the usage of `Temporal` objects, and the extended scope they cover in comparison with `Date`.
+
+## Parity between `Date` and `Temporal` implementations
+
+**Drafty.**
+
+function | in `Date` | in `Temporal` | note
+---|---|---|---
+`tzOffset` | yes | yes | @todo accept a `Temporal.TimeZone` (or any temporal) and output its “real-world” timezone.
+`datetime` | yes | yes | @todo evaluate
+`utc` | yes | yes | @todo evaluate
+`datetimeTz` | yes | yes | @todo evaluate
+`DateTime` | yes | yes | @todo evaluate
+`duration` | yes | yes | @todo evaluate
+`daysBetween` | yes | yes | @todo evaluate
+`weekNumber` | yes | yes | @todo evaluate
+(config feature…)| yes | yes | @todo evaluate
+
+## `tzOffset` notes
+
+```js
+const tz = new Temporal.TimeZone('-23:59')
+console.log(tz.id) // -23:59
+```

From 4ad9d3d17228f95791fcb25082c0afc2853b7dc9 Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 27 Apr 2024 16:22:34 +0200
Subject: [PATCH 38/39] Fix `size-limit` config

---
 .size-limit.json | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/.size-limit.json b/.size-limit.json
index 4823586..8ba8625 100644
--- a/.size-limit.json
+++ b/.size-limit.json
@@ -6,7 +6,7 @@
     },
     {
       "name": "`datetime` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ datetime }"
     },
     {
@@ -16,7 +16,7 @@
     },
     {
       "name": "`utc` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ utc }"
     },
     {
@@ -26,7 +26,7 @@
     },
     {
       "name": "`datetimeTz` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ datetimeTz }"
     },
     {
@@ -36,7 +36,7 @@
     },
     {
       "name": "`duration` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ duration }"
     },
     {
@@ -46,7 +46,7 @@
     },
     {
       "name": "`tzOffset` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ tzOffset }"
     },
     {
@@ -56,7 +56,7 @@
     },
     {
       "name": "`setTimeSeparator` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ setTimeSeparator }"
     },
     {
@@ -66,7 +66,7 @@
     },
     {
       "name": "`setTzConfig` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ setTzConfig }"
     },
     {
@@ -76,7 +76,7 @@
     },
     {
       "name": "`setTzInRealWorldRange` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ setTzInRealWorldRange }"
     },
     {
@@ -86,7 +86,7 @@
     },
     {
       "name": "`setTzSeparator` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ setTzSeparator }"
     },
     {
@@ -96,7 +96,7 @@
     },
     {
       "name": "`daysBetween` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ daysBetween }"
     },
     {
@@ -106,7 +106,7 @@
     },
     {
       "name": "`weekNumber` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ weekNumber }"
     },
     {
@@ -116,7 +116,7 @@
     },
     {
       "name": "`DateTime` (Temporal)",
-      "path": "src/temporal/index.js",
+      "path": "src/temporal-same-features/index.js",
       "import": "{ DateTime }"
     },
     {
@@ -125,6 +125,6 @@
     },
     {
       "name": "**All modules** (`import *`, Temporal)",
-      "path": "src/temporal/index.js"
+      "path": "src/temporal-same-features/index.js"
     }
   ]

From bab5999d0782c3a224ba0d2eb9070bd1df1a7b4e Mon Sep 17 00:00:00 2001
From: Mehdi M <hi@mehdi.cc>
Date: Sat, 27 Apr 2024 16:27:23 +0200
Subject: [PATCH 39/39] Fix test file

---
 src/temporal-same-features/timezone.test.js | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/temporal-same-features/timezone.test.js b/src/temporal-same-features/timezone.test.js
index a02d294..cc952bb 100644
--- a/src/temporal-same-features/timezone.test.js
+++ b/src/temporal-same-features/timezone.test.js
@@ -1,5 +1,6 @@
 import { describe, expect, test } from 'vitest'
 import { tzOffset } from './index.js'
+import { Temporal } from '@js-temporal/polyfill'
 
 const tzOffsetInMinutes = (new Date()).getTimezoneOffset() * -1
 
@@ -133,3 +134,6 @@ describe('tzOffset', () => {
 
     test('tzOffset(62.75, 0, true) is -09:15', () => {
       expect(tzOffset(62.75, 0, true)).toBe('-09:15')
+    })
+  })
+})