@northguild/gmt 1.19.0 → 1.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2150) hide show
  1. package/README.md +68 -29
  2. package/dist/calendar/business/businessDaysBetween.d.ts +5 -4
  3. package/dist/calendar/business/businessDaysBetween.js +58 -87
  4. package/dist/calendar/business/index.d.ts +11 -7
  5. package/dist/calendar/business/index.js +10 -10
  6. package/dist/calendar/business/mergeCalendars.d.ts +4 -3
  7. package/dist/calendar/business/mergeCalendars.js +56 -65
  8. package/dist/calendar/business/nextBusinessDay.d.ts +5 -4
  9. package/dist/calendar/business/nextBusinessDay.js +37 -36
  10. package/dist/calendar/business/previousBusinessDay.d.ts +5 -4
  11. package/dist/calendar/business/previousBusinessDay.js +37 -36
  12. package/dist/calendar/business/rollDate.d.ts +7 -5
  13. package/dist/calendar/business/rollDate.js +77 -114
  14. package/dist/calendar/calculate/bucketRange.d.ts +12 -11
  15. package/dist/calendar/calculate/bucketRange.js +105 -119
  16. package/dist/calendar/calculate/floorToZone.d.ts +5 -4
  17. package/dist/calendar/calculate/floorToZone.js +68 -68
  18. package/dist/calendar/calculate/getFiscalPeriod.d.ts +63 -52
  19. package/dist/calendar/calculate/getFiscalPeriod.js +106 -93
  20. package/dist/calendar/calculate/getIsoWeekDate.d.ts +13 -13
  21. package/dist/calendar/calculate/getIsoWeekDate.js +41 -35
  22. package/dist/calendar/calculate/getOrdinalDate.d.ts +11 -11
  23. package/dist/calendar/calculate/getOrdinalDate.js +31 -25
  24. package/dist/calendar/calculate/getQuarter.d.ts +36 -30
  25. package/dist/calendar/calculate/getQuarter.js +71 -53
  26. package/dist/calendar/calculate/index.d.ts +7 -6
  27. package/dist/calendar/calculate/index.js +8 -6
  28. package/dist/calendar/hours/addOperatingTime.d.ts +25 -23
  29. package/dist/calendar/hours/addOperatingTime.js +57 -63
  30. package/dist/calendar/hours/index.d.ts +8 -7
  31. package/dist/calendar/hours/index.js +9 -7
  32. package/dist/calendar/hours/isOpenAt.d.ts +17 -15
  33. package/dist/calendar/hours/isOpenAt.js +47 -48
  34. package/dist/calendar/hours/nextCloseAt.d.ts +24 -22
  35. package/dist/calendar/hours/nextCloseAt.js +52 -55
  36. package/dist/calendar/hours/nextOpenAt.d.ts +25 -23
  37. package/dist/calendar/hours/nextOpenAt.js +48 -51
  38. package/dist/calendar/hours/operatingIntervals.d.ts +16 -13
  39. package/dist/calendar/hours/operatingIntervals.js +52 -55
  40. package/dist/calendar/hours/operatingTimeBetween.d.ts +16 -14
  41. package/dist/calendar/hours/operatingTimeBetween.js +53 -52
  42. package/dist/calendar/hours/recurringWindows.d.ts +19 -16
  43. package/dist/calendar/hours/recurringWindows.js +81 -86
  44. package/dist/calendar/index.d.ts +41 -5
  45. package/dist/calendar/index.js +37 -6
  46. package/dist/calendar/rules/buildBusinessCalendar.d.ts +27 -0
  47. package/dist/calendar/rules/buildBusinessCalendar.js +68 -0
  48. package/dist/calendar/rules/easterSunday.d.ts +31 -0
  49. package/dist/calendar/rules/easterSunday.js +41 -0
  50. package/dist/calendar/rules/holidayDates.d.ts +38 -0
  51. package/dist/calendar/rules/holidayDates.js +63 -0
  52. package/dist/calendar/rules/index.d.ts +6 -0
  53. package/dist/calendar/rules/index.js +7 -0
  54. package/dist/calendar/rules/nthWeekdayOfMonth.d.ts +24 -0
  55. package/dist/calendar/rules/nthWeekdayOfMonth.js +40 -0
  56. package/dist/calendar/rules/observedDate.d.ts +30 -0
  57. package/dist/calendar/rules/observedDate.js +50 -0
  58. package/dist/calendar/validate/index.d.ts +9 -4
  59. package/dist/calendar/validate/index.js +10 -4
  60. package/dist/calendar/validate/isValidBusinessCalendar.d.ts +3 -2
  61. package/dist/calendar/validate/isValidBusinessCalendar.js +38 -37
  62. package/dist/calendar/validate/isValidFiscalCalendar.d.ts +24 -0
  63. package/dist/calendar/validate/isValidFiscalCalendar.js +39 -0
  64. package/dist/calendar/validate/isValidFiscalExtraWeek.d.ts +20 -0
  65. package/dist/calendar/validate/isValidFiscalExtraWeek.js +24 -0
  66. package/dist/calendar/validate/isValidFiscalPattern.d.ts +10 -9
  67. package/dist/calendar/validate/isValidFiscalPattern.js +28 -27
  68. package/dist/calendar/validate/isValidFiscalYearLabel.d.ts +21 -0
  69. package/dist/calendar/validate/isValidFiscalYearLabel.js +25 -0
  70. package/dist/calendar/validate/isValidHolidayRule.d.ts +32 -0
  71. package/dist/calendar/validate/isValidHolidayRule.js +41 -0
  72. package/dist/calendar/validate/isValidRollConvention.d.ts +3 -2
  73. package/dist/calendar/validate/isValidRollConvention.js +32 -36
  74. package/dist/calendar/validate/isValidZoneBucketUnit.d.ts +4 -3
  75. package/dist/calendar/validate/isValidZoneBucketUnit.js +35 -36
  76. package/dist/duration/calculate/absDuration.d.ts +1 -1
  77. package/dist/duration/calculate/absDuration.js +30 -29
  78. package/dist/duration/calculate/addDuration.d.ts +1 -1
  79. package/dist/duration/calculate/addDuration.js +30 -29
  80. package/dist/duration/calculate/durationFromUnits.d.ts +3 -2
  81. package/dist/duration/calculate/durationFromUnits.js +63 -65
  82. package/dist/duration/calculate/getDurationSign.d.ts +1 -1
  83. package/dist/duration/calculate/getDurationSign.js +32 -31
  84. package/dist/duration/calculate/getDurationUnit.d.ts +4 -3
  85. package/dist/duration/calculate/getDurationUnit.js +45 -44
  86. package/dist/duration/calculate/index.d.ts +12 -9
  87. package/dist/duration/calculate/index.js +13 -9
  88. package/dist/duration/calculate/negateDuration.d.ts +1 -1
  89. package/dist/duration/calculate/negateDuration.js +30 -29
  90. package/dist/duration/calculate/subtractDuration.d.ts +1 -1
  91. package/dist/duration/calculate/subtractDuration.js +31 -30
  92. package/dist/duration/calculate/totalDuration.d.ts +21 -16
  93. package/dist/duration/calculate/totalDuration.js +80 -77
  94. package/dist/duration/calculate/totalUnits.d.ts +4 -2
  95. package/dist/duration/calculate/totalUnits.js +67 -68
  96. package/dist/duration/calculate/totalUnitsFromNow.d.ts +48 -0
  97. package/dist/duration/calculate/totalUnitsFromNow.js +60 -0
  98. package/dist/duration/calculate/ttlFromNow.d.ts +52 -0
  99. package/dist/duration/calculate/ttlFromNow.js +61 -0
  100. package/dist/duration/compare/compareDurations.d.ts +16 -15
  101. package/dist/duration/compare/compareDurations.js +67 -67
  102. package/dist/duration/compare/index.d.ts +2 -1
  103. package/dist/duration/compare/index.js +3 -1
  104. package/dist/duration/format/formatDuration.d.ts +25 -25
  105. package/dist/duration/format/formatDuration.js +94 -118
  106. package/dist/duration/format/formatHumanDuration.d.ts +32 -0
  107. package/dist/duration/format/formatHumanDuration.js +60 -0
  108. package/dist/duration/format/index.d.ts +3 -1
  109. package/dist/duration/format/index.js +4 -1
  110. package/dist/duration/index.d.ts +24 -7
  111. package/dist/duration/index.js +21 -8
  112. package/dist/duration/normalize/index.d.ts +2 -1
  113. package/dist/duration/normalize/index.js +3 -1
  114. package/dist/duration/normalize/normalizeDuration.d.ts +46 -45
  115. package/dist/duration/normalize/normalizeDuration.js +65 -65
  116. package/dist/duration/parse/index.d.ts +3 -1
  117. package/dist/duration/parse/index.js +4 -1
  118. package/dist/duration/parse/parseDuration.d.ts +25 -25
  119. package/dist/duration/parse/parseDuration.js +32 -34
  120. package/dist/duration/parse/parseHumanDuration.d.ts +71 -0
  121. package/dist/duration/parse/parseHumanDuration.js +86 -0
  122. package/dist/duration/validate/index.d.ts +2 -1
  123. package/dist/duration/validate/index.js +3 -1
  124. package/dist/duration/validate/isValidDuration.d.ts +6 -1
  125. package/dist/duration/validate/isValidDuration.js +7 -27
  126. package/dist/gnss/convert/gnssToUtc.d.ts +24 -0
  127. package/dist/gnss/convert/gnssToUtc.js +40 -0
  128. package/dist/gnss/convert/gnssWeekToUtc.d.ts +53 -0
  129. package/dist/gnss/convert/gnssWeekToUtc.js +77 -0
  130. package/dist/gnss/convert/index.d.ts +7 -0
  131. package/dist/gnss/convert/index.js +8 -0
  132. package/dist/gnss/convert/rinexWeekToUtc.d.ts +34 -0
  133. package/dist/gnss/convert/rinexWeekToUtc.js +57 -0
  134. package/dist/gnss/convert/utcToGnss.d.ts +38 -0
  135. package/dist/gnss/convert/utcToGnss.js +54 -0
  136. package/dist/gnss/convert/utcToGnssWeek.d.ts +24 -0
  137. package/dist/gnss/convert/utcToGnssWeek.js +40 -0
  138. package/dist/gnss/convert/utcToRinexWeek.d.ts +19 -0
  139. package/dist/gnss/convert/utcToRinexWeek.js +42 -0
  140. package/dist/gnss/index.d.ts +8 -0
  141. package/dist/gnss/index.js +9 -0
  142. package/dist/index.d.ts +821 -16
  143. package/dist/index.js +757 -16
  144. package/dist/instant/convert/classifyLocal.d.ts +5 -5
  145. package/dist/instant/convert/classifyLocal.js +57 -68
  146. package/dist/instant/convert/fromOffsetInstant.d.ts +6 -6
  147. package/dist/instant/convert/fromOffsetInstant.js +81 -95
  148. package/dist/instant/convert/index.d.ts +5 -4
  149. package/dist/instant/convert/index.js +6 -4
  150. package/dist/instant/convert/resolveLocal.d.ts +21 -20
  151. package/dist/instant/convert/resolveLocal.js +64 -74
  152. package/dist/instant/convert/toOffsetInstant.d.ts +29 -29
  153. package/dist/instant/convert/toOffsetInstant.js +125 -170
  154. package/dist/instant/index.d.ts +10 -3
  155. package/dist/instant/index.js +10 -4
  156. package/dist/instant/parse/index.d.ts +2 -0
  157. package/dist/instant/parse/index.js +3 -0
  158. package/dist/instant/parse/parseSqlOffsetDateTime.d.ts +47 -0
  159. package/dist/instant/parse/parseSqlOffsetDateTime.js +58 -0
  160. package/dist/instant/validate/index.d.ts +3 -1
  161. package/dist/instant/validate/index.js +4 -1
  162. package/dist/instant/validate/isValidSqlOffsetDateTime.d.ts +37 -0
  163. package/dist/instant/validate/isValidSqlOffsetDateTime.js +8 -0
  164. package/dist/instant/validate/isValidUtcOffset.d.ts +7 -2
  165. package/dist/instant/validate/isValidUtcOffset.js +7 -34
  166. package/dist/intermodal/calculate/billingTimeline.d.ts +48 -48
  167. package/dist/intermodal/calculate/billingTimeline.js +112 -135
  168. package/dist/intermodal/calculate/chargeableDays.d.ts +47 -46
  169. package/dist/intermodal/calculate/chargeableDays.js +93 -101
  170. package/dist/intermodal/calculate/demurrageClock.d.ts +25 -24
  171. package/dist/intermodal/calculate/demurrageClock.js +105 -127
  172. package/dist/intermodal/calculate/freeTimeExpiry.d.ts +19 -18
  173. package/dist/intermodal/calculate/freeTimeExpiry.js +88 -90
  174. package/dist/intermodal/calculate/index.d.ts +6 -5
  175. package/dist/intermodal/calculate/index.js +7 -5
  176. package/dist/intermodal/calculate/multimodalETA.d.ts +18 -18
  177. package/dist/intermodal/calculate/multimodalETA.js +115 -139
  178. package/dist/intermodal/format/bolTimestamp.d.ts +15 -15
  179. package/dist/intermodal/format/bolTimestamp.js +70 -73
  180. package/dist/intermodal/format/formatEdifactDate.d.ts +2 -2
  181. package/dist/intermodal/format/formatEdifactDate.js +41 -39
  182. package/dist/intermodal/format/formatEdifactDatePeriod.d.ts +2 -2
  183. package/dist/intermodal/format/formatEdifactDatePeriod.js +42 -40
  184. package/dist/intermodal/format/formatEdifactDateTime.d.ts +2 -2
  185. package/dist/intermodal/format/formatEdifactDateTime.js +44 -42
  186. package/dist/intermodal/format/formatEdifactDateTimePeriod.d.ts +2 -2
  187. package/dist/intermodal/format/formatEdifactDateTimePeriod.js +47 -45
  188. package/dist/intermodal/format/formatEdifactOffsetDateTime.d.ts +2 -2
  189. package/dist/intermodal/format/formatEdifactOffsetDateTime.js +69 -67
  190. package/dist/intermodal/format/formatEdifactTime.d.ts +2 -2
  191. package/dist/intermodal/format/formatEdifactTime.js +42 -40
  192. package/dist/intermodal/format/formatEpcisEvent.d.ts +5 -4
  193. package/dist/intermodal/format/formatEpcisEvent.js +69 -77
  194. package/dist/intermodal/format/formatX12Date.d.ts +2 -2
  195. package/dist/intermodal/format/formatX12Date.js +42 -40
  196. package/dist/intermodal/format/formatX12DateRange.d.ts +2 -2
  197. package/dist/intermodal/format/formatX12DateRange.js +44 -42
  198. package/dist/intermodal/format/formatX12DateTime.d.ts +2 -2
  199. package/dist/intermodal/format/formatX12DateTime.js +46 -44
  200. package/dist/intermodal/format/formatX12DateTimeRange.d.ts +2 -2
  201. package/dist/intermodal/format/formatX12DateTimeRange.js +47 -45
  202. package/dist/intermodal/format/formatX12Time.d.ts +2 -2
  203. package/dist/intermodal/format/formatX12Time.js +49 -47
  204. package/dist/intermodal/format/formatX12TimeElement.d.ts +2 -2
  205. package/dist/intermodal/format/formatX12TimeElement.js +53 -51
  206. package/dist/intermodal/format/index.d.ts +15 -14
  207. package/dist/intermodal/format/index.js +16 -14
  208. package/dist/intermodal/index.d.ts +60 -5
  209. package/dist/intermodal/index.js +58 -6
  210. package/dist/intermodal/parse/classifyEdifactDtmFormat.d.ts +2 -2
  211. package/dist/intermodal/parse/classifyEdifactDtmFormat.js +55 -52
  212. package/dist/intermodal/parse/classifyX12DateTimePeriodFormat.d.ts +2 -2
  213. package/dist/intermodal/parse/classifyX12DateTimePeriodFormat.js +57 -54
  214. package/dist/intermodal/parse/classifyX12TimeCode.d.ts +2 -2
  215. package/dist/intermodal/parse/classifyX12TimeCode.js +57 -53
  216. package/dist/intermodal/parse/index.d.ts +19 -18
  217. package/dist/intermodal/parse/index.js +20 -18
  218. package/dist/intermodal/parse/parseEdifactDate.d.ts +2 -2
  219. package/dist/intermodal/parse/parseEdifactDate.js +44 -42
  220. package/dist/intermodal/parse/parseEdifactDatePeriod.d.ts +2 -2
  221. package/dist/intermodal/parse/parseEdifactDatePeriod.js +50 -48
  222. package/dist/intermodal/parse/parseEdifactDateTime.d.ts +2 -2
  223. package/dist/intermodal/parse/parseEdifactDateTime.js +50 -48
  224. package/dist/intermodal/parse/parseEdifactDateTimePeriod.d.ts +2 -2
  225. package/dist/intermodal/parse/parseEdifactDateTimePeriod.js +52 -50
  226. package/dist/intermodal/parse/parseEdifactOffsetDateTime.d.ts +2 -2
  227. package/dist/intermodal/parse/parseEdifactOffsetDateTime.js +67 -65
  228. package/dist/intermodal/parse/parseEdifactTime.d.ts +2 -2
  229. package/dist/intermodal/parse/parseEdifactTime.js +44 -42
  230. package/dist/intermodal/parse/parseEpcisEvent.d.ts +24 -23
  231. package/dist/intermodal/parse/parseEpcisEvent.js +88 -100
  232. package/dist/intermodal/parse/parseX12Date.d.ts +2 -2
  233. package/dist/intermodal/parse/parseX12Date.js +46 -44
  234. package/dist/intermodal/parse/parseX12DateAndTime.d.ts +1 -1
  235. package/dist/intermodal/parse/parseX12DateAndTime.js +60 -58
  236. package/dist/intermodal/parse/parseX12DateRange.d.ts +2 -2
  237. package/dist/intermodal/parse/parseX12DateRange.js +51 -49
  238. package/dist/intermodal/parse/parseX12DateTime.d.ts +2 -2
  239. package/dist/intermodal/parse/parseX12DateTime.js +52 -50
  240. package/dist/intermodal/parse/parseX12DateTimeRange.d.ts +2 -2
  241. package/dist/intermodal/parse/parseX12DateTimeRange.js +53 -51
  242. package/dist/intermodal/parse/parseX12Time.d.ts +2 -2
  243. package/dist/intermodal/parse/parseX12Time.js +72 -74
  244. package/dist/intermodal/parse/x12TimeCodeOffset.d.ts +2 -2
  245. package/dist/intermodal/parse/x12TimeCodeOffset.js +98 -105
  246. package/dist/intermodal/parse/x12TimeCodeZone.d.ts +6 -4
  247. package/dist/intermodal/parse/x12TimeCodeZone.js +115 -101
  248. package/dist/intermodal/validate/index.d.ts +19 -18
  249. package/dist/intermodal/validate/index.js +20 -18
  250. package/dist/intermodal/validate/isValidEdifactDate.d.ts +2 -2
  251. package/dist/intermodal/validate/isValidEdifactDate.js +29 -25
  252. package/dist/intermodal/validate/isValidEdifactDatePeriod.d.ts +2 -2
  253. package/dist/intermodal/validate/isValidEdifactDatePeriod.js +31 -27
  254. package/dist/intermodal/validate/isValidEdifactDateTime.d.ts +2 -2
  255. package/dist/intermodal/validate/isValidEdifactDateTime.js +33 -29
  256. package/dist/intermodal/validate/isValidEdifactDateTimePeriod.d.ts +2 -2
  257. package/dist/intermodal/validate/isValidEdifactDateTimePeriod.js +31 -27
  258. package/dist/intermodal/validate/isValidEdifactDtmFormat.d.ts +2 -2
  259. package/dist/intermodal/validate/isValidEdifactDtmFormat.js +43 -40
  260. package/dist/intermodal/validate/isValidEdifactOffsetDateTime.d.ts +2 -2
  261. package/dist/intermodal/validate/isValidEdifactOffsetDateTime.js +39 -35
  262. package/dist/intermodal/validate/isValidEdifactTime.d.ts +2 -2
  263. package/dist/intermodal/validate/isValidEdifactTime.js +31 -27
  264. package/dist/intermodal/validate/isValidEpcisEvent.d.ts +1 -1
  265. package/dist/intermodal/validate/isValidEpcisEvent.js +52 -54
  266. package/dist/intermodal/validate/isValidEpcisEventTime.d.ts +6 -2
  267. package/dist/intermodal/validate/isValidEpcisEventTime.js +14 -47
  268. package/dist/intermodal/validate/isValidEpcisTimeZoneOffset.d.ts +6 -1
  269. package/dist/intermodal/validate/isValidEpcisTimeZoneOffset.js +8 -37
  270. package/dist/intermodal/validate/isValidX12Date.d.ts +2 -2
  271. package/dist/intermodal/validate/isValidX12Date.js +31 -27
  272. package/dist/intermodal/validate/isValidX12DateAndTime.d.ts +1 -1
  273. package/dist/intermodal/validate/isValidX12DateAndTime.js +36 -32
  274. package/dist/intermodal/validate/isValidX12DateRange.d.ts +2 -2
  275. package/dist/intermodal/validate/isValidX12DateRange.js +32 -28
  276. package/dist/intermodal/validate/isValidX12DateTime.d.ts +2 -2
  277. package/dist/intermodal/validate/isValidX12DateTime.js +33 -29
  278. package/dist/intermodal/validate/isValidX12DateTimePeriodFormat.d.ts +2 -2
  279. package/dist/intermodal/validate/isValidX12DateTimePeriodFormat.js +47 -44
  280. package/dist/intermodal/validate/isValidX12DateTimeRange.d.ts +2 -2
  281. package/dist/intermodal/validate/isValidX12DateTimeRange.js +34 -30
  282. package/dist/intermodal/validate/isValidX12Time.d.ts +2 -2
  283. package/dist/intermodal/validate/isValidX12Time.js +41 -37
  284. package/dist/intermodal/validate/isValidX12TimeCode.d.ts +2 -2
  285. package/dist/intermodal/validate/isValidX12TimeCode.js +42 -39
  286. package/dist/internal/adjustZonedBusinessDays.d.ts +1 -1
  287. package/dist/internal/adjustZonedBusinessDays.js +16 -16
  288. package/dist/internal/advanceToWeekday.d.ts +2 -2
  289. package/dist/internal/advanceToWeekday.js +20 -22
  290. package/dist/internal/arrowTimestamp.d.ts +26 -0
  291. package/dist/internal/arrowTimestamp.js +67 -0
  292. package/dist/internal/businessCalendar.d.ts +46 -15
  293. package/dist/internal/businessCalendar.js +171 -201
  294. package/dist/internal/businessDayValues.d.ts +3 -2
  295. package/dist/internal/businessDayValues.js +42 -49
  296. package/dist/internal/calendarDatePairPolicy.d.ts +7 -6
  297. package/dist/internal/calendarDatePairPolicy.js +29 -23
  298. package/dist/internal/calendarDateString.d.ts +2 -2
  299. package/dist/internal/calendarDateString.js +51 -56
  300. package/dist/internal/calendarSystemIds.d.ts +3 -2
  301. package/dist/internal/calendarSystemIds.js +51 -52
  302. package/dist/internal/calendarValueOfDate.d.ts +3 -2
  303. package/dist/internal/calendarValueOfDate.js +32 -37
  304. package/dist/internal/calendarValueOfZoned.d.ts +3 -2
  305. package/dist/internal/calendarValueOfZoned.js +46 -51
  306. package/dist/internal/calendarZonedPairPolicy.d.ts +7 -6
  307. package/dist/internal/calendarZonedPairPolicy.js +30 -24
  308. package/dist/internal/calendarZonedString.d.ts +10 -7
  309. package/dist/internal/calendarZonedString.js +61 -65
  310. package/dist/internal/compareUnixEpochs.d.ts +2 -2
  311. package/dist/internal/compareUnixEpochs.js +22 -22
  312. package/dist/internal/cronMatch.d.ts +56 -0
  313. package/dist/internal/cronMatch.js +91 -0
  314. package/dist/internal/cronText.d.ts +13 -0
  315. package/dist/internal/cronText.js +279 -0
  316. package/dist/internal/cutoffAtResolved.d.ts +63 -0
  317. package/dist/internal/cutoffAtResolved.js +135 -0
  318. package/dist/internal/cycleFieldValue.d.ts +3 -5
  319. package/dist/internal/cycleFieldValue.js +42 -48
  320. package/dist/internal/dateCycleFieldBounds.d.ts +7 -6
  321. package/dist/internal/dateCycleFieldBounds.js +31 -25
  322. package/dist/internal/dateTimeUnitHelpers.d.ts +2 -2
  323. package/dist/internal/dateTimeUnitHelpers.js +68 -71
  324. package/dist/internal/dateUnitHelpers.d.ts +2 -2
  325. package/dist/internal/dateUnitHelpers.js +96 -97
  326. package/dist/internal/daylightTime.d.ts +2 -2
  327. package/dist/internal/daylightTime.js +113 -142
  328. package/dist/internal/defaultFractionalDigits.d.ts +3 -2
  329. package/dist/internal/defaultFractionalDigits.js +19 -18
  330. package/dist/internal/differenceRecord.d.ts +4 -4
  331. package/dist/internal/differenceRecord.js +67 -68
  332. package/dist/internal/divisionBoundary.d.ts +1 -1
  333. package/dist/internal/divisionBoundary.js +23 -21
  334. package/dist/internal/durationUntilString.d.ts +5 -3
  335. package/dist/internal/durationUntilString.js +21 -20
  336. package/dist/internal/dutyEngine.d.ts +41 -40
  337. package/dist/internal/dutyEngine.js +1287 -1622
  338. package/dist/internal/dutyLog.d.ts +6 -6
  339. package/dist/internal/dutyLog.js +39 -44
  340. package/dist/internal/dutyPeriods.d.ts +24 -24
  341. package/dist/internal/dutyPeriods.js +291 -332
  342. package/dist/internal/dutyRules.d.ts +129 -127
  343. package/dist/internal/dutyRules.js +386 -428
  344. package/dist/internal/dutyRunIndex.d.ts +150 -0
  345. package/dist/internal/dutyRunIndex.js +392 -0
  346. package/dist/internal/earlierOccurrence.d.ts +41 -0
  347. package/dist/internal/earlierOccurrence.js +59 -0
  348. package/dist/internal/easter.d.ts +9 -0
  349. package/dist/internal/easter.js +52 -0
  350. package/dist/internal/ediDateTimeFields.d.ts +4 -4
  351. package/dist/internal/ediDateTimeFields.js +222 -252
  352. package/dist/internal/ediDateTimeWriter.d.ts +2 -2
  353. package/dist/internal/ediDateTimeWriter.js +205 -248
  354. package/dist/internal/ediGrammar.d.ts +16 -18
  355. package/dist/internal/ediGrammar.js +508 -341
  356. package/dist/internal/englishCalendarNames.d.ts +12 -1
  357. package/dist/internal/englishCalendarNames.js +50 -47
  358. package/dist/internal/epochDay.d.ts +41 -0
  359. package/dist/internal/epochDay.js +106 -0
  360. package/dist/internal/epochNanoseconds.d.ts +1 -1
  361. package/dist/internal/epochNanoseconds.js +28 -27
  362. package/dist/internal/exactDuration.d.ts +1 -1
  363. package/dist/internal/exactDuration.js +51 -58
  364. package/dist/internal/exactMoment.d.ts +12 -12
  365. package/dist/internal/exactMoment.js +101 -104
  366. package/dist/internal/exactSeconds.d.ts +10 -0
  367. package/dist/internal/exactSeconds.js +19 -0
  368. package/dist/internal/fiscalCalendar.d.ts +44 -9
  369. package/dist/internal/fiscalCalendar.js +155 -69
  370. package/dist/internal/floorDivide.d.ts +1 -1
  371. package/dist/internal/floorDivide.js +18 -16
  372. package/dist/internal/foreignEpochs.d.ts +29 -0
  373. package/dist/internal/foreignEpochs.js +149 -122
  374. package/dist/internal/formatCalendarDays.d.ts +5 -5
  375. package/dist/internal/formatCalendarDays.js +41 -42
  376. package/dist/internal/formatDateInCalendar.d.ts +4 -3
  377. package/dist/internal/formatDateInCalendar.js +24 -21
  378. package/dist/internal/formatRelativeDuration.d.ts +16 -13
  379. package/dist/internal/formatRelativeDuration.js +91 -74
  380. package/dist/internal/formatterCache.d.ts +40 -0
  381. package/dist/internal/formatterCache.js +156 -0
  382. package/dist/internal/freeTimeLedger.d.ts +47 -59
  383. package/dist/internal/freeTimeLedger.js +411 -246
  384. package/dist/internal/getLocaleFirstDayOfWeek.d.ts +2 -2
  385. package/dist/internal/getLocaleFirstDayOfWeek.js +23 -22
  386. package/dist/internal/getLocaleWeekYearBounds.d.ts +7 -7
  387. package/dist/internal/getLocaleWeekYearBounds.js +47 -53
  388. package/dist/internal/getLocaleWeekendDays.d.ts +2 -2
  389. package/dist/internal/getLocaleWeekendDays.js +22 -21
  390. package/dist/internal/gnssTimeScales.d.ts +53 -0
  391. package/dist/internal/gnssTimeScales.js +100 -0
  392. package/dist/internal/gnssWeek.d.ts +92 -0
  393. package/dist/internal/gnssWeek.js +204 -0
  394. package/dist/internal/halfOpenIntervals.d.ts +4 -4
  395. package/dist/internal/halfOpenIntervals.js +136 -162
  396. package/dist/internal/hasCalendarAnnotation.d.ts +4 -4
  397. package/dist/internal/hasCalendarAnnotation.js +30 -27
  398. package/dist/internal/holidayRules.d.ts +81 -0
  399. package/dist/internal/holidayRules.js +336 -0
  400. package/dist/internal/hourDurationString.d.ts +1 -1
  401. package/dist/internal/hourDurationString.js +44 -43
  402. package/dist/internal/httpDateFields.d.ts +10 -10
  403. package/dist/internal/httpDateFields.js +66 -76
  404. package/dist/internal/humanDuration.d.ts +36 -0
  405. package/dist/internal/humanDuration.js +190 -0
  406. package/dist/internal/identifierText.d.ts +42 -0
  407. package/dist/internal/identifierText.js +51 -0
  408. package/dist/internal/index.d.ts +78 -63
  409. package/dist/internal/index.js +79 -67
  410. package/dist/internal/inputChecks.d.ts +99 -0
  411. package/dist/internal/inputChecks.js +190 -0
  412. package/dist/internal/instantFormatOptions.d.ts +2 -2
  413. package/dist/internal/instantFormatOptions.js +77 -91
  414. package/dist/internal/instantIntervalText.d.ts +5 -5
  415. package/dist/internal/instantIntervalText.js +26 -23
  416. package/dist/internal/instantNanoseconds.d.ts +3 -3
  417. package/dist/internal/instantNanoseconds.js +169 -200
  418. package/dist/internal/instantStringFromEpochNanoseconds.d.ts +8 -0
  419. package/dist/internal/instantStringFromEpochNanoseconds.js +20 -0
  420. package/dist/internal/intervalCountHelpers.d.ts +14 -13
  421. package/dist/internal/intervalCountHelpers.js +31 -28
  422. package/dist/internal/intervalNanoseconds.d.ts +5 -5
  423. package/dist/internal/intervalNanoseconds.js +73 -80
  424. package/dist/internal/isObject.d.ts +1 -1
  425. package/dist/internal/isObject.js +36 -33
  426. package/dist/internal/isValidAmount.d.ts +1 -1
  427. package/dist/internal/isValidAmount.js +12 -9
  428. package/dist/internal/isValidDayOfWeek.d.ts +1 -1
  429. package/dist/internal/isValidDayOfWeek.js +14 -11
  430. package/dist/internal/isYearMonthDurationUnit.d.ts +11 -0
  431. package/dist/internal/isYearMonthDurationUnit.js +16 -0
  432. package/dist/internal/isoStringBody.d.ts +3 -3
  433. package/dist/internal/isoStringBody.js +92 -90
  434. package/dist/internal/isoYearString.d.ts +1 -1
  435. package/dist/internal/isoYearString.js +24 -23
  436. package/dist/internal/joinDateTimeConnector.d.ts +1 -1
  437. package/dist/internal/joinDateTimeConnector.js +73 -82
  438. package/dist/internal/leapSeconds.d.ts +63 -0
  439. package/dist/internal/leapSeconds.js +140 -0
  440. package/dist/internal/lengthFromNow.d.ts +92 -0
  441. package/dist/internal/lengthFromNow.js +117 -0
  442. package/dist/internal/localResolution.d.ts +67 -0
  443. package/dist/internal/localResolution.js +228 -0
  444. package/dist/internal/localeMonthNames.d.ts +35 -0
  445. package/dist/internal/localeMonthNames.js +61 -0
  446. package/dist/internal/localeWeekInfo.d.ts +13 -13
  447. package/dist/internal/localeWeekInfo.js +25 -24
  448. package/dist/internal/maxPieces.d.ts +2 -2
  449. package/dist/internal/maxPieces.js +45 -47
  450. package/dist/internal/measureNearRangeEnd.d.ts +8 -8
  451. package/dist/internal/measureNearRangeEnd.js +40 -40
  452. package/dist/internal/monthDay.d.ts +19 -0
  453. package/dist/internal/monthDay.js +23 -0
  454. package/dist/internal/monthGridWeekRow.d.ts +2 -2
  455. package/dist/internal/monthGridWeekRow.js +19 -16
  456. package/dist/internal/normalizeDateTime.d.ts +5 -4
  457. package/dist/internal/normalizeDateTime.js +24 -32
  458. package/dist/internal/normalizeTimeZone.d.ts +2 -2
  459. package/dist/internal/normalizeTimeZone.js +31 -32
  460. package/dist/internal/nthWeekday.d.ts +27 -0
  461. package/dist/internal/nthWeekday.js +56 -0
  462. package/dist/internal/observance.d.ts +18 -0
  463. package/dist/internal/observance.js +56 -0
  464. package/dist/internal/offsetTimeline.d.ts +57 -0
  465. package/dist/internal/offsetTimeline.js +132 -0
  466. package/dist/internal/operatingSchedule.d.ts +44 -47
  467. package/dist/internal/operatingSchedule.js +878 -705
  468. package/dist/internal/optionOrDefault.d.ts +1 -1
  469. package/dist/internal/optionOrDefault.js +21 -18
  470. package/dist/internal/patternToken.d.ts +24 -9
  471. package/dist/internal/patternToken.js +439 -395
  472. package/dist/internal/plainDateAdd.d.ts +2 -2
  473. package/dist/internal/plainDateAdd.js +33 -36
  474. package/dist/internal/plainDateUntil.d.ts +4 -3
  475. package/dist/internal/plainDateUntil.js +39 -47
  476. package/dist/internal/plainFormatOptions.d.ts +56 -1
  477. package/dist/internal/plainFormatOptions.js +334 -149
  478. package/dist/internal/position.d.ts +66 -0
  479. package/dist/internal/position.js +54 -0
  480. package/dist/internal/prefixMilliseconds.d.ts +9 -0
  481. package/dist/internal/prefixMilliseconds.js +21 -0
  482. package/dist/internal/protoRecord.d.ts +22 -0
  483. package/dist/internal/protoRecord.js +36 -0
  484. package/dist/internal/punctuality.d.ts +5 -4
  485. package/dist/internal/punctuality.js +51 -54
  486. package/dist/internal/readDateTimeFormatOptions.d.ts +1 -1
  487. package/dist/internal/readDateTimeFormatOptions.js +78 -85
  488. package/dist/internal/readDurationUnits.d.ts +3 -2
  489. package/dist/internal/readDurationUnits.js +64 -71
  490. package/dist/internal/readSetFields.d.ts +2 -4
  491. package/dist/internal/readSetFields.js +138 -152
  492. package/dist/internal/recurrenceExpansion.d.ts +103 -0
  493. package/dist/internal/recurrenceExpansion.js +833 -0
  494. package/dist/internal/recurrenceRuleText.d.ts +14 -0
  495. package/dist/internal/recurrenceRuleText.js +342 -0
  496. package/dist/internal/repairRangeParts.d.ts +30 -0
  497. package/dist/internal/repairRangeParts.js +41 -0
  498. package/dist/internal/resolveDateTimeUnit.d.ts +1 -1
  499. package/dist/internal/resolveDateTimeUnit.js +11 -11
  500. package/dist/internal/resolveDurationRelativeTo.d.ts +4 -3
  501. package/dist/internal/resolveDurationRelativeTo.js +64 -77
  502. package/dist/internal/resolveDurationUnit.d.ts +1 -1
  503. package/dist/internal/resolveDurationUnit.js +10 -12
  504. package/dist/internal/resolveLocale.d.ts +3 -3
  505. package/dist/internal/resolveLocale.js +46 -55
  506. package/dist/internal/resolveManualRoundingOptions.d.ts +4 -4
  507. package/dist/internal/resolveManualRoundingOptions.js +37 -34
  508. package/dist/internal/resolveMinimalDaysInFirstWeek.d.ts +2 -2
  509. package/dist/internal/resolveMinimalDaysInFirstWeek.js +24 -24
  510. package/dist/internal/resolveOverflow.d.ts +3 -2
  511. package/dist/internal/resolveOverflow.js +18 -15
  512. package/dist/internal/resolveRelativeRounding.d.ts +3 -2
  513. package/dist/internal/resolveRelativeRounding.js +37 -38
  514. package/dist/internal/resolveRelativeUnit.d.ts +3 -2
  515. package/dist/internal/resolveRelativeUnit.js +35 -38
  516. package/dist/internal/resolveUnixIntervalPair.d.ts +12 -12
  517. package/dist/internal/resolveUnixIntervalPair.js +48 -54
  518. package/dist/internal/resolveWeekStartsOn.d.ts +1 -1
  519. package/dist/internal/resolveWeekStartsOn.js +16 -16
  520. package/dist/internal/rfc5322DateTime.d.ts +11 -11
  521. package/dist/internal/rfc5322DateTime.js +99 -157
  522. package/dist/internal/rinexWeek.d.ts +22 -0
  523. package/dist/internal/rinexWeek.js +40 -0
  524. package/dist/internal/rollBusinessDate.d.ts +16 -0
  525. package/dist/internal/rollBusinessDate.js +37 -0
  526. package/dist/internal/splitStep.d.ts +3 -3
  527. package/dist/internal/splitStep.js +173 -191
  528. package/dist/internal/sqlDateTime.d.ts +12 -0
  529. package/dist/internal/sqlDateTime.js +26 -0
  530. package/dist/internal/sqlOffsetDateTime.d.ts +22 -0
  531. package/dist/internal/sqlOffsetDateTime.js +41 -0
  532. package/dist/internal/startOrEndOfUnix.d.ts +5 -5
  533. package/dist/internal/startOrEndOfUnix.js +41 -46
  534. package/dist/internal/startOrEndOfUtc.d.ts +6 -5
  535. package/dist/internal/startOrEndOfUtc.js +144 -158
  536. package/dist/internal/startOrEndOfZoned.d.ts +7 -5
  537. package/dist/internal/startOrEndOfZoned.js +36 -42
  538. package/dist/internal/temporal.d.ts +2 -0
  539. package/dist/internal/temporal.js +3 -0
  540. package/dist/internal/temporalCompat/calendarDateArithmetic.d.ts +9 -3
  541. package/dist/internal/temporalCompat/calendarDateArithmetic.js +132 -168
  542. package/dist/internal/temporalCompat/calendarDateFromFields.d.ts +10 -7
  543. package/dist/internal/temporalCompat/calendarDateFromFields.js +88 -98
  544. package/dist/internal/temporalCompat/calendarDateFromMonthCode.d.ts +22 -0
  545. package/dist/internal/temporalCompat/calendarDateFromMonthCode.js +77 -0
  546. package/dist/internal/temporalCompat/calendarFields.d.ts +22 -9
  547. package/dist/internal/temporalCompat/calendarFields.js +139 -102
  548. package/dist/internal/temporalCompat/capabilities.d.ts +83 -6
  549. package/dist/internal/temporalCompat/capabilities.js +175 -87
  550. package/dist/internal/temporalCompat/clock.d.ts +41 -0
  551. package/dist/internal/temporalCompat/clock.js +72 -0
  552. package/dist/internal/temporalCompat/fieldSearch.d.ts +5 -5
  553. package/dist/internal/temporalCompat/fieldSearch.js +39 -58
  554. package/dist/internal/temporalCompat/fixedDay.d.ts +2 -2
  555. package/dist/internal/temporalCompat/fixedDay.js +32 -36
  556. package/dist/internal/temporalCompat/fixedMonthArithmetic.d.ts +5 -0
  557. package/dist/internal/temporalCompat/fixedMonthArithmetic.js +16 -0
  558. package/dist/internal/temporalCompat/hebrewArithmetic.d.ts +7 -7
  559. package/dist/internal/temporalCompat/hebrewArithmetic.js +91 -122
  560. package/dist/internal/temporalCompat/index.d.ts +9 -4
  561. package/dist/internal/temporalCompat/index.js +10 -5
  562. package/dist/internal/temporalCompat/indianArithmetic.d.ts +6 -6
  563. package/dist/internal/temporalCompat/indianArithmetic.js +53 -74
  564. package/dist/internal/temporalCompat/islamicEra.d.ts +6 -0
  565. package/dist/internal/temporalCompat/islamicEra.js +50 -0
  566. package/dist/internal/temporalCompat/isoCalendarFrom.d.ts +38 -0
  567. package/dist/internal/temporalCompat/isoCalendarFrom.js +59 -0
  568. package/dist/internal/temporalCompat/largeMonthSpan.d.ts +7 -2
  569. package/dist/internal/temporalCompat/largeMonthSpan.js +125 -160
  570. package/dist/internal/temporalCompat/nonIsoArithmetic.d.ts +24 -24
  571. package/dist/internal/temporalCompat/nonIsoArithmetic.js +135 -177
  572. package/dist/internal/temporalCompat/probeRepros.d.ts +50 -0
  573. package/dist/internal/temporalCompat/probeRepros.js +887 -0
  574. package/dist/internal/temporalCompat/readArithmeticModel.d.ts +2 -2
  575. package/dist/internal/temporalCompat/readArithmeticModel.js +208 -230
  576. package/dist/internal/temporalCompat/repros.d.ts +10 -16
  577. package/dist/internal/temporalCompat/repros.js +181 -677
  578. package/dist/internal/temporalCompat/timeZoneEquals.d.ts +38 -0
  579. package/dist/internal/temporalCompat/timeZoneEquals.js +68 -0
  580. package/dist/internal/timeCycleFieldBounds.d.ts +5 -4
  581. package/dist/internal/timeCycleFieldBounds.js +31 -22
  582. package/dist/internal/timeScaleString.d.ts +47 -0
  583. package/dist/internal/timeScaleString.js +74 -0
  584. package/dist/internal/timestampEvents.d.ts +8 -7
  585. package/dist/internal/timestampEvents.js +56 -69
  586. package/dist/internal/toInstantFromUtc.d.ts +2 -2
  587. package/dist/internal/toInstantFromUtc.js +27 -27
  588. package/dist/internal/twoDigitYear.d.ts +1 -1
  589. package/dist/internal/twoDigitYear.js +23 -20
  590. package/dist/internal/unixEpochValue.d.ts +11 -11
  591. package/dist/internal/unixEpochValue.js +193 -222
  592. package/dist/internal/unixFormatReference.d.ts +3 -3
  593. package/dist/internal/unixFormatReference.js +36 -41
  594. package/dist/internal/unixWallClock.d.ts +4 -4
  595. package/dist/internal/unixWallClock.js +33 -32
  596. package/dist/internal/utcOffsetString.d.ts +16 -0
  597. package/dist/internal/utcOffsetString.js +77 -64
  598. package/dist/internal/utcReading.d.ts +59 -0
  599. package/dist/internal/utcReading.js +100 -0
  600. package/dist/internal/utcWallClock.d.ts +3 -3
  601. package/dist/internal/utcWallClock.js +30 -29
  602. package/dist/internal/validatedZones.d.ts +20 -0
  603. package/dist/internal/validatedZones.js +34 -0
  604. package/dist/internal/wallClockAtOffset.d.ts +2 -2
  605. package/dist/internal/wallClockAtOffset.js +24 -24
  606. package/dist/internal/yearMonth.d.ts +11 -0
  607. package/dist/internal/yearMonth.js +15 -0
  608. package/dist/internal/yearMonthArithmetic.d.ts +18 -0
  609. package/dist/internal/yearMonthArithmetic.js +42 -0
  610. package/dist/internal/yearWindowStart.d.ts +2 -2
  611. package/dist/internal/yearWindowStart.js +37 -43
  612. package/dist/internal/zoneBucketCap.d.ts +4 -3
  613. package/dist/internal/zoneBucketCap.js +49 -55
  614. package/dist/internal/zoneFrame.d.ts +15 -15
  615. package/dist/internal/zoneFrame.js +183 -196
  616. package/dist/internal/zonedBucket.d.ts +5 -4
  617. package/dist/internal/zonedBucket.js +384 -368
  618. package/dist/internal/zonedDifference/calendarArithmetic.d.ts +21 -0
  619. package/dist/internal/zonedDifference/calendarArithmetic.js +76 -0
  620. package/dist/internal/zonedDifference/nudgeOrigin.d.ts +30 -0
  621. package/dist/internal/zonedDifference/nudgeOrigin.js +53 -0
  622. package/dist/internal/zonedDifference/nudgeWindow.d.ts +40 -0
  623. package/dist/internal/zonedDifference/nudgeWindow.js +89 -0
  624. package/dist/internal/zonedDifference/operations.d.ts +99 -0
  625. package/dist/internal/zonedDifference/operations.js +613 -0
  626. package/dist/internal/zonedDifference/rangeLimit.d.ts +16 -0
  627. package/dist/internal/zonedDifference/rangeLimit.js +51 -0
  628. package/dist/internal/zonedDifference/utcValidity.d.ts +2 -0
  629. package/dist/internal/zonedDifference/utcValidity.js +9 -0
  630. package/dist/internal/zonedFormatReference.d.ts +2 -2
  631. package/dist/internal/zonedFormatReference.js +22 -21
  632. package/dist/internal/zonedLocalDates.d.ts +2 -2
  633. package/dist/internal/zonedLocalDates.js +50 -51
  634. package/dist/internal/zonedNowUnitValue.d.ts +2 -2
  635. package/dist/internal/zonedNowUnitValue.js +48 -57
  636. package/dist/internal/zonedTransitionSearch.d.ts +3 -1
  637. package/dist/internal/zonedTransitionSearch.js +241 -188
  638. package/dist/internal/zonedWallClock.d.ts +31 -10
  639. package/dist/internal/zonedWallClock.js +307 -404
  640. package/dist/internal/zonedWallClockDifference.d.ts +13 -46
  641. package/dist/internal/zonedWallClockDifference.js +140 -1167
  642. package/dist/internal/zonedWallClockOperations.d.ts +18 -15
  643. package/dist/internal/zonedWallClockOperations.js +388 -513
  644. package/dist/internal/zonelessCalendarDate.d.ts +2 -2
  645. package/dist/internal/zonelessCalendarDate.js +21 -19
  646. package/dist/interval/calculate/clampInterval.d.ts +3 -2
  647. package/dist/interval/calculate/clampInterval.js +29 -28
  648. package/dist/interval/calculate/index.d.ts +7 -6
  649. package/dist/interval/calculate/index.js +8 -6
  650. package/dist/interval/calculate/intersectIntervals.d.ts +3 -2
  651. package/dist/interval/calculate/intersectIntervals.js +38 -41
  652. package/dist/interval/calculate/mergeIntervals.d.ts +3 -2
  653. package/dist/interval/calculate/mergeIntervals.js +41 -42
  654. package/dist/interval/calculate/splitIntervalAt.d.ts +3 -2
  655. package/dist/interval/calculate/splitIntervalAt.js +56 -61
  656. package/dist/interval/calculate/subtractIntervals.d.ts +3 -2
  657. package/dist/interval/calculate/subtractIntervals.js +59 -62
  658. package/dist/interval/calculate/sumIntervals.d.ts +3 -2
  659. package/dist/interval/calculate/sumIntervals.js +38 -38
  660. package/dist/interval/compare/index.d.ts +3 -2
  661. package/dist/interval/compare/index.js +4 -2
  662. package/dist/interval/compare/intervalContains.d.ts +3 -2
  663. package/dist/interval/compare/intervalContains.js +37 -37
  664. package/dist/interval/compare/intervalsOverlap.d.ts +3 -2
  665. package/dist/interval/compare/intervalsOverlap.js +39 -40
  666. package/dist/interval/index.d.ts +14 -4
  667. package/dist/interval/index.js +12 -5
  668. package/dist/interval/validate/index.d.ts +2 -1
  669. package/dist/interval/validate/index.js +3 -1
  670. package/dist/interval/validate/isValidInterval.d.ts +3 -2
  671. package/dist/interval/validate/isValidInterval.js +40 -39
  672. package/dist/plain/calculate/addBusinessDays.d.ts +5 -4
  673. package/dist/plain/calculate/addBusinessDays.js +41 -40
  674. package/dist/plain/calculate/addDate.d.ts +11 -9
  675. package/dist/plain/calculate/addDate.js +58 -59
  676. package/dist/plain/calculate/addDateTime.d.ts +11 -9
  677. package/dist/plain/calculate/addDateTime.js +37 -43
  678. package/dist/plain/calculate/addTime.d.ts +3 -2
  679. package/dist/plain/calculate/addTime.js +37 -40
  680. package/dist/plain/calculate/addYearMonth.d.ts +40 -0
  681. package/dist/plain/calculate/addYearMonth.js +34 -0
  682. package/dist/plain/calculate/clampDate.d.ts +1 -1
  683. package/dist/plain/calculate/clampDate.js +39 -44
  684. package/dist/plain/calculate/closestDateTo.d.ts +1 -1
  685. package/dist/plain/calculate/closestDateTo.js +45 -53
  686. package/dist/plain/calculate/cycleDate.d.ts +19 -17
  687. package/dist/plain/calculate/cycleDate.js +56 -56
  688. package/dist/plain/calculate/cycleDateTime.d.ts +19 -17
  689. package/dist/plain/calculate/cycleDateTime.js +53 -53
  690. package/dist/plain/calculate/cycleTime.d.ts +11 -10
  691. package/dist/plain/calculate/cycleTime.js +51 -51
  692. package/dist/plain/calculate/diffDate.d.ts +5 -3
  693. package/dist/plain/calculate/diffDate.js +80 -95
  694. package/dist/plain/calculate/diffDateAsDuration.d.ts +6 -3
  695. package/dist/plain/calculate/diffDateAsDuration.js +58 -59
  696. package/dist/plain/calculate/diffDateTime.d.ts +5 -3
  697. package/dist/plain/calculate/diffDateTime.js +73 -92
  698. package/dist/plain/calculate/diffDateTimeAsDuration.d.ts +6 -3
  699. package/dist/plain/calculate/diffDateTimeAsDuration.js +51 -52
  700. package/dist/plain/calculate/diffTime.d.ts +5 -3
  701. package/dist/plain/calculate/diffTime.js +74 -93
  702. package/dist/plain/calculate/diffYearMonth.d.ts +25 -0
  703. package/dist/plain/calculate/diffYearMonth.js +44 -0
  704. package/dist/plain/calculate/endOfDate.d.ts +10 -10
  705. package/dist/plain/calculate/endOfDate.js +67 -70
  706. package/dist/plain/calculate/endOfDateTime.d.ts +20 -19
  707. package/dist/plain/calculate/endOfDateTime.js +141 -151
  708. package/dist/plain/calculate/endOfQuarterForDate.d.ts +1 -1
  709. package/dist/plain/calculate/endOfQuarterForDate.js +34 -32
  710. package/dist/plain/calculate/endOfQuarterForDateTime.d.ts +1 -1
  711. package/dist/plain/calculate/endOfQuarterForDateTime.js +42 -46
  712. package/dist/plain/calculate/endOfTime.d.ts +12 -11
  713. package/dist/plain/calculate/endOfTime.js +97 -103
  714. package/dist/plain/calculate/endOfYearMonth.d.ts +18 -0
  715. package/dist/plain/calculate/endOfYearMonth.js +31 -0
  716. package/dist/plain/calculate/getDayOfYear.d.ts +1 -1
  717. package/dist/plain/calculate/getDayOfYear.js +27 -26
  718. package/dist/plain/calculate/getDaysInMonth.d.ts +1 -1
  719. package/dist/plain/calculate/getDaysInMonth.js +27 -26
  720. package/dist/plain/calculate/getDaysInYear.d.ts +4 -1
  721. package/dist/plain/calculate/getDaysInYear.js +28 -24
  722. package/dist/plain/calculate/getDaysInYearMonth.d.ts +18 -0
  723. package/dist/plain/calculate/getDaysInYearMonth.js +31 -0
  724. package/dist/plain/calculate/getLargestDateDurationUnit.d.ts +4 -3
  725. package/dist/plain/calculate/getLargestDateDurationUnit.js +39 -36
  726. package/dist/plain/calculate/getLargestDateTimeDurationUnit.d.ts +4 -3
  727. package/dist/plain/calculate/getLargestDateTimeDurationUnit.js +43 -45
  728. package/dist/plain/calculate/getLargestTimeDurationUnit.d.ts +4 -3
  729. package/dist/plain/calculate/getLargestTimeDurationUnit.js +38 -40
  730. package/dist/plain/calculate/getLocaleDayOfWeek.d.ts +7 -7
  731. package/dist/plain/calculate/getLocaleDayOfWeek.js +38 -39
  732. package/dist/plain/calculate/getLocaleEndOfWeek.d.ts +5 -5
  733. package/dist/plain/calculate/getLocaleEndOfWeek.js +43 -43
  734. package/dist/plain/calculate/getLocaleStartOfWeek.d.ts +6 -6
  735. package/dist/plain/calculate/getLocaleStartOfWeek.js +43 -43
  736. package/dist/plain/calculate/getLocaleWeekYear.d.ts +19 -19
  737. package/dist/plain/calculate/getLocaleWeekYear.js +59 -62
  738. package/dist/plain/calculate/getQuarterForDate.d.ts +1 -1
  739. package/dist/plain/calculate/getQuarterForDate.js +29 -28
  740. package/dist/plain/calculate/getQuarterForDateTime.d.ts +1 -1
  741. package/dist/plain/calculate/getQuarterForDateTime.js +29 -28
  742. package/dist/plain/calculate/getWeekNumber.d.ts +1 -1
  743. package/dist/plain/calculate/getWeekNumber.js +52 -58
  744. package/dist/plain/calculate/getWeekOfMonth.d.ts +11 -15
  745. package/dist/plain/calculate/getWeekOfMonth.js +44 -49
  746. package/dist/plain/calculate/getWeekYear.d.ts +1 -1
  747. package/dist/plain/calculate/getWeekYear.js +32 -31
  748. package/dist/plain/calculate/getWeeksInLocaleWeekYear.d.ts +16 -16
  749. package/dist/plain/calculate/getWeeksInLocaleWeekYear.js +57 -60
  750. package/dist/plain/calculate/getWeeksInMonth.d.ts +9 -12
  751. package/dist/plain/calculate/getWeeksInMonth.js +42 -46
  752. package/dist/plain/calculate/getWeeksInYear.d.ts +1 -1
  753. package/dist/plain/calculate/getWeeksInYear.js +37 -36
  754. package/dist/plain/calculate/index.d.ts +72 -65
  755. package/dist/plain/calculate/index.js +73 -65
  756. package/dist/plain/calculate/maxDate.d.ts +1 -1
  757. package/dist/plain/calculate/maxDate.js +33 -38
  758. package/dist/plain/calculate/maxDateTime.d.ts +1 -1
  759. package/dist/plain/calculate/maxDateTime.js +33 -38
  760. package/dist/plain/calculate/maxTime.d.ts +1 -1
  761. package/dist/plain/calculate/maxTime.js +33 -38
  762. package/dist/plain/calculate/minDate.d.ts +1 -1
  763. package/dist/plain/calculate/minDate.js +33 -38
  764. package/dist/plain/calculate/minDateTime.d.ts +1 -1
  765. package/dist/plain/calculate/minDateTime.js +33 -38
  766. package/dist/plain/calculate/minTime.d.ts +1 -1
  767. package/dist/plain/calculate/minTime.js +33 -38
  768. package/dist/plain/calculate/nextWeekday.d.ts +22 -20
  769. package/dist/plain/calculate/nextWeekday.js +49 -47
  770. package/dist/plain/calculate/previousWeekday.d.ts +22 -20
  771. package/dist/plain/calculate/previousWeekday.js +49 -47
  772. package/dist/plain/calculate/roundDate.d.ts +26 -25
  773. package/dist/plain/calculate/roundDate.js +83 -103
  774. package/dist/plain/calculate/roundDateTime.d.ts +28 -27
  775. package/dist/plain/calculate/roundDateTime.js +99 -127
  776. package/dist/plain/calculate/roundTime.d.ts +24 -24
  777. package/dist/plain/calculate/roundTime.js +49 -51
  778. package/dist/plain/calculate/setDate.d.ts +11 -10
  779. package/dist/plain/calculate/setDate.js +59 -64
  780. package/dist/plain/calculate/setDateTime.d.ts +12 -11
  781. package/dist/plain/calculate/setDateTime.js +53 -58
  782. package/dist/plain/calculate/setTime.d.ts +11 -10
  783. package/dist/plain/calculate/setTime.js +55 -60
  784. package/dist/plain/calculate/sortDateTimes.d.ts +1 -1
  785. package/dist/plain/calculate/sortDateTimes.js +34 -38
  786. package/dist/plain/calculate/sortDates.d.ts +1 -1
  787. package/dist/plain/calculate/sortDates.js +34 -38
  788. package/dist/plain/calculate/sortTimes.d.ts +1 -1
  789. package/dist/plain/calculate/sortTimes.js +34 -38
  790. package/dist/plain/calculate/startOfDate.d.ts +10 -10
  791. package/dist/plain/calculate/startOfDate.js +65 -70
  792. package/dist/plain/calculate/startOfDateTime.d.ts +20 -19
  793. package/dist/plain/calculate/startOfDateTime.js +97 -99
  794. package/dist/plain/calculate/startOfQuarterForDate.d.ts +1 -1
  795. package/dist/plain/calculate/startOfQuarterForDate.js +34 -30
  796. package/dist/plain/calculate/startOfQuarterForDateTime.d.ts +1 -1
  797. package/dist/plain/calculate/startOfQuarterForDateTime.js +40 -41
  798. package/dist/plain/calculate/startOfTime.d.ts +12 -11
  799. package/dist/plain/calculate/startOfTime.js +54 -60
  800. package/dist/plain/calculate/startOfYearMonth.d.ts +17 -0
  801. package/dist/plain/calculate/startOfYearMonth.js +30 -0
  802. package/dist/plain/calculate/subtractBusinessDays.d.ts +5 -4
  803. package/dist/plain/calculate/subtractBusinessDays.js +40 -39
  804. package/dist/plain/calculate/subtractDate.d.ts +11 -9
  805. package/dist/plain/calculate/subtractDate.js +51 -52
  806. package/dist/plain/calculate/subtractDateTime.d.ts +11 -9
  807. package/dist/plain/calculate/subtractDateTime.js +37 -43
  808. package/dist/plain/calculate/subtractTime.d.ts +3 -2
  809. package/dist/plain/calculate/subtractTime.js +37 -40
  810. package/dist/plain/calculate/subtractYearMonth.d.ts +35 -0
  811. package/dist/plain/calculate/subtractYearMonth.js +29 -0
  812. package/dist/plain/calculate/weekOfYearForDate.d.ts +1 -1
  813. package/dist/plain/calculate/weekOfYearForDate.js +27 -26
  814. package/dist/plain/calculate/weekOfYearForDateTime.d.ts +1 -1
  815. package/dist/plain/calculate/weekOfYearForDateTime.js +30 -29
  816. package/dist/plain/chop/chopDate.d.ts +1 -1
  817. package/dist/plain/chop/chopDate.js +24 -22
  818. package/dist/plain/chop/chopMilliseconds.d.ts +1 -1
  819. package/dist/plain/chop/chopMilliseconds.js +28 -32
  820. package/dist/plain/chop/chopSeconds.d.ts +1 -1
  821. package/dist/plain/chop/chopSeconds.js +28 -32
  822. package/dist/plain/chop/chopTime.d.ts +1 -1
  823. package/dist/plain/chop/chopTime.js +24 -22
  824. package/dist/plain/chop/index.d.ts +5 -4
  825. package/dist/plain/chop/index.js +6 -4
  826. package/dist/plain/compare/areDateTimesEqual.d.ts +1 -1
  827. package/dist/plain/compare/areDateTimesEqual.js +28 -35
  828. package/dist/plain/compare/areDateTimesEqualBy.d.ts +11 -13
  829. package/dist/plain/compare/areDateTimesEqualBy.js +61 -70
  830. package/dist/plain/compare/areDatesEqual.d.ts +1 -1
  831. package/dist/plain/compare/areDatesEqual.js +30 -31
  832. package/dist/plain/compare/areDatesEqualBy.d.ts +14 -14
  833. package/dist/plain/compare/areDatesEqualBy.js +67 -77
  834. package/dist/plain/compare/areMonthDaysEqual.d.ts +16 -0
  835. package/dist/plain/compare/areMonthDaysEqual.js +30 -0
  836. package/dist/plain/compare/areTimesEqual.d.ts +1 -1
  837. package/dist/plain/compare/areTimesEqual.js +31 -35
  838. package/dist/plain/compare/areYearMonthsEqual.d.ts +15 -0
  839. package/dist/plain/compare/areYearMonthsEqual.js +29 -0
  840. package/dist/plain/compare/compareMonthDays.d.ts +20 -0
  841. package/dist/plain/compare/compareMonthDays.js +36 -0
  842. package/dist/plain/compare/compareYearMonths.d.ts +18 -0
  843. package/dist/plain/compare/compareYearMonths.js +33 -0
  844. package/dist/plain/compare/index.d.ts +25 -20
  845. package/dist/plain/compare/index.js +26 -20
  846. package/dist/plain/compare/isAfterDate.d.ts +1 -1
  847. package/dist/plain/compare/isAfterDate.js +27 -26
  848. package/dist/plain/compare/isAfterDateTime.d.ts +1 -1
  849. package/dist/plain/compare/isAfterDateTime.js +28 -27
  850. package/dist/plain/compare/isAfterTime.d.ts +1 -1
  851. package/dist/plain/compare/isAfterTime.js +28 -27
  852. package/dist/plain/compare/isBeforeDate.d.ts +1 -1
  853. package/dist/plain/compare/isBeforeDate.js +28 -27
  854. package/dist/plain/compare/isBeforeDateTime.d.ts +1 -1
  855. package/dist/plain/compare/isBeforeDateTime.js +28 -27
  856. package/dist/plain/compare/isBeforeTime.d.ts +1 -1
  857. package/dist/plain/compare/isBeforeTime.js +28 -27
  858. package/dist/plain/compare/isBetweenDate.d.ts +15 -15
  859. package/dist/plain/compare/isBetweenDate.js +46 -61
  860. package/dist/plain/compare/isBetweenDateTime.d.ts +15 -15
  861. package/dist/plain/compare/isBetweenDateTime.js +46 -63
  862. package/dist/plain/compare/isBetweenTime.d.ts +15 -15
  863. package/dist/plain/compare/isBetweenTime.js +48 -63
  864. package/dist/plain/compare/isBusinessDay.d.ts +5 -4
  865. package/dist/plain/compare/isBusinessDay.js +51 -52
  866. package/dist/plain/compare/isFuture.d.ts +1 -1
  867. package/dist/plain/compare/isFuture.js +30 -30
  868. package/dist/plain/compare/isPast.d.ts +1 -1
  869. package/dist/plain/compare/isPast.js +30 -30
  870. package/dist/plain/compare/isRelativeDay.d.ts +2 -2
  871. package/dist/plain/compare/isRelativeDay.js +43 -45
  872. package/dist/plain/compare/isThisUnit.d.ts +9 -7
  873. package/dist/plain/compare/isThisUnit.js +65 -67
  874. package/dist/plain/compare/isWeekend.d.ts +6 -6
  875. package/dist/plain/compare/isWeekend.js +40 -39
  876. package/dist/plain/convert/convertDateToCalendar.d.ts +3 -2
  877. package/dist/plain/convert/convertDateToCalendar.js +59 -58
  878. package/dist/plain/convert/index.d.ts +3 -1
  879. package/dist/plain/convert/index.js +4 -1
  880. package/dist/plain/convert/monthDayToDate.d.ts +23 -0
  881. package/dist/plain/convert/monthDayToDate.js +37 -0
  882. package/dist/plain/format/formatCalendar.d.ts +15 -16
  883. package/dist/plain/format/formatCalendar.js +73 -94
  884. package/dist/plain/format/formatDate.d.ts +7 -6
  885. package/dist/plain/format/formatDate.js +53 -61
  886. package/dist/plain/format/formatDateRange.d.ts +7 -6
  887. package/dist/plain/format/formatDateRange.js +50 -55
  888. package/dist/plain/format/formatDateTime.d.ts +7 -6
  889. package/dist/plain/format/formatDateTime.js +51 -55
  890. package/dist/plain/format/formatDateTimeRange.d.ts +7 -6
  891. package/dist/plain/format/formatDateTimeRange.js +51 -55
  892. package/dist/plain/format/formatDateTimeToParts.d.ts +20 -19
  893. package/dist/plain/format/formatDateTimeToParts.js +71 -74
  894. package/dist/plain/format/formatDateToParts.d.ts +20 -19
  895. package/dist/plain/format/formatDateToParts.js +67 -72
  896. package/dist/plain/format/formatMonthDay.d.ts +40 -0
  897. package/dist/plain/format/formatMonthDay.js +74 -0
  898. package/dist/plain/format/formatRelativeDate.d.ts +17 -15
  899. package/dist/plain/format/formatRelativeDate.js +76 -77
  900. package/dist/plain/format/formatRelativeDateTime.d.ts +16 -14
  901. package/dist/plain/format/formatRelativeDateTime.js +51 -60
  902. package/dist/plain/format/formatRelativeTime.d.ts +17 -15
  903. package/dist/plain/format/formatRelativeTime.js +64 -66
  904. package/dist/plain/format/formatSqlDateTime.d.ts +4 -3
  905. package/dist/plain/format/formatSqlDateTime.js +39 -38
  906. package/dist/plain/format/formatTime.d.ts +7 -6
  907. package/dist/plain/format/formatTime.js +49 -56
  908. package/dist/plain/format/formatYearMonth.d.ts +42 -0
  909. package/dist/plain/format/formatYearMonth.js +75 -0
  910. package/dist/plain/format/index.d.ts +15 -12
  911. package/dist/plain/format/index.js +16 -12
  912. package/dist/plain/get/getDateAgo.d.ts +29 -0
  913. package/dist/plain/get/getDateAgo.js +48 -0
  914. package/dist/plain/get/getDateIn.d.ts +29 -0
  915. package/dist/plain/get/getDateIn.js +47 -0
  916. package/dist/plain/get/getDateTimeAgo.d.ts +28 -0
  917. package/dist/plain/get/getDateTimeAgo.js +47 -0
  918. package/dist/plain/get/getDateTimeIn.d.ts +28 -0
  919. package/dist/plain/get/getDateTimeIn.js +47 -0
  920. package/dist/plain/get/getDay.d.ts +2 -2
  921. package/dist/plain/get/getDay.js +24 -24
  922. package/dist/plain/get/getDayOfWeek.d.ts +2 -2
  923. package/dist/plain/get/getDayOfWeek.js +24 -23
  924. package/dist/plain/get/getHour.d.ts +2 -2
  925. package/dist/plain/get/getHour.js +24 -24
  926. package/dist/plain/get/getMicrosecond.d.ts +2 -2
  927. package/dist/plain/get/getMicrosecond.js +24 -24
  928. package/dist/plain/get/getMillisecond.d.ts +2 -2
  929. package/dist/plain/get/getMillisecond.js +24 -24
  930. package/dist/plain/get/getMinute.d.ts +2 -2
  931. package/dist/plain/get/getMinute.js +24 -24
  932. package/dist/plain/get/getMonth.d.ts +2 -2
  933. package/dist/plain/get/getMonth.js +24 -24
  934. package/dist/plain/get/getNanosecond.d.ts +2 -2
  935. package/dist/plain/get/getNanosecond.js +24 -24
  936. package/dist/plain/get/getNow.d.ts +2 -2
  937. package/dist/plain/get/getNow.js +22 -21
  938. package/dist/plain/get/getNowUnit.d.ts +4 -3
  939. package/dist/plain/get/getNowUnit.js +52 -53
  940. package/dist/plain/get/getSecond.d.ts +2 -2
  941. package/dist/plain/get/getSecond.js +24 -24
  942. package/dist/plain/get/getTimeAgo.d.ts +27 -0
  943. package/dist/plain/get/getTimeAgo.js +46 -0
  944. package/dist/plain/get/getTimeIn.d.ts +27 -0
  945. package/dist/plain/get/getTimeIn.js +46 -0
  946. package/dist/plain/get/getToday.d.ts +2 -2
  947. package/dist/plain/get/getToday.js +22 -21
  948. package/dist/plain/get/getWeekOfYear.d.ts +2 -2
  949. package/dist/plain/get/getWeekOfYear.js +30 -29
  950. package/dist/plain/get/getYear.d.ts +2 -2
  951. package/dist/plain/get/getYear.js +27 -25
  952. package/dist/plain/get/index.d.ts +22 -14
  953. package/dist/plain/get/index.js +22 -14
  954. package/dist/plain/index.d.ts +264 -12
  955. package/dist/plain/index.js +256 -13
  956. package/dist/plain/interval/index.d.ts +54 -51
  957. package/dist/plain/interval/index.js +55 -51
  958. package/dist/plain/interval/intervalAbutsDate.d.ts +2 -3
  959. package/dist/plain/interval/intervalAbutsDate.js +56 -62
  960. package/dist/plain/interval/intervalAbutsDateTime.d.ts +1 -1
  961. package/dist/plain/interval/intervalAbutsDateTime.js +49 -55
  962. package/dist/plain/interval/intervalAbutsTime.d.ts +1 -1
  963. package/dist/plain/interval/intervalAbutsTime.js +53 -59
  964. package/dist/plain/interval/intervalContainsDate.d.ts +2 -2
  965. package/dist/plain/interval/intervalContainsDate.js +63 -66
  966. package/dist/plain/interval/intervalContainsDateTime.d.ts +1 -1
  967. package/dist/plain/interval/intervalContainsDateTime.js +58 -62
  968. package/dist/plain/interval/intervalContainsTime.d.ts +1 -1
  969. package/dist/plain/interval/intervalContainsTime.js +63 -67
  970. package/dist/plain/interval/intervalCountDate.d.ts +1 -1
  971. package/dist/plain/interval/intervalCountDate.js +70 -89
  972. package/dist/plain/interval/intervalCountDateTime.d.ts +1 -1
  973. package/dist/plain/interval/intervalCountDateTime.js +86 -107
  974. package/dist/plain/interval/intervalCountTime.d.ts +1 -1
  975. package/dist/plain/interval/intervalCountTime.js +56 -65
  976. package/dist/plain/interval/intervalDifferenceDate.d.ts +13 -13
  977. package/dist/plain/interval/intervalDifferenceDate.js +72 -72
  978. package/dist/plain/interval/intervalDifferenceDateTime.d.ts +12 -12
  979. package/dist/plain/interval/intervalDifferenceDateTime.js +55 -61
  980. package/dist/plain/interval/intervalDifferenceTime.d.ts +12 -12
  981. package/dist/plain/interval/intervalDifferenceTime.js +57 -63
  982. package/dist/plain/interval/intervalDivideEquallyDate.d.ts +23 -23
  983. package/dist/plain/interval/intervalDivideEquallyDate.js +76 -89
  984. package/dist/plain/interval/intervalDivideEquallyDateTime.d.ts +20 -20
  985. package/dist/plain/interval/intervalDivideEquallyDateTime.js +73 -92
  986. package/dist/plain/interval/intervalDivideEquallyTime.d.ts +20 -20
  987. package/dist/plain/interval/intervalDivideEquallyTime.js +67 -85
  988. package/dist/plain/interval/intervalEngulfsDate.d.ts +2 -2
  989. package/dist/plain/interval/intervalEngulfsDate.js +57 -62
  990. package/dist/plain/interval/intervalEngulfsDateTime.d.ts +1 -1
  991. package/dist/plain/interval/intervalEngulfsDateTime.js +52 -58
  992. package/dist/plain/interval/intervalEngulfsTime.d.ts +1 -1
  993. package/dist/plain/interval/intervalEngulfsTime.js +57 -63
  994. package/dist/plain/interval/intervalFromDurationDate.d.ts +21 -20
  995. package/dist/plain/interval/intervalFromDurationDate.js +64 -69
  996. package/dist/plain/interval/intervalFromDurationDateTime.d.ts +21 -20
  997. package/dist/plain/interval/intervalFromDurationDateTime.js +51 -57
  998. package/dist/plain/interval/intervalFromDurationTime.d.ts +12 -12
  999. package/dist/plain/interval/intervalFromDurationTime.js +61 -75
  1000. package/dist/plain/interval/intervalIntersectionDate.d.ts +13 -13
  1001. package/dist/plain/interval/intervalIntersectionDate.js +71 -73
  1002. package/dist/plain/interval/intervalIntersectionDateTime.d.ts +12 -12
  1003. package/dist/plain/interval/intervalIntersectionDateTime.js +56 -61
  1004. package/dist/plain/interval/intervalIntersectionTime.d.ts +12 -12
  1005. package/dist/plain/interval/intervalIntersectionTime.js +56 -61
  1006. package/dist/plain/interval/intervalLengthDate.d.ts +1 -1
  1007. package/dist/plain/interval/intervalLengthDate.js +71 -79
  1008. package/dist/plain/interval/intervalLengthDateTime.d.ts +1 -1
  1009. package/dist/plain/interval/intervalLengthDateTime.js +44 -48
  1010. package/dist/plain/interval/intervalLengthTime.d.ts +1 -1
  1011. package/dist/plain/interval/intervalLengthTime.js +41 -47
  1012. package/dist/plain/interval/intervalOverlappingDaysDate.d.ts +1 -1
  1013. package/dist/plain/interval/intervalOverlappingDaysDate.js +67 -76
  1014. package/dist/plain/interval/intervalOverlappingDaysDateTime.d.ts +1 -1
  1015. package/dist/plain/interval/intervalOverlappingDaysDateTime.js +52 -65
  1016. package/dist/plain/interval/intervalSplitAtDate.d.ts +13 -13
  1017. package/dist/plain/interval/intervalSplitAtDate.js +80 -85
  1018. package/dist/plain/interval/intervalSplitAtDateTime.d.ts +12 -12
  1019. package/dist/plain/interval/intervalSplitAtDateTime.js +65 -74
  1020. package/dist/plain/interval/intervalSplitAtTime.d.ts +12 -12
  1021. package/dist/plain/interval/intervalSplitAtTime.js +67 -76
  1022. package/dist/plain/interval/intervalUnionDate.d.ts +14 -14
  1023. package/dist/plain/interval/intervalUnionDate.js +75 -77
  1024. package/dist/plain/interval/intervalUnionDateTime.d.ts +12 -12
  1025. package/dist/plain/interval/intervalUnionDateTime.js +59 -64
  1026. package/dist/plain/interval/intervalUnionTime.d.ts +12 -12
  1027. package/dist/plain/interval/intervalUnionTime.js +59 -64
  1028. package/dist/plain/interval/intervalXorAllDate.d.ts +15 -15
  1029. package/dist/plain/interval/intervalXorAllDate.js +59 -64
  1030. package/dist/plain/interval/intervalXorAllDateTime.d.ts +14 -14
  1031. package/dist/plain/interval/intervalXorAllDateTime.js +49 -54
  1032. package/dist/plain/interval/intervalXorAllTime.d.ts +14 -14
  1033. package/dist/plain/interval/intervalXorAllTime.js +50 -55
  1034. package/dist/plain/interval/intervalXorDate.d.ts +13 -13
  1035. package/dist/plain/interval/intervalXorDate.js +66 -69
  1036. package/dist/plain/interval/intervalXorDateTime.d.ts +12 -12
  1037. package/dist/plain/interval/intervalXorDateTime.js +52 -61
  1038. package/dist/plain/interval/intervalXorTime.d.ts +12 -12
  1039. package/dist/plain/interval/intervalXorTime.js +52 -61
  1040. package/dist/plain/interval/intervalsOverlapDate.d.ts +2 -2
  1041. package/dist/plain/interval/intervalsOverlapDate.js +56 -61
  1042. package/dist/plain/interval/intervalsOverlapDateTime.d.ts +1 -1
  1043. package/dist/plain/interval/intervalsOverlapDateTime.js +50 -56
  1044. package/dist/plain/interval/intervalsOverlapTime.d.ts +1 -1
  1045. package/dist/plain/interval/intervalsOverlapTime.js +51 -57
  1046. package/dist/plain/interval/mergeIntervalsDate.d.ts +15 -15
  1047. package/dist/plain/interval/mergeIntervalsDate.js +58 -63
  1048. package/dist/plain/interval/mergeIntervalsDateTime.d.ts +14 -14
  1049. package/dist/plain/interval/mergeIntervalsDateTime.js +48 -54
  1050. package/dist/plain/interval/mergeIntervalsTime.d.ts +14 -14
  1051. package/dist/plain/interval/mergeIntervalsTime.js +48 -54
  1052. package/dist/plain/interval/splitIntervalByUnitDate.d.ts +22 -23
  1053. package/dist/plain/interval/splitIntervalByUnitDate.js +86 -110
  1054. package/dist/plain/interval/splitIntervalByUnitDateTime.d.ts +22 -21
  1055. package/dist/plain/interval/splitIntervalByUnitDateTime.js +77 -95
  1056. package/dist/plain/interval/splitIntervalByUnitTime.d.ts +20 -20
  1057. package/dist/plain/interval/splitIntervalByUnitTime.js +79 -104
  1058. package/dist/plain/interval/validate/index.d.ts +4 -3
  1059. package/dist/plain/interval/validate/index.js +5 -3
  1060. package/dist/plain/interval/validate/isValidDateInterval.d.ts +2 -2
  1061. package/dist/plain/interval/validate/isValidDateInterval.js +36 -37
  1062. package/dist/plain/interval/validate/isValidDateTimeInterval.d.ts +1 -1
  1063. package/dist/plain/interval/validate/isValidDateTimeInterval.js +35 -36
  1064. package/dist/plain/interval/validate/isValidTimeInterval.d.ts +1 -1
  1065. package/dist/plain/interval/validate/isValidTimeInterval.js +35 -36
  1066. package/dist/plain/locale/getLocaleEraNames.d.ts +8 -8
  1067. package/dist/plain/locale/getLocaleEraNames.js +69 -78
  1068. package/dist/plain/locale/getLocaleMeridiems.d.ts +6 -6
  1069. package/dist/plain/locale/getLocaleMeridiems.js +42 -47
  1070. package/dist/plain/locale/getLocaleMonthNames.d.ts +7 -7
  1071. package/dist/plain/locale/getLocaleMonthNames.js +57 -57
  1072. package/dist/plain/locale/getLocaleWeekdayNames.d.ts +5 -5
  1073. package/dist/plain/locale/getLocaleWeekdayNames.js +58 -62
  1074. package/dist/plain/locale/index.d.ts +5 -4
  1075. package/dist/plain/locale/index.js +6 -4
  1076. package/dist/plain/map/index.d.ts +3 -2
  1077. package/dist/plain/map/index.js +4 -2
  1078. package/dist/plain/map/mapDatesInRange.d.ts +9 -9
  1079. package/dist/plain/map/mapDatesInRange.js +57 -76
  1080. package/dist/plain/map/mapDaysInMonth.d.ts +1 -1
  1081. package/dist/plain/map/mapDaysInMonth.js +30 -29
  1082. package/dist/plain/parse/index.d.ts +38 -29
  1083. package/dist/plain/parse/index.js +39 -29
  1084. package/dist/plain/parse/parseDateTimeWithPattern.d.ts +23 -18
  1085. package/dist/plain/parse/parseDateTimeWithPattern.js +134 -138
  1086. package/dist/plain/parse/parseDateWithPattern.d.ts +27 -22
  1087. package/dist/plain/parse/parseDateWithPattern.js +114 -114
  1088. package/dist/plain/parse/parseDayFromDate.d.ts +1 -1
  1089. package/dist/plain/parse/parseDayFromDate.js +24 -23
  1090. package/dist/plain/parse/parseDayFromDateTime.d.ts +1 -1
  1091. package/dist/plain/parse/parseDayFromDateTime.js +25 -24
  1092. package/dist/plain/parse/parseDayOfWeekFromDate.d.ts +1 -1
  1093. package/dist/plain/parse/parseDayOfWeekFromDate.js +26 -26
  1094. package/dist/plain/parse/parseDayOfWeekFromDateTime.d.ts +1 -1
  1095. package/dist/plain/parse/parseDayOfWeekFromDateTime.js +25 -25
  1096. package/dist/plain/parse/parseHourFromDateTime.d.ts +1 -1
  1097. package/dist/plain/parse/parseHourFromDateTime.js +25 -24
  1098. package/dist/plain/parse/parseHourFromTime.d.ts +1 -1
  1099. package/dist/plain/parse/parseHourFromTime.js +24 -23
  1100. package/dist/plain/parse/parseMicrosecondFromDateTime.d.ts +1 -1
  1101. package/dist/plain/parse/parseMicrosecondFromDateTime.js +26 -25
  1102. package/dist/plain/parse/parseMicrosecondFromTime.d.ts +1 -1
  1103. package/dist/plain/parse/parseMicrosecondFromTime.js +23 -22
  1104. package/dist/plain/parse/parseMillisecondFromDateTime.d.ts +1 -1
  1105. package/dist/plain/parse/parseMillisecondFromDateTime.js +25 -24
  1106. package/dist/plain/parse/parseMillisecondFromTime.d.ts +1 -1
  1107. package/dist/plain/parse/parseMillisecondFromTime.js +25 -24
  1108. package/dist/plain/parse/parseMinuteFromDateTime.d.ts +1 -1
  1109. package/dist/plain/parse/parseMinuteFromDateTime.js +25 -24
  1110. package/dist/plain/parse/parseMinuteFromTime.d.ts +1 -1
  1111. package/dist/plain/parse/parseMinuteFromTime.js +25 -24
  1112. package/dist/plain/parse/parseMonthDay.d.ts +21 -0
  1113. package/dist/plain/parse/parseMonthDay.js +30 -0
  1114. package/dist/plain/parse/parseMonthDayFromDate.d.ts +16 -0
  1115. package/dist/plain/parse/parseMonthDayFromDate.js +30 -0
  1116. package/dist/plain/parse/parseMonthDayFromDateTime.d.ts +19 -0
  1117. package/dist/plain/parse/parseMonthDayFromDateTime.js +33 -0
  1118. package/dist/plain/parse/parseMonthDayWithPattern.d.ts +56 -0
  1119. package/dist/plain/parse/parseMonthDayWithPattern.js +77 -0
  1120. package/dist/plain/parse/parseMonthFromDate.d.ts +1 -1
  1121. package/dist/plain/parse/parseMonthFromDate.js +24 -23
  1122. package/dist/plain/parse/parseMonthFromDateTime.d.ts +1 -1
  1123. package/dist/plain/parse/parseMonthFromDateTime.js +24 -23
  1124. package/dist/plain/parse/parseNanosecondFromDateTime.d.ts +1 -1
  1125. package/dist/plain/parse/parseNanosecondFromDateTime.js +26 -25
  1126. package/dist/plain/parse/parseNanosecondFromTime.d.ts +1 -1
  1127. package/dist/plain/parse/parseNanosecondFromTime.js +26 -25
  1128. package/dist/plain/parse/parseSecondFromDateTime.d.ts +1 -1
  1129. package/dist/plain/parse/parseSecondFromDateTime.js +25 -24
  1130. package/dist/plain/parse/parseSecondFromTime.d.ts +1 -1
  1131. package/dist/plain/parse/parseSecondFromTime.js +25 -24
  1132. package/dist/plain/parse/parseSqlDateTime.d.ts +3 -3
  1133. package/dist/plain/parse/parseSqlDateTime.js +31 -37
  1134. package/dist/plain/parse/parseTimeWithPattern.d.ts +7 -5
  1135. package/dist/plain/parse/parseTimeWithPattern.js +86 -93
  1136. package/dist/plain/parse/parseUnitFromDate.d.ts +11 -11
  1137. package/dist/plain/parse/parseUnitFromDate.js +57 -68
  1138. package/dist/plain/parse/parseUnitFromDateTime.d.ts +11 -11
  1139. package/dist/plain/parse/parseUnitFromDateTime.js +63 -81
  1140. package/dist/plain/parse/parseUnitFromTime.d.ts +2 -2
  1141. package/dist/plain/parse/parseUnitFromTime.js +43 -49
  1142. package/dist/plain/parse/parseWeekFromDate.d.ts +10 -10
  1143. package/dist/plain/parse/parseWeekFromDate.js +36 -41
  1144. package/dist/plain/parse/parseWeekFromDateTime.d.ts +10 -10
  1145. package/dist/plain/parse/parseWeekFromDateTime.js +36 -42
  1146. package/dist/plain/parse/parseYearFromDate.d.ts +1 -1
  1147. package/dist/plain/parse/parseYearFromDate.js +28 -26
  1148. package/dist/plain/parse/parseYearFromDateTime.d.ts +1 -1
  1149. package/dist/plain/parse/parseYearFromDateTime.js +27 -25
  1150. package/dist/plain/parse/parseYearMonth.d.ts +25 -0
  1151. package/dist/plain/parse/parseYearMonth.js +34 -0
  1152. package/dist/plain/parse/parseYearMonthFromDate.d.ts +17 -0
  1153. package/dist/plain/parse/parseYearMonthFromDate.js +31 -0
  1154. package/dist/plain/parse/parseYearMonthFromDateTime.d.ts +18 -0
  1155. package/dist/plain/parse/parseYearMonthFromDateTime.js +32 -0
  1156. package/dist/plain/parse/parseYearMonthWithPattern.d.ts +44 -0
  1157. package/dist/plain/parse/parseYearMonthWithPattern.js +66 -0
  1158. package/dist/plain/validate/{isLeapSecond.d.ts → hasSecond60.d.ts} +16 -14
  1159. package/dist/plain/validate/hasSecond60.js +44 -0
  1160. package/dist/plain/validate/index.d.ts +23 -20
  1161. package/dist/plain/validate/index.js +24 -20
  1162. package/dist/plain/validate/isLeapYear.d.ts +1 -1
  1163. package/dist/plain/validate/isLeapYear.js +30 -29
  1164. package/dist/plain/validate/isValidCalendarDate.d.ts +6 -2
  1165. package/dist/plain/validate/isValidCalendarDate.js +13 -59
  1166. package/dist/plain/validate/isValidDate.d.ts +6 -1
  1167. package/dist/plain/validate/isValidDate.js +7 -41
  1168. package/dist/plain/validate/isValidDateCycleField.d.ts +3 -2
  1169. package/dist/plain/validate/isValidDateCycleField.js +24 -23
  1170. package/dist/plain/validate/isValidDateDurationUnit.d.ts +7 -4
  1171. package/dist/plain/validate/isValidDateDurationUnit.js +20 -15
  1172. package/dist/plain/validate/isValidDateRange.d.ts +21 -21
  1173. package/dist/plain/validate/isValidDateRange.js +38 -50
  1174. package/dist/plain/validate/isValidDateTime.d.ts +7 -2
  1175. package/dist/plain/validate/isValidDateTime.js +7 -39
  1176. package/dist/plain/validate/isValidDateTimeCycleField.d.ts +3 -2
  1177. package/dist/plain/validate/isValidDateTimeCycleField.js +19 -15
  1178. package/dist/plain/validate/isValidDateTimeDurationUnit.d.ts +7 -4
  1179. package/dist/plain/validate/isValidDateTimeDurationUnit.js +20 -24
  1180. package/dist/plain/validate/isValidDateTimeRange.d.ts +21 -21
  1181. package/dist/plain/validate/isValidDateTimeRange.js +39 -48
  1182. package/dist/plain/validate/isValidDateTimeUnit.d.ts +3 -2
  1183. package/dist/plain/validate/isValidDateTimeUnit.js +22 -30
  1184. package/dist/plain/validate/isValidDateUnit.d.ts +3 -2
  1185. package/dist/plain/validate/isValidDateUnit.js +24 -23
  1186. package/dist/plain/validate/isValidIsoDateLike.d.ts +6 -1
  1187. package/dist/plain/validate/isValidIsoDateLike.js +23 -46
  1188. package/dist/plain/validate/isValidMonthDay.d.ts +32 -0
  1189. package/dist/plain/validate/isValidMonthDay.js +8 -0
  1190. package/dist/plain/validate/isValidSqlDateTime.d.ts +9 -5
  1191. package/dist/plain/validate/isValidSqlDateTime.js +7 -35
  1192. package/dist/plain/validate/isValidTime.d.ts +6 -1
  1193. package/dist/plain/validate/isValidTime.js +7 -39
  1194. package/dist/plain/validate/isValidTimeCycleField.d.ts +3 -2
  1195. package/dist/plain/validate/isValidTimeCycleField.js +21 -25
  1196. package/dist/plain/validate/isValidTimeDurationUnit.d.ts +7 -4
  1197. package/dist/plain/validate/isValidTimeDurationUnit.js +20 -20
  1198. package/dist/plain/validate/isValidTimeRange.d.ts +21 -21
  1199. package/dist/plain/validate/isValidTimeRange.js +40 -49
  1200. package/dist/plain/validate/isValidTimeUnit.d.ts +3 -2
  1201. package/dist/plain/validate/isValidTimeUnit.js +22 -26
  1202. package/dist/plain/validate/isValidYearMonth.d.ts +34 -0
  1203. package/dist/plain/validate/isValidYearMonth.js +8 -0
  1204. package/dist/precision/calculate/index.d.ts +2 -1
  1205. package/dist/precision/calculate/index.js +3 -1
  1206. package/dist/precision/calculate/truncateNanoseconds.d.ts +1 -1
  1207. package/dist/precision/calculate/truncateNanoseconds.js +36 -37
  1208. package/dist/precision/convert/fromArrowLocalTimestamp.d.ts +29 -0
  1209. package/dist/precision/convert/fromArrowLocalTimestamp.js +35 -0
  1210. package/dist/precision/convert/fromArrowTimestamp.d.ts +31 -0
  1211. package/dist/precision/convert/fromArrowTimestamp.js +34 -0
  1212. package/dist/precision/convert/fromDotNetTicks.d.ts +1 -1
  1213. package/dist/precision/convert/fromDotNetTicks.js +36 -36
  1214. package/dist/precision/convert/fromExcelSerial.d.ts +11 -11
  1215. package/dist/precision/convert/fromExcelSerial.js +55 -76
  1216. package/dist/precision/convert/fromFileTime.d.ts +1 -1
  1217. package/dist/precision/convert/fromFileTime.js +36 -36
  1218. package/dist/precision/convert/fromNanoseconds.d.ts +3 -3
  1219. package/dist/precision/convert/fromNanoseconds.js +49 -54
  1220. package/dist/precision/convert/fromNtpTimestamp.d.ts +1 -1
  1221. package/dist/precision/convert/fromNtpTimestamp.js +54 -54
  1222. package/dist/precision/convert/fromParquetInt96.d.ts +34 -0
  1223. package/dist/precision/convert/fromParquetInt96.js +55 -0
  1224. package/dist/precision/convert/fromPgMicroseconds.d.ts +1 -1
  1225. package/dist/precision/convert/fromPgMicroseconds.js +32 -30
  1226. package/dist/precision/convert/fromProtoDuration.d.ts +31 -0
  1227. package/dist/precision/convert/fromProtoDuration.js +47 -0
  1228. package/dist/precision/convert/fromProtoTimestamp.d.ts +30 -0
  1229. package/dist/precision/convert/fromProtoTimestamp.js +39 -0
  1230. package/dist/precision/convert/index.d.ts +23 -12
  1231. package/dist/precision/convert/index.js +24 -12
  1232. package/dist/precision/convert/toArrowLocalTimestamp.d.ts +36 -0
  1233. package/dist/precision/convert/toArrowLocalTimestamp.js +42 -0
  1234. package/dist/precision/convert/toArrowTimestamp.d.ts +32 -0
  1235. package/dist/precision/convert/toArrowTimestamp.js +39 -0
  1236. package/dist/precision/convert/toDotNetTicks.d.ts +1 -1
  1237. package/dist/precision/convert/toDotNetTicks.js +40 -38
  1238. package/dist/precision/convert/toExcelSerial.d.ts +10 -10
  1239. package/dist/precision/convert/toExcelSerial.js +61 -80
  1240. package/dist/precision/convert/toFileTime.d.ts +1 -1
  1241. package/dist/precision/convert/toFileTime.js +42 -41
  1242. package/dist/precision/convert/toNanoseconds.d.ts +3 -3
  1243. package/dist/precision/convert/toNanoseconds.js +47 -43
  1244. package/dist/precision/convert/toNtpTimestamp.d.ts +1 -1
  1245. package/dist/precision/convert/toNtpTimestamp.js +39 -36
  1246. package/dist/precision/convert/toParquetInt96.d.ts +42 -0
  1247. package/dist/precision/convert/toParquetInt96.js +44 -0
  1248. package/dist/precision/convert/toPgMicroseconds.d.ts +1 -1
  1249. package/dist/precision/convert/toPgMicroseconds.js +40 -40
  1250. package/dist/precision/convert/toProtoDuration.d.ts +41 -0
  1251. package/dist/precision/convert/toProtoDuration.js +42 -0
  1252. package/dist/precision/convert/toProtoTimestamp.d.ts +41 -0
  1253. package/dist/precision/convert/toProtoTimestamp.js +42 -0
  1254. package/dist/precision/format/formatNanoseconds.d.ts +1 -1
  1255. package/dist/precision/format/formatNanoseconds.js +32 -30
  1256. package/dist/precision/format/index.d.ts +2 -1
  1257. package/dist/precision/format/index.js +3 -1
  1258. package/dist/precision/identifiers/fromKsuid.d.ts +28 -0
  1259. package/dist/precision/identifiers/fromKsuid.js +41 -0
  1260. package/dist/precision/identifiers/fromObjectId.d.ts +32 -0
  1261. package/dist/precision/identifiers/fromObjectId.js +43 -0
  1262. package/dist/precision/identifiers/fromSnowflake.d.ts +44 -0
  1263. package/dist/precision/identifiers/fromSnowflake.js +48 -0
  1264. package/dist/precision/identifiers/fromUlid.d.ts +33 -0
  1265. package/dist/precision/identifiers/fromUlid.js +44 -0
  1266. package/dist/precision/identifiers/fromUuidTimestamp.d.ts +34 -0
  1267. package/dist/precision/identifiers/fromUuidTimestamp.js +50 -0
  1268. package/dist/precision/identifiers/index.d.ts +8 -0
  1269. package/dist/precision/identifiers/index.js +9 -0
  1270. package/dist/precision/identifiers/ulidTimestampPrefix.d.ts +36 -0
  1271. package/dist/precision/identifiers/ulidTimestampPrefix.js +45 -0
  1272. package/dist/precision/identifiers/uuidV7TimestampPrefix.d.ts +34 -0
  1273. package/dist/precision/identifiers/uuidV7TimestampPrefix.js +44 -0
  1274. package/dist/precision/index.d.ts +39 -6
  1275. package/dist/precision/index.js +40 -7
  1276. package/dist/precision/parse/index.d.ts +2 -1
  1277. package/dist/precision/parse/index.js +3 -1
  1278. package/dist/precision/parse/parseNanoseconds.d.ts +1 -1
  1279. package/dist/precision/parse/parseNanoseconds.js +31 -29
  1280. package/dist/precision/validate/index.d.ts +6 -3
  1281. package/dist/precision/validate/index.js +7 -3
  1282. package/dist/precision/validate/isValidInstant.d.ts +8 -3
  1283. package/dist/precision/validate/isValidInstant.js +7 -48
  1284. package/dist/precision/validate/isValidInt64NanosecondDateTime.d.ts +29 -0
  1285. package/dist/precision/validate/isValidInt64NanosecondDateTime.js +8 -0
  1286. package/dist/precision/validate/isValidInt64NanosecondInstant.d.ts +29 -0
  1287. package/dist/precision/validate/isValidInt64NanosecondInstant.js +9 -0
  1288. package/dist/precision/validate/isValidNanoPattern.d.ts +6 -2
  1289. package/dist/precision/validate/isValidNanoPattern.js +9 -38
  1290. package/dist/precision/validate/isValidNanoseconds.d.ts +1 -1
  1291. package/dist/precision/validate/isValidNanoseconds.js +30 -26
  1292. package/dist/recurrence/calculate/cronRuns.d.ts +61 -0
  1293. package/dist/recurrence/calculate/cronRuns.js +261 -0
  1294. package/dist/recurrence/calculate/expandRecurrence.d.ts +64 -0
  1295. package/dist/recurrence/calculate/expandRecurrence.js +391 -0
  1296. package/dist/recurrence/calculate/index.d.ts +3 -0
  1297. package/dist/recurrence/calculate/index.js +4 -0
  1298. package/dist/recurrence/index.d.ts +8 -0
  1299. package/dist/recurrence/index.js +7 -0
  1300. package/dist/recurrence/parse/index.d.ts +3 -0
  1301. package/dist/recurrence/parse/index.js +4 -0
  1302. package/dist/recurrence/parse/parseCronExpression.d.ts +31 -0
  1303. package/dist/recurrence/parse/parseCronExpression.js +41 -0
  1304. package/dist/recurrence/parse/parseRecurrenceRule.d.ts +34 -0
  1305. package/dist/recurrence/parse/parseRecurrenceRule.js +43 -0
  1306. package/dist/regex/calendar-date.d.ts +1 -1
  1307. package/dist/regex/calendar-date.js +33 -30
  1308. package/dist/regex/calendar-zoned-date-time.d.ts +5 -5
  1309. package/dist/regex/calendar-zoned-date-time.js +32 -29
  1310. package/dist/regex/date-time.d.ts +1 -1
  1311. package/dist/regex/date-time.js +31 -28
  1312. package/dist/regex/date.d.ts +1 -1
  1313. package/dist/regex/date.js +61 -58
  1314. package/dist/regex/epcis.d.ts +1 -1
  1315. package/dist/regex/epcis.js +61 -58
  1316. package/dist/regex/http-date.d.ts +1 -1
  1317. package/dist/regex/http-date.js +24 -21
  1318. package/dist/regex/index.d.ts +21 -17
  1319. package/dist/regex/index.js +22 -18
  1320. package/dist/regex/leap-second.d.ts +2 -2
  1321. package/dist/regex/leap-second.js +47 -44
  1322. package/dist/regex/month-day.d.ts +22 -0
  1323. package/dist/regex/month-day.js +25 -0
  1324. package/dist/regex/nanoseconds.d.ts +1 -1
  1325. package/dist/regex/nanoseconds.js +22 -19
  1326. package/dist/regex/rfc-2822.d.ts +1 -1
  1327. package/dist/regex/rfc-2822.js +31 -28
  1328. package/dist/regex/rfc-3339.d.ts +1 -1
  1329. package/dist/regex/rfc-3339.js +31 -28
  1330. package/dist/regex/sql-date-time.d.ts +4 -3
  1331. package/dist/regex/sql-date-time.js +38 -34
  1332. package/dist/regex/sql-offset-date-time.d.ts +52 -0
  1333. package/dist/regex/sql-offset-date-time.js +55 -0
  1334. package/dist/regex/time-zone-like.d.ts +3 -3
  1335. package/dist/regex/time-zone-like.js +34 -31
  1336. package/dist/regex/time.d.ts +1 -1
  1337. package/dist/regex/time.js +76 -73
  1338. package/dist/regex/unix.d.ts +1 -1
  1339. package/dist/regex/unix.js +32 -29
  1340. package/dist/regex/utc-date-time.d.ts +1 -1
  1341. package/dist/regex/utc-date-time.js +33 -30
  1342. package/dist/regex/utc-offset.d.ts +1 -1
  1343. package/dist/regex/utc-offset.js +27 -24
  1344. package/dist/regex/year-month.d.ts +22 -0
  1345. package/dist/regex/year-month.js +25 -0
  1346. package/dist/span/calculate/index.d.ts +5 -3
  1347. package/dist/span/calculate/index.js +6 -3
  1348. package/dist/span/calculate/spanMs.d.ts +5 -4
  1349. package/dist/span/calculate/spanMs.js +75 -79
  1350. package/dist/span/calculate/spanNs.d.ts +5 -4
  1351. package/dist/span/calculate/spanNs.js +58 -55
  1352. package/dist/span/calculate/spanSeconds.d.ts +32 -0
  1353. package/dist/span/calculate/spanSeconds.js +45 -0
  1354. package/dist/span/calculate/spanWallClock.d.ts +13 -13
  1355. package/dist/span/calculate/spanWallClock.js +69 -76
  1356. package/dist/span/index.d.ts +7 -3
  1357. package/dist/span/index.js +8 -4
  1358. package/dist/span/validate/index.d.ts +2 -1
  1359. package/dist/span/validate/index.js +3 -1
  1360. package/dist/span/validate/isValidSpan.d.ts +4 -4
  1361. package/dist/span/validate/isValidSpan.js +47 -44
  1362. package/dist/timescale/calculate/index.d.ts +4 -0
  1363. package/dist/timescale/calculate/index.js +5 -0
  1364. package/dist/timescale/calculate/leapSecondsBetween.d.ts +26 -0
  1365. package/dist/timescale/calculate/leapSecondsBetween.js +57 -0
  1366. package/dist/timescale/calculate/nextLeapSecond.d.ts +18 -0
  1367. package/dist/timescale/calculate/nextLeapSecond.js +33 -0
  1368. package/dist/timescale/calculate/taiMinusUtc.d.ts +21 -0
  1369. package/dist/timescale/calculate/taiMinusUtc.js +38 -0
  1370. package/dist/timescale/convert/fromTAI.d.ts +22 -0
  1371. package/dist/timescale/convert/fromTAI.js +38 -0
  1372. package/dist/timescale/convert/index.d.ts +3 -0
  1373. package/dist/timescale/convert/index.js +4 -0
  1374. package/dist/timescale/convert/toTAI.d.ts +23 -0
  1375. package/dist/timescale/convert/toTAI.js +43 -0
  1376. package/dist/timescale/index.d.ts +8 -0
  1377. package/dist/timescale/index.js +9 -0
  1378. package/dist/timescale/validate/index.d.ts +2 -0
  1379. package/dist/timescale/validate/index.js +3 -0
  1380. package/dist/timescale/validate/isLeapSecond.d.ts +25 -0
  1381. package/dist/timescale/validate/isLeapSecond.js +38 -0
  1382. package/dist/transport/calculate/bestAvailable.d.ts +7 -6
  1383. package/dist/transport/calculate/bestAvailable.js +75 -73
  1384. package/dist/transport/calculate/crossingTime.d.ts +12 -12
  1385. package/dist/transport/calculate/crossingTime.js +70 -78
  1386. package/dist/transport/calculate/cutoffAt.d.ts +33 -31
  1387. package/dist/transport/calculate/cutoffAt.js +88 -208
  1388. package/dist/transport/calculate/cutoffSchedule.d.ts +35 -35
  1389. package/dist/transport/calculate/cutoffSchedule.js +95 -70
  1390. package/dist/transport/calculate/dwellTime.d.ts +18 -18
  1391. package/dist/transport/calculate/dwellTime.js +111 -128
  1392. package/dist/transport/calculate/estimateDrift.d.ts +25 -24
  1393. package/dist/transport/calculate/estimateDrift.js +67 -73
  1394. package/dist/transport/calculate/index.d.ts +11 -10
  1395. package/dist/transport/calculate/index.js +12 -10
  1396. package/dist/transport/calculate/nextDeparture.d.ts +18 -18
  1397. package/dist/transport/calculate/nextDeparture.js +97 -119
  1398. package/dist/transport/calculate/punctualityRate.d.ts +13 -12
  1399. package/dist/transport/calculate/punctualityRate.js +52 -57
  1400. package/dist/transport/calculate/scheduleDelivery.d.ts +70 -70
  1401. package/dist/transport/calculate/scheduleDelivery.js +237 -275
  1402. package/dist/transport/calculate/transitTime.d.ts +12 -12
  1403. package/dist/transport/calculate/transitTime.js +87 -96
  1404. package/dist/transport/compare/classifyPunctuality.d.ts +4 -3
  1405. package/dist/transport/compare/classifyPunctuality.js +60 -62
  1406. package/dist/transport/compare/index.d.ts +5 -4
  1407. package/dist/transport/compare/index.js +6 -4
  1408. package/dist/transport/compare/isPastCutoff.d.ts +2 -2
  1409. package/dist/transport/compare/isPastCutoff.js +44 -45
  1410. package/dist/transport/compare/scheduleDeviation.d.ts +2 -2
  1411. package/dist/transport/compare/scheduleDeviation.js +47 -50
  1412. package/dist/transport/compare/timeToCutoff.d.ts +2 -2
  1413. package/dist/transport/compare/timeToCutoff.js +41 -44
  1414. package/dist/transport/convert/etaAtZone.d.ts +4 -4
  1415. package/dist/transport/convert/etaAtZone.js +59 -60
  1416. package/dist/transport/convert/index.d.ts +2 -1
  1417. package/dist/transport/convert/index.js +3 -1
  1418. package/dist/transport/index.d.ts +19 -4
  1419. package/dist/transport/index.js +18 -5
  1420. package/dist/types/business-calendar.d.ts +21 -21
  1421. package/dist/types/calendar-options.d.ts +17 -17
  1422. package/dist/types/calendar-system.d.ts +1 -1
  1423. package/dist/types/cron.d.ts +45 -0
  1424. package/dist/types/cron.js +0 -0
  1425. package/dist/types/date-cycle-field.d.ts +1 -1
  1426. package/dist/types/date-duration-unit.d.ts +2 -2
  1427. package/dist/types/date-time-cycle-field.d.ts +3 -3
  1428. package/dist/types/date-time-duration-units.d.ts +2 -2
  1429. package/dist/types/date-time-unit.d.ts +2 -2
  1430. package/dist/types/date-unit.d.ts +2 -2
  1431. package/dist/types/datetime-format-options.d.ts +1 -1
  1432. package/dist/types/disambiguation.d.ts +2 -2
  1433. package/dist/types/duration-relative-to.d.ts +5 -2
  1434. package/dist/types/duration-string-options.d.ts +25 -25
  1435. package/dist/types/duty.d.ts +522 -522
  1436. package/dist/types/edi.d.ts +75 -75
  1437. package/dist/types/epcis.d.ts +15 -15
  1438. package/dist/types/exact-duration-unit.d.ts +2 -2
  1439. package/dist/types/fiscal-calendar.d.ts +47 -11
  1440. package/dist/types/fractional-digit.d.ts +1 -1
  1441. package/dist/types/free-time-options.d.ts +28 -28
  1442. package/dist/types/gnss.d.ts +51 -0
  1443. package/dist/types/gnss.js +0 -0
  1444. package/dist/types/holiday-rule.d.ts +123 -0
  1445. package/dist/types/holiday-rule.js +0 -0
  1446. package/dist/types/index.d.ts +49 -42
  1447. package/dist/types/index.js +0 -41
  1448. package/dist/types/interval.d.ts +8 -8
  1449. package/dist/types/now-unit.d.ts +3 -1
  1450. package/dist/types/observance-policy.d.ts +19 -0
  1451. package/dist/types/observance-policy.js +0 -0
  1452. package/dist/types/offset.d.ts +2 -2
  1453. package/dist/types/operating-schedule.d.ts +47 -47
  1454. package/dist/types/overflow.d.ts +2 -2
  1455. package/dist/types/recurrence.d.ts +131 -0
  1456. package/dist/types/recurrence.js +0 -0
  1457. package/dist/types/relative-date-time-unit.d.ts +1 -1
  1458. package/dist/types/relative-date-unit.d.ts +1 -1
  1459. package/dist/types/relative-rounding-method.d.ts +1 -1
  1460. package/dist/types/relative-time-options.d.ts +40 -40
  1461. package/dist/types/relative-time-unit.d.ts +1 -1
  1462. package/dist/types/relative-unit.d.ts +1 -1
  1463. package/dist/types/roll-convention.d.ts +1 -1
  1464. package/dist/types/rounding-options.d.ts +27 -27
  1465. package/dist/types/stored-zoned-classification.d.ts +83 -0
  1466. package/dist/types/stored-zoned-classification.js +0 -0
  1467. package/dist/types/time-cycle-field.d.ts +1 -1
  1468. package/dist/types/time-duration-unit.d.ts +2 -2
  1469. package/dist/types/time-unit.d.ts +2 -2
  1470. package/dist/types/transport-timestamps.d.ts +25 -25
  1471. package/dist/types/two-digit-year.d.ts +15 -15
  1472. package/dist/types/unix-now-unit.d.ts +2 -1
  1473. package/dist/types/utc-now-unit.d.ts +3 -1
  1474. package/dist/types/zone-bucket-unit.d.ts +1 -1
  1475. package/dist/unix/calculate/addUnix.d.ts +28 -26
  1476. package/dist/unix/calculate/addUnix.js +56 -60
  1477. package/dist/unix/calculate/diffUnix.d.ts +22 -20
  1478. package/dist/unix/calculate/diffUnix.js +96 -109
  1479. package/dist/unix/calculate/diffUnixAsDuration.d.ts +23 -20
  1480. package/dist/unix/calculate/diffUnixAsDuration.js +69 -75
  1481. package/dist/unix/calculate/endOfQuarterForUnix.d.ts +18 -18
  1482. package/dist/unix/calculate/endOfQuarterForUnix.js +37 -38
  1483. package/dist/unix/calculate/endOfUnix.d.ts +28 -28
  1484. package/dist/unix/calculate/endOfUnix.js +46 -48
  1485. package/dist/unix/calculate/index.d.ts +16 -14
  1486. package/dist/unix/calculate/index.js +17 -14
  1487. package/dist/unix/calculate/isBetweenUnix.d.ts +32 -32
  1488. package/dist/unix/calculate/isBetweenUnix.js +44 -59
  1489. package/dist/unix/calculate/maxUnix.d.ts +1 -1
  1490. package/dist/unix/calculate/maxUnix.js +26 -27
  1491. package/dist/unix/calculate/minUnix.d.ts +1 -1
  1492. package/dist/unix/calculate/minUnix.js +26 -27
  1493. package/dist/unix/calculate/roundUnix.d.ts +46 -44
  1494. package/dist/unix/calculate/roundUnix.js +79 -85
  1495. package/dist/unix/calculate/secondsUntilUnix.d.ts +55 -0
  1496. package/dist/unix/calculate/secondsUntilUnix.js +62 -0
  1497. package/dist/unix/calculate/setUnix.d.ts +49 -46
  1498. package/dist/unix/calculate/setUnix.js +80 -87
  1499. package/dist/unix/calculate/sortUnix.d.ts +1 -1
  1500. package/dist/unix/calculate/sortUnix.js +31 -33
  1501. package/dist/unix/calculate/startOfQuarterForUnix.d.ts +18 -18
  1502. package/dist/unix/calculate/startOfQuarterForUnix.js +38 -39
  1503. package/dist/unix/calculate/startOfUnix.d.ts +28 -28
  1504. package/dist/unix/calculate/startOfUnix.js +46 -48
  1505. package/dist/unix/calculate/subtractUnix.d.ts +28 -26
  1506. package/dist/unix/calculate/subtractUnix.js +55 -59
  1507. package/dist/unix/compare/areUnixEqual.d.ts +9 -9
  1508. package/dist/unix/compare/areUnixEqual.js +33 -34
  1509. package/dist/unix/compare/areUnixEqualBy.d.ts +32 -32
  1510. package/dist/unix/compare/areUnixEqualBy.js +54 -54
  1511. package/dist/unix/compare/index.d.ts +5 -4
  1512. package/dist/unix/compare/index.js +6 -4
  1513. package/dist/unix/compare/isAfterUnix.d.ts +9 -9
  1514. package/dist/unix/compare/isAfterUnix.js +31 -32
  1515. package/dist/unix/compare/isBeforeUnix.d.ts +9 -9
  1516. package/dist/unix/compare/isBeforeUnix.js +32 -33
  1517. package/dist/unix/convert/convertUnixToPlainDate.d.ts +22 -22
  1518. package/dist/unix/convert/convertUnixToPlainDate.js +42 -47
  1519. package/dist/unix/convert/convertUnixToPlainDateTime.d.ts +22 -22
  1520. package/dist/unix/convert/convertUnixToPlainDateTime.js +40 -45
  1521. package/dist/unix/convert/convertUnixToPlainTime.d.ts +23 -23
  1522. package/dist/unix/convert/convertUnixToPlainTime.js +40 -45
  1523. package/dist/unix/convert/convertUnixToUtc.d.ts +9 -9
  1524. package/dist/unix/convert/convertUnixToUtc.js +32 -33
  1525. package/dist/unix/convert/convertUnixToZoned.d.ts +10 -10
  1526. package/dist/unix/convert/convertUnixToZoned.js +43 -47
  1527. package/dist/unix/convert/index.d.ts +6 -5
  1528. package/dist/unix/convert/index.js +7 -5
  1529. package/dist/unix/format/formatCalendarUnix.d.ts +40 -39
  1530. package/dist/unix/format/formatCalendarUnix.js +53 -60
  1531. package/dist/unix/format/formatRelativeUnix.d.ts +67 -65
  1532. package/dist/unix/format/formatRelativeUnix.js +64 -73
  1533. package/dist/unix/format/formatUnix.d.ts +33 -33
  1534. package/dist/unix/format/formatUnix.js +68 -75
  1535. package/dist/unix/format/index.d.ts +4 -3
  1536. package/dist/unix/format/index.js +5 -3
  1537. package/dist/unix/get/getUnixAgo.d.ts +38 -0
  1538. package/dist/unix/get/getUnixAgo.js +44 -0
  1539. package/dist/unix/get/getUnixDay.d.ts +2 -2
  1540. package/dist/unix/get/getUnixDay.js +16 -15
  1541. package/dist/unix/get/getUnixHour.d.ts +2 -2
  1542. package/dist/unix/get/getUnixHour.js +16 -15
  1543. package/dist/unix/get/getUnixIn.d.ts +40 -0
  1544. package/dist/unix/get/getUnixIn.js +46 -0
  1545. package/dist/unix/get/getUnixMicrosecond.d.ts +2 -2
  1546. package/dist/unix/get/getUnixMicrosecond.js +16 -14
  1547. package/dist/unix/get/getUnixMillisecond.d.ts +2 -2
  1548. package/dist/unix/get/getUnixMillisecond.js +16 -15
  1549. package/dist/unix/get/getUnixMinute.d.ts +2 -2
  1550. package/dist/unix/get/getUnixMinute.js +16 -15
  1551. package/dist/unix/get/getUnixMonth.d.ts +2 -2
  1552. package/dist/unix/get/getUnixMonth.js +16 -15
  1553. package/dist/unix/get/getUnixNanosecond.d.ts +2 -2
  1554. package/dist/unix/get/getUnixNanosecond.js +16 -14
  1555. package/dist/unix/get/getUnixNow.d.ts +19 -16
  1556. package/dist/unix/get/getUnixNow.js +14 -35
  1557. package/dist/unix/get/getUnixNowUnit.d.ts +5 -4
  1558. package/dist/unix/get/getUnixNowUnit.js +34 -32
  1559. package/dist/unix/get/getUnixSecond.d.ts +2 -2
  1560. package/dist/unix/get/getUnixSecond.js +16 -15
  1561. package/dist/unix/get/getUnixYear.d.ts +2 -2
  1562. package/dist/unix/get/getUnixYear.js +18 -14
  1563. package/dist/unix/get/index.d.ts +15 -11
  1564. package/dist/unix/get/index.js +15 -11
  1565. package/dist/unix/index.d.ts +85 -9
  1566. package/dist/unix/index.js +79 -10
  1567. package/dist/unix/interval/index.d.ts +19 -18
  1568. package/dist/unix/interval/index.js +20 -18
  1569. package/dist/unix/interval/intervalAbutsUnix.d.ts +1 -1
  1570. package/dist/unix/interval/intervalAbutsUnix.js +36 -34
  1571. package/dist/unix/interval/intervalContainsUnix.d.ts +1 -1
  1572. package/dist/unix/interval/intervalContainsUnix.js +48 -45
  1573. package/dist/unix/interval/intervalCountUnix.d.ts +18 -18
  1574. package/dist/unix/interval/intervalCountUnix.js +64 -71
  1575. package/dist/unix/interval/intervalDifferenceUnix.d.ts +9 -9
  1576. package/dist/unix/interval/intervalDifferenceUnix.js +38 -37
  1577. package/dist/unix/interval/intervalDivideEquallyUnix.d.ts +17 -17
  1578. package/dist/unix/interval/intervalDivideEquallyUnix.js +65 -72
  1579. package/dist/unix/interval/intervalEngulfsUnix.d.ts +1 -1
  1580. package/dist/unix/interval/intervalEngulfsUnix.js +35 -32
  1581. package/dist/unix/interval/intervalFromDurationUnix.d.ts +38 -37
  1582. package/dist/unix/interval/intervalFromDurationUnix.js +75 -88
  1583. package/dist/unix/interval/intervalIntersectionUnix.d.ts +9 -9
  1584. package/dist/unix/interval/intervalIntersectionUnix.js +35 -34
  1585. package/dist/unix/interval/intervalLengthUnix.d.ts +20 -20
  1586. package/dist/unix/interval/intervalLengthUnix.js +55 -63
  1587. package/dist/unix/interval/intervalOverlappingDaysUnix.d.ts +18 -18
  1588. package/dist/unix/interval/intervalOverlappingDaysUnix.js +85 -93
  1589. package/dist/unix/interval/intervalSplitAtUnix.d.ts +9 -9
  1590. package/dist/unix/interval/intervalSplitAtUnix.js +61 -62
  1591. package/dist/unix/interval/intervalUnionUnix.d.ts +9 -9
  1592. package/dist/unix/interval/intervalUnionUnix.js +36 -34
  1593. package/dist/unix/interval/intervalXorAllUnix.d.ts +11 -11
  1594. package/dist/unix/interval/intervalXorAllUnix.js +37 -40
  1595. package/dist/unix/interval/intervalXorUnix.d.ts +9 -9
  1596. package/dist/unix/interval/intervalXorUnix.js +41 -40
  1597. package/dist/unix/interval/intervalsOverlapUnix.d.ts +1 -1
  1598. package/dist/unix/interval/intervalsOverlapUnix.js +35 -33
  1599. package/dist/unix/interval/mergeIntervalsUnix.d.ts +11 -11
  1600. package/dist/unix/interval/mergeIntervalsUnix.js +38 -42
  1601. package/dist/unix/interval/splitIntervalByUnitUnix.d.ts +40 -39
  1602. package/dist/unix/interval/splitIntervalByUnitUnix.js +92 -108
  1603. package/dist/unix/interval/validate/index.d.ts +2 -1
  1604. package/dist/unix/interval/validate/index.js +3 -1
  1605. package/dist/unix/interval/validate/isValidUnixInterval.d.ts +1 -1
  1606. package/dist/unix/interval/validate/isValidUnixInterval.js +32 -30
  1607. package/dist/unix/parse/index.d.ts +15 -14
  1608. package/dist/unix/parse/index.js +16 -14
  1609. package/dist/unix/parse/parseDateFromUnix.d.ts +18 -18
  1610. package/dist/unix/parse/parseDateFromUnix.js +28 -29
  1611. package/dist/unix/parse/parseDayFromUnix.d.ts +18 -18
  1612. package/dist/unix/parse/parseDayFromUnix.js +26 -27
  1613. package/dist/unix/parse/parseDayOfWeekFromUnix.d.ts +18 -18
  1614. package/dist/unix/parse/parseDayOfWeekFromUnix.js +27 -28
  1615. package/dist/unix/parse/parseHourFromUnix.d.ts +18 -18
  1616. package/dist/unix/parse/parseHourFromUnix.js +26 -27
  1617. package/dist/unix/parse/parseMicrosecondFromUnix.d.ts +18 -18
  1618. package/dist/unix/parse/parseMicrosecondFromUnix.js +26 -27
  1619. package/dist/unix/parse/parseMillisecondFromUnix.d.ts +18 -18
  1620. package/dist/unix/parse/parseMillisecondFromUnix.js +26 -27
  1621. package/dist/unix/parse/parseMinuteFromUnix.d.ts +18 -18
  1622. package/dist/unix/parse/parseMinuteFromUnix.js +26 -27
  1623. package/dist/unix/parse/parseMonthFromUnix.d.ts +18 -18
  1624. package/dist/unix/parse/parseMonthFromUnix.js +27 -28
  1625. package/dist/unix/parse/parseNanosecondFromUnix.d.ts +18 -18
  1626. package/dist/unix/parse/parseNanosecondFromUnix.js +27 -28
  1627. package/dist/unix/parse/parseSecondFromUnix.d.ts +18 -18
  1628. package/dist/unix/parse/parseSecondFromUnix.js +26 -27
  1629. package/dist/unix/parse/parseTimeFromUnix.d.ts +18 -18
  1630. package/dist/unix/parse/parseTimeFromUnix.js +29 -30
  1631. package/dist/unix/parse/parseUnitFromUnix.d.ts +28 -28
  1632. package/dist/unix/parse/parseUnitFromUnix.js +60 -80
  1633. package/dist/unix/parse/parseWeekFromUnix.d.ts +26 -26
  1634. package/dist/unix/parse/parseWeekFromUnix.js +37 -41
  1635. package/dist/unix/parse/parseYearFromUnix.d.ts +18 -18
  1636. package/dist/unix/parse/parseYearFromUnix.js +30 -31
  1637. package/dist/unix/validate/index.d.ts +5 -4
  1638. package/dist/unix/validate/index.js +6 -4
  1639. package/dist/unix/validate/isValidUnixMilliseconds.d.ts +1 -1
  1640. package/dist/unix/validate/isValidUnixMilliseconds.js +21 -17
  1641. package/dist/unix/validate/isValidUnixRange.d.ts +22 -22
  1642. package/dist/unix/validate/isValidUnixRange.js +37 -39
  1643. package/dist/unix/validate/isValidUnixSeconds.d.ts +1 -1
  1644. package/dist/unix/validate/isValidUnixSeconds.js +21 -17
  1645. package/dist/unix/validate/isValidUnixUnit.d.ts +1 -1
  1646. package/dist/unix/validate/isValidUnixUnit.js +21 -17
  1647. package/dist/utc/calculate/addUtc.d.ts +11 -9
  1648. package/dist/utc/calculate/addUtc.js +38 -47
  1649. package/dist/utc/calculate/diffUtc.d.ts +5 -3
  1650. package/dist/utc/calculate/diffUtc.js +81 -100
  1651. package/dist/utc/calculate/diffUtcAsDuration.d.ts +6 -3
  1652. package/dist/utc/calculate/diffUtcAsDuration.js +51 -53
  1653. package/dist/utc/calculate/endOfQuarterForUtc.d.ts +1 -1
  1654. package/dist/utc/calculate/endOfQuarterForUtc.js +40 -46
  1655. package/dist/utc/calculate/endOfUtc.d.ts +20 -19
  1656. package/dist/utc/calculate/endOfUtc.js +33 -34
  1657. package/dist/utc/calculate/index.d.ts +17 -14
  1658. package/dist/utc/calculate/index.js +18 -14
  1659. package/dist/utc/calculate/isBetweenUtc.d.ts +15 -15
  1660. package/dist/utc/calculate/isBetweenUtc.js +48 -64
  1661. package/dist/utc/calculate/maxUtc.d.ts +1 -1
  1662. package/dist/utc/calculate/maxUtc.js +34 -39
  1663. package/dist/utc/calculate/minUtc.d.ts +1 -1
  1664. package/dist/utc/calculate/minUtc.js +34 -39
  1665. package/dist/utc/calculate/roundUtc.d.ts +33 -32
  1666. package/dist/utc/calculate/roundUtc.js +52 -55
  1667. package/dist/utc/calculate/secondsUntilHttpDate.d.ts +34 -0
  1668. package/dist/utc/calculate/secondsUntilHttpDate.js +50 -0
  1669. package/dist/utc/calculate/secondsUntilRetryAfter.d.ts +29 -0
  1670. package/dist/utc/calculate/secondsUntilRetryAfter.js +51 -0
  1671. package/dist/utc/calculate/setUtc.d.ts +11 -10
  1672. package/dist/utc/calculate/setUtc.js +62 -69
  1673. package/dist/utc/calculate/sortUtc.d.ts +1 -1
  1674. package/dist/utc/calculate/sortUtc.js +36 -40
  1675. package/dist/utc/calculate/startOfQuarterForUtc.d.ts +1 -1
  1676. package/dist/utc/calculate/startOfQuarterForUtc.js +38 -41
  1677. package/dist/utc/calculate/startOfUtc.d.ts +20 -19
  1678. package/dist/utc/calculate/startOfUtc.js +28 -29
  1679. package/dist/utc/calculate/subtractUtc.d.ts +11 -9
  1680. package/dist/utc/calculate/subtractUtc.js +38 -47
  1681. package/dist/utc/chop/chopUtc.d.ts +1 -1
  1682. package/dist/utc/chop/chopUtc.js +23 -22
  1683. package/dist/utc/chop/index.d.ts +2 -1
  1684. package/dist/utc/chop/index.js +3 -1
  1685. package/dist/utc/compare/areUtcEqual.d.ts +1 -1
  1686. package/dist/utc/compare/areUtcEqual.js +28 -27
  1687. package/dist/utc/compare/areUtcEqualBy.d.ts +11 -11
  1688. package/dist/utc/compare/areUtcEqualBy.js +54 -62
  1689. package/dist/utc/compare/index.d.ts +5 -4
  1690. package/dist/utc/compare/index.js +6 -4
  1691. package/dist/utc/compare/isAfterUtc.d.ts +1 -1
  1692. package/dist/utc/compare/isAfterUtc.js +28 -26
  1693. package/dist/utc/compare/isBeforeUtc.d.ts +1 -1
  1694. package/dist/utc/compare/isBeforeUtc.js +28 -27
  1695. package/dist/utc/convert/convertUtcToPlainDate.d.ts +11 -11
  1696. package/dist/utc/convert/convertUtcToPlainDate.js +39 -46
  1697. package/dist/utc/convert/convertUtcToPlainDateTime.d.ts +11 -11
  1698. package/dist/utc/convert/convertUtcToPlainDateTime.js +40 -48
  1699. package/dist/utc/convert/convertUtcToPlainTime.d.ts +11 -11
  1700. package/dist/utc/convert/convertUtcToPlainTime.js +37 -44
  1701. package/dist/utc/convert/convertUtcToUnix.d.ts +9 -9
  1702. package/dist/utc/convert/convertUtcToUnix.js +37 -39
  1703. package/dist/utc/convert/convertUtcToZoned.d.ts +2 -2
  1704. package/dist/utc/convert/convertUtcToZoned.js +31 -30
  1705. package/dist/utc/convert/index.d.ts +6 -5
  1706. package/dist/utc/convert/index.js +7 -5
  1707. package/dist/utc/format/formatCalendarUtc.d.ts +23 -21
  1708. package/dist/utc/format/formatCalendarUtc.js +51 -62
  1709. package/dist/utc/format/formatHttpDate.d.ts +1 -1
  1710. package/dist/utc/format/formatHttpDate.js +41 -42
  1711. package/dist/utc/format/formatHttpDateFromNow.d.ts +31 -0
  1712. package/dist/utc/format/formatHttpDateFromNow.js +45 -0
  1713. package/dist/utc/format/formatRelativeUtc.d.ts +33 -31
  1714. package/dist/utc/format/formatRelativeUtc.js +60 -71
  1715. package/dist/utc/format/formatUtc.d.ts +25 -25
  1716. package/dist/utc/format/formatUtc.js +60 -68
  1717. package/dist/utc/format/index.d.ts +6 -4
  1718. package/dist/utc/format/index.js +7 -4
  1719. package/dist/utc/get/getUtcAgo.d.ts +31 -0
  1720. package/dist/utc/get/getUtcAgo.js +47 -0
  1721. package/dist/utc/get/getUtcDay.d.ts +2 -2
  1722. package/dist/utc/get/getUtcDay.js +16 -15
  1723. package/dist/utc/get/getUtcHour.d.ts +2 -2
  1724. package/dist/utc/get/getUtcHour.js +16 -15
  1725. package/dist/utc/get/getUtcIn.d.ts +31 -0
  1726. package/dist/utc/get/getUtcIn.js +47 -0
  1727. package/dist/utc/get/getUtcMicrosecond.d.ts +2 -2
  1728. package/dist/utc/get/getUtcMicrosecond.js +16 -14
  1729. package/dist/utc/get/getUtcMillisecond.d.ts +2 -2
  1730. package/dist/utc/get/getUtcMillisecond.js +16 -15
  1731. package/dist/utc/get/getUtcMinute.d.ts +2 -2
  1732. package/dist/utc/get/getUtcMinute.js +16 -15
  1733. package/dist/utc/get/getUtcMonth.d.ts +2 -2
  1734. package/dist/utc/get/getUtcMonth.js +16 -15
  1735. package/dist/utc/get/getUtcNanosecond.d.ts +2 -2
  1736. package/dist/utc/get/getUtcNanosecond.js +16 -14
  1737. package/dist/utc/get/getUtcNow.d.ts +2 -2
  1738. package/dist/utc/get/getUtcNow.js +15 -11
  1739. package/dist/utc/get/getUtcNowUnit.d.ts +4 -3
  1740. package/dist/utc/get/getUtcNowUnit.js +36 -36
  1741. package/dist/utc/get/getUtcSecond.d.ts +2 -2
  1742. package/dist/utc/get/getUtcSecond.js +16 -15
  1743. package/dist/utc/get/getUtcYear.d.ts +2 -2
  1744. package/dist/utc/get/getUtcYear.js +18 -14
  1745. package/dist/utc/get/index.d.ts +15 -11
  1746. package/dist/utc/get/index.js +15 -11
  1747. package/dist/utc/index.d.ts +90 -10
  1748. package/dist/utc/index.js +84 -11
  1749. package/dist/utc/interval/index.d.ts +19 -18
  1750. package/dist/utc/interval/index.js +20 -18
  1751. package/dist/utc/interval/intervalAbutsUtc.d.ts +1 -1
  1752. package/dist/utc/interval/intervalAbutsUtc.js +50 -56
  1753. package/dist/utc/interval/intervalContainsUtc.d.ts +1 -1
  1754. package/dist/utc/interval/intervalContainsUtc.js +60 -63
  1755. package/dist/utc/interval/intervalCountUtc.d.ts +1 -1
  1756. package/dist/utc/interval/intervalCountUtc.js +49 -59
  1757. package/dist/utc/interval/intervalDifferenceUtc.d.ts +9 -9
  1758. package/dist/utc/interval/intervalDifferenceUtc.js +44 -48
  1759. package/dist/utc/interval/intervalDivideEquallyUtc.d.ts +17 -17
  1760. package/dist/utc/interval/intervalDivideEquallyUtc.js +69 -82
  1761. package/dist/utc/interval/intervalEngulfsUtc.d.ts +1 -1
  1762. package/dist/utc/interval/intervalEngulfsUtc.js +52 -58
  1763. package/dist/utc/interval/intervalFromDurationUtc.d.ts +18 -17
  1764. package/dist/utc/interval/intervalFromDurationUtc.js +53 -64
  1765. package/dist/utc/interval/intervalIntersectionUtc.d.ts +9 -9
  1766. package/dist/utc/interval/intervalIntersectionUtc.js +42 -45
  1767. package/dist/utc/interval/intervalLengthUtc.d.ts +1 -1
  1768. package/dist/utc/interval/intervalLengthUtc.js +42 -48
  1769. package/dist/utc/interval/intervalOverlappingDaysUtc.d.ts +1 -1
  1770. package/dist/utc/interval/intervalOverlappingDaysUtc.js +53 -62
  1771. package/dist/utc/interval/intervalSplitAtUtc.d.ts +9 -9
  1772. package/dist/utc/interval/intervalSplitAtUtc.js +63 -70
  1773. package/dist/utc/interval/intervalUnionUtc.d.ts +9 -9
  1774. package/dist/utc/interval/intervalUnionUtc.js +45 -52
  1775. package/dist/utc/interval/intervalXorAllUtc.d.ts +11 -11
  1776. package/dist/utc/interval/intervalXorAllUtc.js +49 -56
  1777. package/dist/utc/interval/intervalXorUtc.d.ts +9 -9
  1778. package/dist/utc/interval/intervalXorUtc.js +52 -61
  1779. package/dist/utc/interval/intervalsOverlapUtc.d.ts +1 -1
  1780. package/dist/utc/interval/intervalsOverlapUtc.js +40 -41
  1781. package/dist/utc/interval/mergeIntervalsUtc.d.ts +11 -11
  1782. package/dist/utc/interval/mergeIntervalsUtc.js +39 -45
  1783. package/dist/utc/interval/splitIntervalByUnitUtc.d.ts +19 -18
  1784. package/dist/utc/interval/splitIntervalByUnitUtc.js +79 -96
  1785. package/dist/utc/interval/validate/index.d.ts +2 -1
  1786. package/dist/utc/interval/validate/index.js +3 -1
  1787. package/dist/utc/interval/validate/isValidUtcInterval.d.ts +1 -1
  1788. package/dist/utc/interval/validate/isValidUtcInterval.js +38 -39
  1789. package/dist/utc/parse/index.d.ts +16 -15
  1790. package/dist/utc/parse/index.js +17 -15
  1791. package/dist/utc/parse/parseDateFromUtc.d.ts +11 -11
  1792. package/dist/utc/parse/parseDateFromUtc.js +26 -27
  1793. package/dist/utc/parse/parseDayFromUtc.d.ts +11 -11
  1794. package/dist/utc/parse/parseDayFromUtc.js +26 -27
  1795. package/dist/utc/parse/parseDayOfWeekFromUtc.d.ts +11 -11
  1796. package/dist/utc/parse/parseDayOfWeekFromUtc.js +35 -40
  1797. package/dist/utc/parse/parseHourFromUtc.d.ts +11 -11
  1798. package/dist/utc/parse/parseHourFromUtc.js +26 -27
  1799. package/dist/utc/parse/parseHttpDate.d.ts +4 -2
  1800. package/dist/utc/parse/parseHttpDate.js +87 -88
  1801. package/dist/utc/parse/parseMicrosecondFromUtc.d.ts +11 -11
  1802. package/dist/utc/parse/parseMicrosecondFromUtc.js +27 -30
  1803. package/dist/utc/parse/parseMillisecondFromUtc.d.ts +11 -11
  1804. package/dist/utc/parse/parseMillisecondFromUtc.js +26 -29
  1805. package/dist/utc/parse/parseMinuteFromUtc.d.ts +10 -10
  1806. package/dist/utc/parse/parseMinuteFromUtc.js +26 -27
  1807. package/dist/utc/parse/parseMonthFromUtc.d.ts +11 -11
  1808. package/dist/utc/parse/parseMonthFromUtc.js +26 -27
  1809. package/dist/utc/parse/parseNanosecondFromUtc.d.ts +11 -11
  1810. package/dist/utc/parse/parseNanosecondFromUtc.js +27 -30
  1811. package/dist/utc/parse/parseSecondFromUtc.d.ts +11 -11
  1812. package/dist/utc/parse/parseSecondFromUtc.js +26 -27
  1813. package/dist/utc/parse/parseTimeFromUtc.d.ts +11 -11
  1814. package/dist/utc/parse/parseTimeFromUtc.js +36 -43
  1815. package/dist/utc/parse/parseUnitFromUtc.d.ts +21 -21
  1816. package/dist/utc/parse/parseUnitFromUtc.js +63 -81
  1817. package/dist/utc/parse/parseWeekFromUtc.d.ts +20 -20
  1818. package/dist/utc/parse/parseWeekFromUtc.js +42 -47
  1819. package/dist/utc/parse/parseYearFromUtc.d.ts +11 -11
  1820. package/dist/utc/parse/parseYearFromUtc.js +28 -29
  1821. package/dist/utc/validate/index.d.ts +5 -4
  1822. package/dist/utc/validate/index.js +6 -4
  1823. package/dist/utc/validate/isValidHttpDate.d.ts +8 -3
  1824. package/dist/utc/validate/isValidHttpDate.js +6 -36
  1825. package/dist/utc/validate/isValidUtc.d.ts +6 -1
  1826. package/dist/utc/validate/isValidUtc.js +17 -44
  1827. package/dist/utc/validate/isValidUtcRange.d.ts +17 -17
  1828. package/dist/utc/validate/isValidUtcRange.js +40 -49
  1829. package/dist/utc/validate/isValidUtcTimestamp.d.ts +6 -2
  1830. package/dist/utc/validate/isValidUtcTimestamp.js +6 -45
  1831. package/dist/{duty → workforce}/calculate/dutyDayFor.d.ts +4 -2
  1832. package/dist/workforce/calculate/dutyDayFor.js +65 -0
  1833. package/dist/{duty → workforce}/calculate/dutyTotals.d.ts +4 -2
  1834. package/dist/workforce/calculate/dutyTotals.js +41 -0
  1835. package/dist/{duty → workforce}/calculate/dutyViolations.d.ts +28 -25
  1836. package/dist/workforce/calculate/dutyViolations.js +64 -0
  1837. package/dist/{duty → workforce}/calculate/evaluateDutyLog.d.ts +27 -25
  1838. package/dist/workforce/calculate/evaluateDutyLog.js +74 -0
  1839. package/dist/workforce/calculate/index.d.ts +8 -0
  1840. package/dist/workforce/calculate/index.js +9 -0
  1841. package/dist/{duty → workforce}/calculate/longestRun.d.ts +8 -6
  1842. package/dist/workforce/calculate/longestRun.js +49 -0
  1843. package/dist/{duty → workforce}/calculate/qualifyingRestPairs.d.ts +12 -11
  1844. package/dist/workforce/calculate/qualifyingRestPairs.js +59 -0
  1845. package/dist/{duty → workforce}/calculate/qualifyingRests.d.ts +8 -6
  1846. package/dist/workforce/calculate/qualifyingRests.js +45 -0
  1847. package/dist/workforce/index.d.ts +11 -0
  1848. package/dist/workforce/index.js +11 -0
  1849. package/dist/workforce/validate/index.d.ts +2 -0
  1850. package/dist/workforce/validate/index.js +3 -0
  1851. package/dist/{duty → workforce}/validate/isValidDutyLog.d.ts +3 -3
  1852. package/dist/workforce/validate/isValidDutyLog.js +35 -0
  1853. package/dist/zoned/calculate/addZoned.d.ts +38 -35
  1854. package/dist/zoned/calculate/addZoned.js +85 -89
  1855. package/dist/zoned/calculate/addZonedBusinessDays.d.ts +6 -5
  1856. package/dist/zoned/calculate/addZonedBusinessDays.js +29 -30
  1857. package/dist/zoned/calculate/clampZoned.d.ts +1 -1
  1858. package/dist/zoned/calculate/clampZoned.js +40 -47
  1859. package/dist/zoned/calculate/closestZonedTo.d.ts +1 -1
  1860. package/dist/zoned/calculate/closestZonedTo.js +43 -53
  1861. package/dist/zoned/calculate/cycleZoned.d.ts +42 -38
  1862. package/dist/zoned/calculate/cycleZoned.js +56 -56
  1863. package/dist/zoned/calculate/diffZoned.d.ts +12 -10
  1864. package/dist/zoned/calculate/diffZoned.js +98 -117
  1865. package/dist/zoned/calculate/diffZonedAsDuration.d.ts +10 -7
  1866. package/dist/zoned/calculate/diffZonedAsDuration.js +65 -69
  1867. package/dist/zoned/calculate/endOfQuarterForZoned.d.ts +11 -10
  1868. package/dist/zoned/calculate/endOfQuarterForZoned.js +41 -46
  1869. package/dist/zoned/calculate/endOfZoned.d.ts +23 -21
  1870. package/dist/zoned/calculate/endOfZoned.js +39 -40
  1871. package/dist/zoned/calculate/getHoursInZonedDay.d.ts +3 -3
  1872. package/dist/zoned/calculate/getHoursInZonedDay.js +41 -39
  1873. package/dist/zoned/calculate/getLocaleZonedDayOfWeek.d.ts +7 -6
  1874. package/dist/zoned/calculate/getLocaleZonedDayOfWeek.js +39 -37
  1875. package/dist/zoned/calculate/getLocaleZonedEndOfWeek.d.ts +16 -15
  1876. package/dist/zoned/calculate/getLocaleZonedEndOfWeek.js +57 -59
  1877. package/dist/zoned/calculate/getLocaleZonedStartOfWeek.d.ts +16 -15
  1878. package/dist/zoned/calculate/getLocaleZonedStartOfWeek.js +55 -57
  1879. package/dist/zoned/calculate/getQuarterForZoned.d.ts +1 -1
  1880. package/dist/zoned/calculate/getQuarterForZoned.js +27 -26
  1881. package/dist/zoned/calculate/index.d.ts +24 -23
  1882. package/dist/zoned/calculate/index.js +25 -23
  1883. package/dist/zoned/calculate/maxZoned.d.ts +3 -3
  1884. package/dist/zoned/calculate/maxZoned.js +36 -41
  1885. package/dist/zoned/calculate/minZoned.d.ts +3 -3
  1886. package/dist/zoned/calculate/minZoned.js +36 -41
  1887. package/dist/zoned/calculate/roundZoned.d.ts +35 -33
  1888. package/dist/zoned/calculate/roundZoned.js +69 -70
  1889. package/dist/zoned/calculate/setZoned.d.ts +40 -37
  1890. package/dist/zoned/calculate/setZoned.js +76 -82
  1891. package/dist/zoned/calculate/sortZoned.d.ts +4 -4
  1892. package/dist/zoned/calculate/sortZoned.js +38 -42
  1893. package/dist/zoned/calculate/startOfQuarterForZoned.d.ts +10 -9
  1894. package/dist/zoned/calculate/startOfQuarterForZoned.js +37 -40
  1895. package/dist/zoned/calculate/startOfZoned.d.ts +23 -21
  1896. package/dist/zoned/calculate/startOfZoned.js +34 -35
  1897. package/dist/zoned/calculate/subtractZoned.d.ts +37 -34
  1898. package/dist/zoned/calculate/subtractZoned.js +81 -84
  1899. package/dist/zoned/calculate/subtractZonedBusinessDays.d.ts +6 -5
  1900. package/dist/zoned/calculate/subtractZonedBusinessDays.js +29 -28
  1901. package/dist/zoned/chop/chopZonedDate.d.ts +2 -2
  1902. package/dist/zoned/chop/chopZonedDate.js +23 -21
  1903. package/dist/zoned/chop/chopZonedDateTime.d.ts +1 -1
  1904. package/dist/zoned/chop/chopZonedDateTime.js +23 -23
  1905. package/dist/zoned/chop/chopZonedMilliseconds.d.ts +2 -2
  1906. package/dist/zoned/chop/chopZonedMilliseconds.js +23 -23
  1907. package/dist/zoned/chop/chopZonedSeconds.d.ts +2 -2
  1908. package/dist/zoned/chop/chopZonedSeconds.js +23 -23
  1909. package/dist/zoned/chop/chopZonedTime.d.ts +2 -2
  1910. package/dist/zoned/chop/chopZonedTime.js +23 -21
  1911. package/dist/zoned/chop/chopZonedTimezone.d.ts +2 -2
  1912. package/dist/zoned/chop/chopZonedTimezone.js +23 -21
  1913. package/dist/zoned/chop/index.d.ts +7 -6
  1914. package/dist/zoned/chop/index.js +8 -6
  1915. package/dist/zoned/classify/classifyStoredZoned.d.ts +47 -0
  1916. package/dist/zoned/classify/classifyStoredZoned.js +158 -0
  1917. package/dist/zoned/classify/index.d.ts +2 -0
  1918. package/dist/zoned/classify/index.js +3 -0
  1919. package/dist/zoned/compare/areZonedEqual.d.ts +20 -4
  1920. package/dist/zoned/compare/areZonedEqual.js +51 -44
  1921. package/dist/zoned/compare/areZonedEqualBy.d.ts +21 -21
  1922. package/dist/zoned/compare/areZonedEqualBy.js +69 -80
  1923. package/dist/zoned/compare/index.d.ts +13 -12
  1924. package/dist/zoned/compare/index.js +14 -12
  1925. package/dist/zoned/compare/isAfterZoned.d.ts +1 -1
  1926. package/dist/zoned/compare/isAfterZoned.js +35 -35
  1927. package/dist/zoned/compare/isBeforeZoned.d.ts +3 -3
  1928. package/dist/zoned/compare/isBeforeZoned.js +35 -35
  1929. package/dist/zoned/compare/isBetweenZoned.d.ts +15 -15
  1930. package/dist/zoned/compare/isBetweenZoned.js +51 -69
  1931. package/dist/zoned/compare/isInDaylightSaving.d.ts +3 -3
  1932. package/dist/zoned/compare/isInDaylightSaving.js +64 -62
  1933. package/dist/zoned/compare/isZonedBusinessDay.d.ts +8 -7
  1934. package/dist/zoned/compare/isZonedBusinessDay.js +38 -35
  1935. package/dist/zoned/compare/isZonedFuture.d.ts +2 -2
  1936. package/dist/zoned/compare/isZonedFuture.js +32 -30
  1937. package/dist/zoned/compare/isZonedPast.d.ts +2 -2
  1938. package/dist/zoned/compare/isZonedPast.js +32 -30
  1939. package/dist/zoned/compare/isZonedRelativeDay.d.ts +3 -3
  1940. package/dist/zoned/compare/isZonedRelativeDay.js +40 -39
  1941. package/dist/zoned/compare/isZonedThisUnit.d.ts +8 -8
  1942. package/dist/zoned/compare/isZonedThisUnit.js +63 -69
  1943. package/dist/zoned/compare/isZonedWeekend.d.ts +6 -6
  1944. package/dist/zoned/compare/isZonedWeekend.js +42 -40
  1945. package/dist/zoned/convert/convertPlainDateTimeToZoned.d.ts +26 -25
  1946. package/dist/zoned/convert/convertPlainDateTimeToZoned.js +47 -54
  1947. package/dist/zoned/convert/convertZonedToCalendar.d.ts +8 -7
  1948. package/dist/zoned/convert/convertZonedToCalendar.js +50 -50
  1949. package/dist/zoned/convert/convertZonedToPlainDateTime.d.ts +4 -4
  1950. package/dist/zoned/convert/convertZonedToPlainDateTime.js +29 -28
  1951. package/dist/zoned/convert/convertZonedToUnix.d.ts +10 -10
  1952. package/dist/zoned/convert/convertZonedToUnix.js +35 -37
  1953. package/dist/zoned/convert/convertZonedToUtc.d.ts +1 -1
  1954. package/dist/zoned/convert/convertZonedToUtc.js +24 -23
  1955. package/dist/zoned/convert/convertZonedToZoned.d.ts +3 -3
  1956. package/dist/zoned/convert/convertZonedToZoned.js +30 -29
  1957. package/dist/zoned/convert/index.d.ts +7 -6
  1958. package/dist/zoned/convert/index.js +8 -6
  1959. package/dist/zoned/format/formatCalendarZoned.d.ts +23 -22
  1960. package/dist/zoned/format/formatCalendarZoned.js +50 -64
  1961. package/dist/zoned/format/formatRelativeZoned.d.ts +48 -46
  1962. package/dist/zoned/format/formatRelativeZoned.js +60 -76
  1963. package/dist/zoned/format/formatRfc2822.d.ts +4 -4
  1964. package/dist/zoned/format/formatRfc2822.js +55 -58
  1965. package/dist/zoned/format/formatRfc3339.d.ts +3 -3
  1966. package/dist/zoned/format/formatRfc3339.js +52 -60
  1967. package/dist/zoned/format/formatTimeZoneName.d.ts +27 -27
  1968. package/dist/zoned/format/formatTimeZoneName.js +61 -67
  1969. package/dist/zoned/format/formatZonedDateTime.d.ts +13 -12
  1970. package/dist/zoned/format/formatZonedDateTime.js +55 -61
  1971. package/dist/zoned/format/formatZonedRange.d.ts +20 -11
  1972. package/dist/zoned/format/formatZonedRange.js +101 -79
  1973. package/dist/zoned/format/formatZonedToParts.d.ts +25 -24
  1974. package/dist/zoned/format/formatZonedToParts.js +71 -77
  1975. package/dist/zoned/format/index.d.ts +9 -8
  1976. package/dist/zoned/format/index.js +10 -8
  1977. package/dist/zoned/get/getDstTransitions.d.ts +13 -13
  1978. package/dist/zoned/get/getDstTransitions.js +69 -73
  1979. package/dist/zoned/get/getSystemTimeZone.d.ts +3 -3
  1980. package/dist/zoned/get/getSystemTimeZone.js +22 -19
  1981. package/dist/zoned/get/getTimeZoneOffset.d.ts +6 -6
  1982. package/dist/zoned/get/getTimeZoneOffset.js +56 -62
  1983. package/dist/zoned/get/getTimeZones.d.ts +2 -2
  1984. package/dist/zoned/get/getTimeZones.js +19 -17
  1985. package/dist/zoned/get/getZonedAgo.d.ts +33 -0
  1986. package/dist/zoned/get/getZonedAgo.js +52 -0
  1987. package/dist/zoned/get/getZonedDay.d.ts +3 -3
  1988. package/dist/zoned/get/getZonedDay.js +24 -22
  1989. package/dist/zoned/get/getZonedDayOfWeek.d.ts +3 -3
  1990. package/dist/zoned/get/getZonedDayOfWeek.js +25 -24
  1991. package/dist/zoned/get/getZonedHour.d.ts +3 -3
  1992. package/dist/zoned/get/getZonedHour.js +24 -22
  1993. package/dist/zoned/get/getZonedIn.d.ts +33 -0
  1994. package/dist/zoned/get/getZonedIn.js +52 -0
  1995. package/dist/zoned/get/getZonedMicrosecond.d.ts +3 -3
  1996. package/dist/zoned/get/getZonedMicrosecond.js +24 -24
  1997. package/dist/zoned/get/getZonedMillisecond.d.ts +3 -3
  1998. package/dist/zoned/get/getZonedMillisecond.js +24 -22
  1999. package/dist/zoned/get/getZonedMinute.d.ts +3 -3
  2000. package/dist/zoned/get/getZonedMinute.js +24 -22
  2001. package/dist/zoned/get/getZonedMonth.d.ts +3 -3
  2002. package/dist/zoned/get/getZonedMonth.js +24 -22
  2003. package/dist/zoned/get/getZonedNanosecond.d.ts +3 -3
  2004. package/dist/zoned/get/getZonedNanosecond.js +24 -24
  2005. package/dist/zoned/get/getZonedNow.d.ts +14 -14
  2006. package/dist/zoned/get/getZonedNow.js +40 -51
  2007. package/dist/zoned/get/getZonedNowUnit.d.ts +4 -4
  2008. package/dist/zoned/get/getZonedNowUnit.js +52 -53
  2009. package/dist/zoned/get/getZonedSecond.d.ts +3 -3
  2010. package/dist/zoned/get/getZonedSecond.js +24 -22
  2011. package/dist/zoned/get/getZonedToday.d.ts +3 -3
  2012. package/dist/zoned/get/getZonedToday.js +24 -24
  2013. package/dist/zoned/get/getZonedWeekOfYear.d.ts +3 -3
  2014. package/dist/zoned/get/getZonedWeekOfYear.js +25 -24
  2015. package/dist/zoned/get/getZonedYear.d.ts +3 -3
  2016. package/dist/zoned/get/getZonedYear.js +27 -25
  2017. package/dist/zoned/get/index.d.ts +21 -18
  2018. package/dist/zoned/get/index.js +22 -18
  2019. package/dist/zoned/index.d.ts +134 -11
  2020. package/dist/zoned/index.js +127 -12
  2021. package/dist/zoned/interval/index.d.ts +20 -18
  2022. package/dist/zoned/interval/index.js +21 -18
  2023. package/dist/zoned/interval/intervalAbutsZoned.d.ts +3 -3
  2024. package/dist/zoned/interval/intervalAbutsZoned.js +66 -71
  2025. package/dist/zoned/interval/intervalContainsZoned.d.ts +2 -2
  2026. package/dist/zoned/interval/intervalContainsZoned.js +70 -76
  2027. package/dist/zoned/interval/intervalCountZoned.d.ts +5 -5
  2028. package/dist/zoned/interval/intervalCountZoned.js +69 -84
  2029. package/dist/zoned/interval/intervalDifferenceZoned.d.ts +12 -12
  2030. package/dist/zoned/interval/intervalDifferenceZoned.js +77 -80
  2031. package/dist/zoned/interval/intervalDivideEquallyZoned.d.ts +21 -21
  2032. package/dist/zoned/interval/intervalDivideEquallyZoned.js +79 -99
  2033. package/dist/zoned/interval/intervalEngulfsZoned.d.ts +2 -2
  2034. package/dist/zoned/interval/intervalEngulfsZoned.js +64 -69
  2035. package/dist/zoned/interval/intervalFromDurationZoned.d.ts +39 -37
  2036. package/dist/zoned/interval/intervalFromDurationZoned.js +85 -91
  2037. package/dist/zoned/interval/intervalIntersectionZoned.d.ts +12 -12
  2038. package/dist/zoned/interval/intervalIntersectionZoned.js +76 -81
  2039. package/dist/zoned/interval/intervalLengthZoned.d.ts +6 -6
  2040. package/dist/zoned/interval/intervalLengthZoned.js +60 -73
  2041. package/dist/zoned/interval/intervalOverlappingDaysZoned.d.ts +3 -3
  2042. package/dist/zoned/interval/intervalOverlappingDaysZoned.js +89 -99
  2043. package/dist/zoned/interval/intervalSplitAtZoned.d.ts +12 -12
  2044. package/dist/zoned/interval/intervalSplitAtZoned.js +84 -93
  2045. package/dist/zoned/interval/intervalUnionZoned.d.ts +12 -12
  2046. package/dist/zoned/interval/intervalUnionZoned.js +78 -82
  2047. package/dist/zoned/interval/intervalXorAllZoned.d.ts +14 -14
  2048. package/dist/zoned/interval/intervalXorAllZoned.js +61 -74
  2049. package/dist/zoned/interval/intervalXorZoned.d.ts +12 -12
  2050. package/dist/zoned/interval/intervalXorZoned.js +82 -88
  2051. package/dist/zoned/interval/intervalsOverlapZoned.d.ts +3 -3
  2052. package/dist/zoned/interval/intervalsOverlapZoned.js +64 -69
  2053. package/dist/zoned/interval/mergeIntervalsZoned.d.ts +14 -14
  2054. package/dist/zoned/interval/mergeIntervalsZoned.js +65 -77
  2055. package/dist/zoned/interval/splitIntervalByUnitZoned.d.ts +22 -21
  2056. package/dist/zoned/interval/splitIntervalByUnitZoned.js +93 -112
  2057. package/dist/zoned/interval/validate/index.d.ts +3 -2
  2058. package/dist/zoned/interval/validate/index.js +4 -2
  2059. package/dist/zoned/interval/validate/isValidCalendarZonedInterval.d.ts +3 -3
  2060. package/dist/zoned/interval/validate/isValidCalendarZonedInterval.js +47 -46
  2061. package/dist/zoned/interval/validate/isValidZonedInterval.d.ts +2 -2
  2062. package/dist/zoned/interval/validate/isValidZonedInterval.js +38 -37
  2063. package/dist/zoned/map/index.d.ts +3 -2
  2064. package/dist/zoned/map/index.js +4 -2
  2065. package/dist/zoned/map/mapZonedDatesInRange.d.ts +12 -10
  2066. package/dist/zoned/map/mapZonedDatesInRange.js +67 -87
  2067. package/dist/zoned/map/mapZonedHoursInDay.d.ts +2 -2
  2068. package/dist/zoned/map/mapZonedHoursInDay.js +37 -37
  2069. package/dist/zoned/parse/getZonedOffset.d.ts +2 -2
  2070. package/dist/zoned/parse/getZonedOffset.js +28 -27
  2071. package/dist/zoned/parse/getZonedOffsetAs.d.ts +7 -7
  2072. package/dist/zoned/parse/getZonedOffsetAs.js +41 -45
  2073. package/dist/zoned/parse/index.d.ts +21 -20
  2074. package/dist/zoned/parse/index.js +22 -20
  2075. package/dist/zoned/parse/parseDateFromZoned.d.ts +1 -1
  2076. package/dist/zoned/parse/parseDateFromZoned.js +24 -24
  2077. package/dist/zoned/parse/parseDateTimeFromZoned.d.ts +1 -1
  2078. package/dist/zoned/parse/parseDateTimeFromZoned.js +25 -24
  2079. package/dist/zoned/parse/parseDayFromZoned.d.ts +1 -1
  2080. package/dist/zoned/parse/parseDayFromZoned.js +24 -24
  2081. package/dist/zoned/parse/parseDayOfWeekFromZoned.d.ts +1 -1
  2082. package/dist/zoned/parse/parseDayOfWeekFromZoned.js +25 -25
  2083. package/dist/zoned/parse/parseHourFromZoned.d.ts +1 -1
  2084. package/dist/zoned/parse/parseHourFromZoned.js +24 -24
  2085. package/dist/zoned/parse/parseMicrosecondFromZoned.d.ts +1 -1
  2086. package/dist/zoned/parse/parseMicrosecondFromZoned.js +25 -25
  2087. package/dist/zoned/parse/parseMillisecondFromZoned.d.ts +1 -1
  2088. package/dist/zoned/parse/parseMillisecondFromZoned.js +24 -24
  2089. package/dist/zoned/parse/parseMinuteFromZoned.d.ts +1 -1
  2090. package/dist/zoned/parse/parseMinuteFromZoned.js +24 -24
  2091. package/dist/zoned/parse/parseMonthFromZoned.d.ts +1 -1
  2092. package/dist/zoned/parse/parseMonthFromZoned.js +24 -24
  2093. package/dist/zoned/parse/parseNanosecondFromZoned.d.ts +1 -1
  2094. package/dist/zoned/parse/parseNanosecondFromZoned.js +25 -25
  2095. package/dist/zoned/parse/parseRfc2822.d.ts +1 -1
  2096. package/dist/zoned/parse/parseRfc2822.js +67 -70
  2097. package/dist/zoned/parse/parseRfc3339.d.ts +1 -1
  2098. package/dist/zoned/parse/parseRfc3339.js +45 -46
  2099. package/dist/zoned/parse/parseSecondFromZoned.d.ts +1 -1
  2100. package/dist/zoned/parse/parseSecondFromZoned.js +24 -24
  2101. package/dist/zoned/parse/parseTimeFromZoned.d.ts +1 -1
  2102. package/dist/zoned/parse/parseTimeFromZoned.js +24 -24
  2103. package/dist/zoned/parse/parseTimeZoneFromZoned.d.ts +1 -1
  2104. package/dist/zoned/parse/parseTimeZoneFromZoned.js +24 -23
  2105. package/dist/zoned/parse/parseUnitFromZoned.d.ts +11 -11
  2106. package/dist/zoned/parse/parseUnitFromZoned.js +73 -93
  2107. package/dist/zoned/parse/parseWeekFromZoned.d.ts +10 -10
  2108. package/dist/zoned/parse/parseWeekFromZoned.js +44 -49
  2109. package/dist/zoned/parse/parseYearFromZoned.d.ts +1 -1
  2110. package/dist/zoned/parse/parseYearFromZoned.js +27 -26
  2111. package/dist/zoned/validate/hasDaylightSaving.d.ts +12 -12
  2112. package/dist/zoned/validate/hasDaylightSaving.js +60 -63
  2113. package/dist/zoned/validate/index.d.ts +8 -7
  2114. package/dist/zoned/validate/index.js +9 -7
  2115. package/dist/zoned/validate/isValidCalendarZonedDateTime.d.ts +15 -10
  2116. package/dist/zoned/validate/isValidCalendarZonedDateTime.js +12 -55
  2117. package/dist/zoned/validate/isValidRfc2822DateTime.d.ts +7 -2
  2118. package/dist/zoned/validate/isValidRfc2822DateTime.js +6 -33
  2119. package/dist/zoned/validate/isValidRfc3339DateTime.d.ts +7 -2
  2120. package/dist/zoned/validate/isValidRfc3339DateTime.js +6 -32
  2121. package/dist/zoned/validate/isValidTimeZone.d.ts +7 -2
  2122. package/dist/zoned/validate/isValidTimeZone.js +7 -49
  2123. package/dist/zoned/validate/isValidZonedDateTime.d.ts +14 -9
  2124. package/dist/zoned/validate/isValidZonedDateTime.js +14 -57
  2125. package/dist/zoned/validate/isValidZonedRange.d.ts +18 -18
  2126. package/dist/zoned/validate/isValidZonedRange.js +52 -65
  2127. package/package.json +134 -26
  2128. package/skills/gmt-arithmetic/SKILL.md +104 -64
  2129. package/skills/gmt-basics/SKILL.md +73 -19
  2130. package/skills/gmt-gnss/SKILL.md +92 -0
  2131. package/skills/gmt-integration/SKILL.md +99 -33
  2132. package/skills/gmt-intermodal/SKILL.md +191 -0
  2133. package/skills/gmt-timezone/SKILL.md +94 -259
  2134. package/skills/gmt-transport/SKILL.md +133 -0
  2135. package/skills/gmt-workforce/SKILL.md +84 -0
  2136. package/dist/duty/calculate/dutyDayFor.js +0 -71
  2137. package/dist/duty/calculate/dutyTotals.js +0 -41
  2138. package/dist/duty/calculate/dutyViolations.js +0 -65
  2139. package/dist/duty/calculate/evaluateDutyLog.js +0 -75
  2140. package/dist/duty/calculate/index.d.ts +0 -7
  2141. package/dist/duty/calculate/index.js +0 -7
  2142. package/dist/duty/calculate/longestRun.js +0 -54
  2143. package/dist/duty/calculate/qualifyingRestPairs.js +0 -58
  2144. package/dist/duty/calculate/qualifyingRests.js +0 -49
  2145. package/dist/duty/index.d.ts +0 -3
  2146. package/dist/duty/index.js +0 -4
  2147. package/dist/duty/validate/index.d.ts +0 -1
  2148. package/dist/duty/validate/index.js +0 -1
  2149. package/dist/duty/validate/isValidDutyLog.js +0 -34
  2150. package/dist/plain/validate/isLeapSecond.js +0 -40
@@ -1,86 +1,82 @@
1
1
  import { spanNs } from "./spanNs.js";
2
+
3
+ // src/span/calculate/spanMs.ts
2
4
  /** Nanoseconds in a millisecond. */
3
5
  const NANOSECONDS_PER_MILLISECOND = 1000000n;
4
6
  /**
5
- * The largest span, in nanoseconds, whose exact millisecond value a `number` still holds.
6
- *
7
- * Guarding here rather than on the truncated whole-millisecond part matters: a span of
8
- * `MAX_SAFE_INTEGER` milliseconds *plus* a fraction passes a whole-millisecond check and
9
- * then rounds up to 2^53 on recombination, returning an unsafe integer from a function
10
- * documented to return the sentinel past the safe range.
11
- */
7
+ * The largest span, in nanoseconds, whose exact millisecond value a `number` still holds.
8
+ *
9
+ * Guarding here rather than on the truncated whole-millisecond part matters: a span of
10
+ * `MAX_SAFE_INTEGER` milliseconds *plus* a fraction passes a whole-millisecond check and
11
+ * then rounds up to 2^53 on recombination, returning an unsafe integer from a function
12
+ * documented to return the sentinel past the safe range.
13
+ */
12
14
  const MAX_SAFE_NANOSECONDS = BigInt(Number.MAX_SAFE_INTEGER) * NANOSECONDS_PER_MILLISECOND;
13
15
  /**
14
- * Return the exact elapsed milliseconds between two ISO 8601 instant strings.
15
- *
16
- * The universal span primitive for profiling and observability. Fractional, like
17
- * `performance.now()` — a sub-millisecond span is reported as a fraction, not rounded away.
18
- *
19
- * - Signed: negative when `start` is after `end`, so `spanMs(b, a)` is exactly
20
- * `-spanMs(a, b)`.
21
- * - Measures **exact elapsed time**, never calendar distance. A wall-clock day containing a
22
- * DST transition is 23 or 25 hours (or 24.5, in `Australia/Lord_Howe`), and `spanMs`
23
- * reports the hours that actually elapsed. `spanWallClock` answers the calendar question;
24
- * conflating the two is the most common span bug there is.
25
- * - Accepts anything `toNanoseconds` does: the full RFC 9557 instant grammar, no leap
26
- * seconds; calendar and elective annotations are ignored, as `Temporal.Instant.from` ignores
27
- * them. An offset designator (`Z`, `±HH:MM`) is
28
- * required, optionally followed by a bracketed IANA zone — a bracket alone is not enough,
29
- * which is the one string shape `spanWallClock` accepts and these two do not. The
30
- * endpoints need not share a zone; an instant is an instant.
31
- * - **The offset fixes the instant; a bracketed zone only resolves a rounded one.** An offset
32
- * written to the minute that is the bracketed zone's sub-minute offset rounded
33
- * (`-00:45[Africa/Monrovia]`, for −00:44:30) names the instant the zone gives, as
34
- * `Temporal.ZonedDateTime.from` reads it, so a zoned string Temporal wrote is read back as
35
- * the instant it was written for, except a wall time repeated inside a sub-minute offset
36
- * change, which reads as its first pass (see `isValidInstant`). Otherwise the bracket is not
37
- * checked: a zone that does not exist, or that disagrees with the offset, changes nothing. `spanWallClock`, by
38
- * contrast, rejects a mismatched offset.
39
- * - Returns `null` on invalid input, not `0` — `0` is the span between an instant and itself.
40
- * `null`, not `NaN`, because that is GMT's sentinel for every number-returning function:
41
- * it is the one a caller already checks for, and the only one `strictNullChecks` forces
42
- * them to handle. A `NaN` would type as plain `number` and propagate silently through
43
- * arithmetic. `spanNs` and `spanWallClock` return `null` for the same reason.
44
- * - **Safe range.** Returns `null` when the exact span exceeds `Number.MAX_SAFE_INTEGER`
45
- * milliseconds (±9_007_199_254_740_991 ms, about ±285,000 years), which two instants at
46
- * opposite ends of `Temporal.Instant`'s range do. A sub-millisecond fraction counts
47
- * toward that ceiling, so any number returned is a safe integer or below. Use `spanNs`
48
- * past it — it carries the exact value as a `bigint`.
49
- * Sub-millisecond fidelity goes first, long before the ceiling: a double carries the
50
- * nanosecond digits exactly only while the span is under 2^53 ns, roughly 104 days.
51
- * - Leap seconds are not counted. UTC repeats a second rather than numbering a 61st one, so
52
- * a span across one is a second short of the physical elapsed time; against a smeared
53
- * clock (Google, AWS, Meta) the error is up to a second spread over the smear window.
54
- * Leap-second-exact spans need a TAI scale, which GMT does not yet ship.
55
- *
56
- * @param start ISO 8601 instant string the span is measured from
57
- * @param end ISO 8601 instant string the span is measured to
58
- * @returns exact elapsed milliseconds, negative when start is after end, or null on invalid input
59
- *
60
- * @example spanMs("2024-03-10T12:00:00Z", "2024-03-10T12:00:01Z") // 1000
61
- * @example spanMs("2024-03-10T12:00:01Z", "2024-03-10T12:00:00Z") // -1000
62
- * @example spanMs("2024-03-10T12:00:00Z", "2024-03-10T12:00:00Z") // 0
63
- * @example spanMs("2024-03-10T12:00:00Z", "2024-03-10T12:00:00.123456789Z") // 123.456789
64
- * @example spanMs("2024-03-09T12:00:00-05:00[America/New_York]", "2024-03-10T12:00:00-04:00[America/New_York]") // 82800000 — 23 hours, not 24
65
- * @example spanMs("2024-03-10T12:00:00+05:00[America/New_York]", "2024-03-10T12:00:00-04:00[America/New_York]") // 32400000 — offsets decide, the zone is not checked
66
- * @example spanMs("1960-01-01T01:04:30Z", "1960-01-01T00:20:00-00:45[Africa/Monrovia]") // 0 — the zone's −00:44:30, which `-00:45` rounds
67
- * @example spanMs("-271821-04-20T00:00:00Z", "+275760-09-13T00:00:00Z") // null — past the safe integer range, use spanNs
68
- * @example spanMs("2024-03-10T12:00:00Z", "invalid") // null
69
- */
70
- export function spanMs(start, end) {
71
- const nanoseconds = spanNs(start, end);
72
- if (nanoseconds === null) {
73
- return null;
74
- }
75
- if (nanoseconds > MAX_SAFE_NANOSECONDS ||
76
- nanoseconds < -MAX_SAFE_NANOSECONDS) {
77
- return null;
78
- }
79
- // Split rather than dividing the whole bigint through a double: Number(nanoseconds) is
80
- // already lossy past 2^53 ns (~104 days), which would corrupt the millisecond part too.
81
- // BigInt division truncates toward zero and `%` keeps the dividend's sign, so both halves
82
- // flip together and spanMs(b, a) === -spanMs(a, b) holds exactly.
83
- const milliseconds = nanoseconds / NANOSECONDS_PER_MILLISECOND;
84
- const remainder = nanoseconds % NANOSECONDS_PER_MILLISECOND;
85
- return Number(milliseconds) + Number(remainder) / 1e6;
16
+ * Return the exact elapsed milliseconds between two ISO 8601 instant strings.
17
+ *
18
+ * The universal span primitive for profiling and observability. Fractional, like
19
+ * `performance.now()` — a sub-millisecond span is reported as a fraction, not rounded away.
20
+ *
21
+ * - Signed: negative when `start` is after `end`, so `spanMs(b, a)` is exactly
22
+ * `-spanMs(a, b)`.
23
+ * - Measures **exact elapsed time**, never calendar distance. A wall-clock day containing a
24
+ * DST transition is 23 or 25 hours (or 24.5, in `Australia/Lord_Howe`), and `spanMs`
25
+ * reports the hours that actually elapsed. `spanWallClock` answers the calendar question;
26
+ * conflating the two is the most common span bug there is.
27
+ * - Accepts anything `toNanoseconds` does: the full RFC 9557 instant grammar, no leap
28
+ * seconds; calendar and elective annotations are ignored, as `Temporal.Instant.from` ignores
29
+ * them. An offset designator (`Z`, `±HH:MM`) is
30
+ * required, optionally followed by a bracketed IANA zone — a bracket alone is not enough,
31
+ * which is the one string shape `spanWallClock` accepts and these two do not. The
32
+ * endpoints need not share a zone; an instant is an instant.
33
+ * - **The offset fixes the instant; a bracketed zone only resolves a rounded one.** An offset
34
+ * written to the minute that is the bracketed zone's sub-minute offset rounded
35
+ * (`-00:45[Africa/Monrovia]`, for −00:44:30) names the instant the zone gives, as
36
+ * `Temporal.ZonedDateTime.from` reads it, so a zoned string Temporal wrote is read back as
37
+ * the instant it was written for, except a wall time repeated inside a sub-minute offset
38
+ * change, which reads as its first pass (see `isValidInstant`). Otherwise the bracket is not
39
+ * checked: a zone that does not exist, or that disagrees with the offset, changes nothing. `spanWallClock`, by
40
+ * contrast, rejects a mismatched offset.
41
+ * - Returns `null` on invalid input, not `0` — `0` is the span between an instant and itself.
42
+ * `null`, not `NaN`, because that is GMT's sentinel for every number-returning function:
43
+ * it is the one a caller already checks for, and the only one `strictNullChecks` forces
44
+ * them to handle. A `NaN` would type as plain `number` and propagate silently through
45
+ * arithmetic. `spanNs` and `spanWallClock` return `null` for the same reason.
46
+ * - **Safe range.** Returns `null` when the exact span exceeds `Number.MAX_SAFE_INTEGER`
47
+ * milliseconds (±9_007_199_254_740_991 ms, about ±285,000 years), which two instants at
48
+ * opposite ends of `Temporal.Instant`'s range do. A sub-millisecond fraction counts
49
+ * toward that ceiling, so any number returned is a safe integer or below. Use `spanNs`
50
+ * past it — it carries the exact value as a `bigint`.
51
+ * Sub-millisecond fidelity goes first, long before the ceiling: a double carries the
52
+ * nanosecond digits exactly only while the span is under 2^53 ns, roughly 104 days.
53
+ * - Leap seconds are not counted. UTC repeats a second rather than numbering a 61st one, so
54
+ * a span across one is a second short of the physical elapsed time; against a smeared
55
+ * clock (Google, AWS, Meta) the error is up to a second spread over the smear window.
56
+ * For a leap-second-exact span, convert both ends with `toTAI` or add
57
+ * `leapSecondsBetween(start, end)` seconds, both from `timescale/`.
58
+ *
59
+ * @param start ISO 8601 instant string the span is measured from
60
+ * @param end ISO 8601 instant string the span is measured to
61
+ * @returns exact elapsed milliseconds, negative when start is after end, or null on invalid input
62
+ *
63
+ * @example spanMs("2024-03-10T12:00:00Z", "2024-03-10T12:00:01Z") // 1000
64
+ * @example spanMs("2024-03-10T12:00:01Z", "2024-03-10T12:00:00Z") // -1000
65
+ * @example spanMs("2024-03-10T12:00:00Z", "2024-03-10T12:00:00Z") // 0
66
+ * @example spanMs("2024-03-10T12:00:00Z", "2024-03-10T12:00:00.123456789Z") // 123.456789
67
+ * @example spanMs("2024-03-30T12:00:00+00:00[Europe/London]", "2024-03-31T12:00:00+01:00[Europe/London]") // 82800000 — 23 hours, not 24
68
+ * @example spanMs("2024-03-10T12:00:00+05:00[Asia/Tokyo]", "2024-03-10T12:00:00-04:00[Asia/Tokyo]") // 32400000 — offsets decide, the zone is not checked
69
+ * @example spanMs("1960-01-01T01:04:30Z", "1960-01-01T00:20:00-00:45[Africa/Monrovia]") // 0 — the zone's −00:44:30, which `-00:45` rounds
70
+ * @example spanMs("-271821-04-20T00:00:00Z", "+275760-09-13T00:00:00Z") // null — past the safe integer range, use spanNs
71
+ * @example spanMs("2024-03-10T12:00:00Z", "invalid") // null
72
+ */
73
+ function spanMs(start, end) {
74
+ const nanoseconds = spanNs(start, end);
75
+ if (nanoseconds === null) return null;
76
+ if (nanoseconds > MAX_SAFE_NANOSECONDS || nanoseconds < -MAX_SAFE_NANOSECONDS) return null;
77
+ const milliseconds = nanoseconds / NANOSECONDS_PER_MILLISECOND;
78
+ const remainder = nanoseconds % NANOSECONDS_PER_MILLISECOND;
79
+ return Number(milliseconds) + Number(remainder) / 1e6;
86
80
  }
81
+
82
+ export { spanMs };
@@ -31,7 +31,8 @@
31
31
  * - Leap seconds are not counted. UTC repeats a second rather than numbering a 61st one, so
32
32
  * a span across one is a second short of the physical elapsed time; against a smeared
33
33
  * clock (Google, AWS, Meta) the error is up to a second spread over the smear window.
34
- * Leap-second-exact spans need a TAI scale, which GMT does not yet ship.
34
+ * For a leap-second-exact span, convert both ends with `toTAI` or add
35
+ * `leapSecondsBetween(start, end)` seconds, both from `timescale/`.
35
36
  *
36
37
  * @param start ISO 8601 instant string the span is measured from
37
38
  * @param end ISO 8601 instant string the span is measured to
@@ -41,9 +42,9 @@
41
42
  * @example spanNs("2024-03-10T12:00:01Z", "2024-03-10T12:00:00Z") // -1000000000n
42
43
  * @example spanNs("2024-03-10T12:00:00Z", "2024-03-10T12:00:00Z") // 0n
43
44
  * @example spanNs("2024-03-10T12:00:00.123456789Z", "2024-03-10T12:00:00.123456790Z") // 1n
44
- * @example spanNs("2024-03-10T07:00:00-05:00[America/New_York]", "2024-03-10T12:00:00Z") // 0n — same instant, different zones
45
- * @example spanNs("2024-03-10T12:00:00+05:00[America/New_York]", "2024-03-10T12:00:00-04:00[America/New_York]") // 32400000000000n — offsets decide, the zone is not checked
45
+ * @example spanNs("2024-03-10T07:00:00-05:00[America/Bogota]", "2024-03-10T12:00:00Z") // 0n — same instant, different zones
46
+ * @example spanNs("2024-03-10T12:00:00+05:00[Asia/Tokyo]", "2024-03-10T12:00:00-04:00[Asia/Tokyo]") // 32400000000000n — offsets decide, the zone is not checked
46
47
  * @example spanNs("1960-01-01T01:04:30Z", "1960-01-01T00:20:00-00:45[Africa/Monrovia]") // 0n — the zone's −00:44:30, which `-00:45` rounds
47
48
  * @example spanNs("2024-03-10T12:00:00Z", "invalid") // null
48
49
  */
49
- export declare function spanNs(start: string, end: string): bigint | null;
50
+ export declare function spanNs(start: string, end: string): bigint | null;
@@ -1,57 +1,60 @@
1
- import { parseInstantNanoseconds } from "../../internal/index.js";
1
+ import { parseInstantNanoseconds } from "../../internal/instantNanoseconds.js";
2
+
3
+ // src/span/calculate/spanNs.ts
2
4
  /**
3
- * Return the exact elapsed nanoseconds between two ISO 8601 instant strings.
4
- *
5
- * The precise form of `spanMs`, and the one to reach for past a `number`'s safe range.
6
- *
7
- * - Signed: negative when `start` is after `end`, so `spanNs(b, a)` is exactly
8
- * `-spanNs(a, b)`.
9
- * - Measures **exact elapsed time**, never calendar distance. Across a DST transition
10
- * "one day later" and "24 hours later" are different spans — `spanWallClock` answers
11
- * the calendar question.
12
- * - Accepts anything `toNanoseconds` does: the full RFC 9557 instant grammar, no leap
13
- * seconds; calendar and elective annotations are ignored, as `Temporal.Instant.from` ignores
14
- * them. An offset designator (`Z`, `±HH:MM`) is
15
- * required, optionally followed by a bracketed IANA zone — a bracket alone is not enough,
16
- * which is the one string shape `spanWallClock` accepts and these two do not. The
17
- * endpoints need not share a zone; an instant is an instant.
18
- * - **The offset fixes the instant; a bracketed zone only resolves a rounded one.** An offset
19
- * written to the minute that is the bracketed zone's sub-minute offset rounded
20
- * (`-00:45[Africa/Monrovia]`, for −00:44:30) names the instant the zone gives, as
21
- * `Temporal.ZonedDateTime.from` reads it, so a zoned string Temporal wrote is read back as
22
- * the instant it was written for, except a wall time repeated inside a sub-minute offset
23
- * change, which reads as its first pass (see `isValidInstant`). Otherwise the bracket is not
24
- * checked: a zone that does not exist, or that disagrees with the offset, changes nothing. `spanWallClock`, by
25
- * contrast, rejects a mismatched offset.
26
- * - Returns `null` on invalid input, not `0n` — `0n` is the span between an instant and
27
- * itself. This is why it does not simply subtract two `toNanoseconds` results, which
28
- * return `0n` for both the epoch and a rejected string.
29
- * - The result is a **duration**, not an instant: it ranges up to
30
- * ±17_280_000_000_000_000_000_000n, twice what `Temporal.Instant` can represent. Do not
31
- * feed it to `fromNanoseconds`.
32
- * - Leap seconds are not counted. UTC repeats a second rather than numbering a 61st one, so
33
- * a span across one is a second short of the physical elapsed time; against a smeared
34
- * clock (Google, AWS, Meta) the error is up to a second spread over the smear window.
35
- * Leap-second-exact spans need a TAI scale, which GMT does not yet ship.
36
- *
37
- * @param start ISO 8601 instant string the span is measured from
38
- * @param end ISO 8601 instant string the span is measured to
39
- * @returns exact elapsed nanoseconds as a bigint, negative when start is after end, or null on invalid input
40
- *
41
- * @example spanNs("2024-03-10T12:00:00Z", "2024-03-10T12:00:01Z") // 1000000000n
42
- * @example spanNs("2024-03-10T12:00:01Z", "2024-03-10T12:00:00Z") // -1000000000n
43
- * @example spanNs("2024-03-10T12:00:00Z", "2024-03-10T12:00:00Z") // 0n
44
- * @example spanNs("2024-03-10T12:00:00.123456789Z", "2024-03-10T12:00:00.123456790Z") // 1n
45
- * @example spanNs("2024-03-10T07:00:00-05:00[America/New_York]", "2024-03-10T12:00:00Z") // 0n — same instant, different zones
46
- * @example spanNs("2024-03-10T12:00:00+05:00[America/New_York]", "2024-03-10T12:00:00-04:00[America/New_York]") // 32400000000000n — offsets decide, the zone is not checked
47
- * @example spanNs("1960-01-01T01:04:30Z", "1960-01-01T00:20:00-00:45[Africa/Monrovia]") // 0n — the zone's −00:44:30, which `-00:45` rounds
48
- * @example spanNs("2024-03-10T12:00:00Z", "invalid") // null
49
- */
50
- export function spanNs(start, end) {
51
- const startNanoseconds = parseInstantNanoseconds(start);
52
- const endNanoseconds = parseInstantNanoseconds(end);
53
- if (startNanoseconds === null || endNanoseconds === null) {
54
- return null;
55
- }
56
- return endNanoseconds - startNanoseconds;
5
+ * Return the exact elapsed nanoseconds between two ISO 8601 instant strings.
6
+ *
7
+ * The precise form of `spanMs`, and the one to reach for past a `number`'s safe range.
8
+ *
9
+ * - Signed: negative when `start` is after `end`, so `spanNs(b, a)` is exactly
10
+ * `-spanNs(a, b)`.
11
+ * - Measures **exact elapsed time**, never calendar distance. Across a DST transition
12
+ * "one day later" and "24 hours later" are different spans — `spanWallClock` answers
13
+ * the calendar question.
14
+ * - Accepts anything `toNanoseconds` does: the full RFC 9557 instant grammar, no leap
15
+ * seconds; calendar and elective annotations are ignored, as `Temporal.Instant.from` ignores
16
+ * them. An offset designator (`Z`, `±HH:MM`) is
17
+ * required, optionally followed by a bracketed IANA zone — a bracket alone is not enough,
18
+ * which is the one string shape `spanWallClock` accepts and these two do not. The
19
+ * endpoints need not share a zone; an instant is an instant.
20
+ * - **The offset fixes the instant; a bracketed zone only resolves a rounded one.** An offset
21
+ * written to the minute that is the bracketed zone's sub-minute offset rounded
22
+ * (`-00:45[Africa/Monrovia]`, for −00:44:30) names the instant the zone gives, as
23
+ * `Temporal.ZonedDateTime.from` reads it, so a zoned string Temporal wrote is read back as
24
+ * the instant it was written for, except a wall time repeated inside a sub-minute offset
25
+ * change, which reads as its first pass (see `isValidInstant`). Otherwise the bracket is not
26
+ * checked: a zone that does not exist, or that disagrees with the offset, changes nothing. `spanWallClock`, by
27
+ * contrast, rejects a mismatched offset.
28
+ * - Returns `null` on invalid input, not `0n` — `0n` is the span between an instant and
29
+ * itself. This is why it does not simply subtract two `toNanoseconds` results, which
30
+ * return `0n` for both the epoch and a rejected string.
31
+ * - The result is a **duration**, not an instant: it ranges up to
32
+ * ±17_280_000_000_000_000_000_000n, twice what `Temporal.Instant` can represent. Do not
33
+ * feed it to `fromNanoseconds`.
34
+ * - Leap seconds are not counted. UTC repeats a second rather than numbering a 61st one, so
35
+ * a span across one is a second short of the physical elapsed time; against a smeared
36
+ * clock (Google, AWS, Meta) the error is up to a second spread over the smear window.
37
+ * For a leap-second-exact span, convert both ends with `toTAI` or add
38
+ * `leapSecondsBetween(start, end)` seconds, both from `timescale/`.
39
+ *
40
+ * @param start ISO 8601 instant string the span is measured from
41
+ * @param end ISO 8601 instant string the span is measured to
42
+ * @returns exact elapsed nanoseconds as a bigint, negative when start is after end, or null on invalid input
43
+ *
44
+ * @example spanNs("2024-03-10T12:00:00Z", "2024-03-10T12:00:01Z") // 1000000000n
45
+ * @example spanNs("2024-03-10T12:00:01Z", "2024-03-10T12:00:00Z") // -1000000000n
46
+ * @example spanNs("2024-03-10T12:00:00Z", "2024-03-10T12:00:00Z") // 0n
47
+ * @example spanNs("2024-03-10T12:00:00.123456789Z", "2024-03-10T12:00:00.123456790Z") // 1n
48
+ * @example spanNs("2024-03-10T07:00:00-05:00[America/Bogota]", "2024-03-10T12:00:00Z") // 0n — same instant, different zones
49
+ * @example spanNs("2024-03-10T12:00:00+05:00[Asia/Tokyo]", "2024-03-10T12:00:00-04:00[Asia/Tokyo]") // 32400000000000n — offsets decide, the zone is not checked
50
+ * @example spanNs("1960-01-01T01:04:30Z", "1960-01-01T00:20:00-00:45[Africa/Monrovia]") // 0n — the zone's −00:44:30, which `-00:45` rounds
51
+ * @example spanNs("2024-03-10T12:00:00Z", "invalid") // null
52
+ */
53
+ function spanNs(start, end) {
54
+ const startNanoseconds = parseInstantNanoseconds(start);
55
+ const endNanoseconds = parseInstantNanoseconds(end);
56
+ if (startNanoseconds === null || endNanoseconds === null) return null;
57
+ return endNanoseconds - startNanoseconds;
57
58
  }
59
+
60
+ export { spanNs };
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Return the exact elapsed seconds between two ISO 8601 instant strings.
3
+ *
4
+ * The same contract as `spanMs`, in seconds: signed, fractional and unrounded.
5
+ *
6
+ * - Signed: negative when `start` is after `end`, so `spanSeconds(b, a)` is exactly
7
+ * `-spanSeconds(a, b)`.
8
+ * - Measures **exact elapsed time**, never calendar distance, as `spanMs` does. A wall-clock
9
+ * day containing a DST transition is 23 or 25 hours, and the hours that elapsed are reported.
10
+ * `spanWallClock` answers the calendar question.
11
+ * - Fractional and unrounded. For a wait that must not fall short, write `Math.ceil(n)`.
12
+ * - Accepts the instant strings `spanMs` accepts: an offset designator (`Z`, `±HH:MM`) is
13
+ * required, optionally followed by a bracketed IANA zone.
14
+ * - Returns `null` on invalid input, not `0`, which is the span between an instant and itself.
15
+ * - Needs no safe-range guard: the widest possible span, 17_280_000_000_000 seconds, is well
16
+ * inside 2^53.
17
+ * - Leap seconds are not counted (RFC 7519 section 2), as in `spanMs`.
18
+ * - For the seconds left until a stored moment, use `secondsUntilHttpDate` or
19
+ * `secondsUntilUnix`.
20
+ *
21
+ * @param start ISO 8601 instant string the span is measured from
22
+ * @param end ISO 8601 instant string the span is measured to
23
+ * @returns exact elapsed seconds, negative when start is after end, or null on invalid input
24
+ *
25
+ * @example spanSeconds("2027-06-15T12:00:00Z", "2027-06-15T12:01:30Z") // 90
26
+ * @example spanSeconds("2027-06-15T12:01:30Z", "2027-06-15T12:00:00Z") // -90
27
+ * @example spanSeconds("2027-06-15T12:00:00Z", "2027-06-15T12:00:00.500Z") // 0.5
28
+ * @example spanSeconds("2027-06-15T12:00:00Z", "2027-06-15T12:00:00Z") // 0
29
+ * @example spanSeconds("2026-03-28T12:00:00+01:00[Europe/Paris]", "2026-03-29T12:00:00+02:00[Europe/Paris]") // 82800 — 23 hours, not 24
30
+ * @example spanSeconds("2027-06-15T12:00:00Z", "soon") // null
31
+ */
32
+ export declare function spanSeconds(start: string, end: string): number | null;
@@ -0,0 +1,45 @@
1
+ import { spanNs } from "./spanNs.js";
2
+
3
+ // src/span/calculate/spanSeconds.ts
4
+ /** Nanoseconds in a second. */
5
+ const NANOSECONDS_PER_SECOND = 1000000000n;
6
+ /**
7
+ * Return the exact elapsed seconds between two ISO 8601 instant strings.
8
+ *
9
+ * The same contract as `spanMs`, in seconds: signed, fractional and unrounded.
10
+ *
11
+ * - Signed: negative when `start` is after `end`, so `spanSeconds(b, a)` is exactly
12
+ * `-spanSeconds(a, b)`.
13
+ * - Measures **exact elapsed time**, never calendar distance, as `spanMs` does. A wall-clock
14
+ * day containing a DST transition is 23 or 25 hours, and the hours that elapsed are reported.
15
+ * `spanWallClock` answers the calendar question.
16
+ * - Fractional and unrounded. For a wait that must not fall short, write `Math.ceil(n)`.
17
+ * - Accepts the instant strings `spanMs` accepts: an offset designator (`Z`, `±HH:MM`) is
18
+ * required, optionally followed by a bracketed IANA zone.
19
+ * - Returns `null` on invalid input, not `0`, which is the span between an instant and itself.
20
+ * - Needs no safe-range guard: the widest possible span, 17_280_000_000_000 seconds, is well
21
+ * inside 2^53.
22
+ * - Leap seconds are not counted (RFC 7519 section 2), as in `spanMs`.
23
+ * - For the seconds left until a stored moment, use `secondsUntilHttpDate` or
24
+ * `secondsUntilUnix`.
25
+ *
26
+ * @param start ISO 8601 instant string the span is measured from
27
+ * @param end ISO 8601 instant string the span is measured to
28
+ * @returns exact elapsed seconds, negative when start is after end, or null on invalid input
29
+ *
30
+ * @example spanSeconds("2027-06-15T12:00:00Z", "2027-06-15T12:01:30Z") // 90
31
+ * @example spanSeconds("2027-06-15T12:01:30Z", "2027-06-15T12:00:00Z") // -90
32
+ * @example spanSeconds("2027-06-15T12:00:00Z", "2027-06-15T12:00:00.500Z") // 0.5
33
+ * @example spanSeconds("2027-06-15T12:00:00Z", "2027-06-15T12:00:00Z") // 0
34
+ * @example spanSeconds("2026-03-28T12:00:00+01:00[Europe/Paris]", "2026-03-29T12:00:00+02:00[Europe/Paris]") // 82800 — 23 hours, not 24
35
+ * @example spanSeconds("2027-06-15T12:00:00Z", "soon") // null
36
+ */
37
+ function spanSeconds(start, end) {
38
+ const nanoseconds = spanNs(start, end);
39
+ if (nanoseconds === null) return null;
40
+ const seconds = nanoseconds / NANOSECONDS_PER_SECOND;
41
+ const remainder = nanoseconds % NANOSECONDS_PER_SECOND;
42
+ return Number(seconds) + Number(remainder) / 1e9;
43
+ }
44
+
45
+ export { spanSeconds };
@@ -28,8 +28,8 @@ export type WallClockSpanUnit = "days" | "hours" | "day" | "hour";
28
28
  * The wall clock is read straight off the string with `Temporal.PlainDateTime.from`. Going
29
29
  * via `ZonedDateTime` would be a local → instant → local round trip, and that round trip is
30
30
  * lossy at exactly the DST edges this function exists to get right: an offset-less
31
- * `"2024-03-10T02:30:00[America/New_York]"` names a wall time that never occurred, and
32
- * Temporal's default `compatible` disambiguation would silently advance it to `03:30`,
31
+ * `"2024-03-31T01:30:00[Europe/London]"` names a wall time that never occurred, and
32
+ * Temporal's default `compatible` disambiguation would silently advance it to `02:30`,
33
33
  * turning a 24-hour answer into 23. A nonexistent or ambiguous local time is measured as
34
34
  * written instead — for a clock-face question, the digits in the string *are* the answer.
35
35
  * - Requires a bracketed IANA time zone on both endpoints, as `isValidZonedDateTime` does —
@@ -38,8 +38,8 @@ export type WallClockSpanUnit = "days" | "hours" | "day" | "hour";
38
38
  * `[u-ca=...]` calendar annotations are rejected; `days` and `hours` mean the same thing in
39
39
  * every calendar system, so the annotation would change nothing.
40
40
  * - The endpoints need not share a zone. When they differ, this is the distance between two
41
- * local wall clocks — a flight leaving New York at 23:00 and landing in Berlin at 11:00 the
42
- * next local day is 12 wall-clock hours, and 7 elapsed hours by `spanMs`.
41
+ * local wall clocks — a flight leaving São Paulo at 23:00 and landing in Berlin at 15:00 the
42
+ * next local day is 16 wall-clock hours, and 12 elapsed hours by `spanMs`.
43
43
  * - Returns `null` on invalid input, not `0` — `0` is the span between a wall time and itself.
44
44
  *
45
45
  * @param start zoned ISO 8601 datetime string the span is measured from
@@ -47,14 +47,14 @@ export type WallClockSpanUnit = "days" | "hours" | "day" | "hour";
47
47
  * @param unit "days" or "hours" (or the singular "day" or "hour") of wall-clock distance
48
48
  * @returns whole wall-clock units, negative when start is after end, or null on invalid input
49
49
  *
50
- * @example spanWallClock("2024-03-09T12:00:00-05:00[America/New_York]", "2024-03-10T12:00:00-04:00[America/New_York]", "hours") // 24 — spanMs reports 82800000 (23 hours)
51
- * @example spanWallClock("2024-11-02T12:00:00-04:00[America/New_York]", "2024-11-03T12:00:00-05:00[America/New_York]", "days") // 1 — spanMs reports 90000000 (25 hours)
52
- * @example spanWallClock("2024-03-01T12:00:00-05:00[America/New_York]", "2024-03-02T18:00:00-05:00[America/New_York]", "days") // 1 — truncated toward zero
53
- * @example spanWallClock("2024-03-02T18:00:00-05:00[America/New_York]", "2024-03-01T12:00:00-05:00[America/New_York]", "hours") // -30
54
- * @example spanWallClock("2024-03-10T23:00:00-04:00[America/New_York]", "2024-03-11T11:00:00+01:00[Europe/Berlin]", "hours") // 12 — each endpoint's own wall clock
55
- * @example spanWallClock("2024-03-10T02:30:00[America/New_York]", "2024-03-11T02:30:00[America/New_York]", "hours") // 24 — a wall time that never occurred is measured as written
56
- * @example spanWallClock("2024-03-01T12:00:00-05:00[America/New_York]", "2024-03-02T12:00:00-05:00[America/New_York]", "day") // 1 — singular unit name
50
+ * @example spanWallClock("2024-03-30T12:00:00+00:00[Europe/London]", "2024-03-31T12:00:00+01:00[Europe/London]", "hours") // 24 — spanMs reports 82800000 (23 hours)
51
+ * @example spanWallClock("2024-04-06T12:00:00+11:00[Australia/Sydney]", "2024-04-07T12:00:00+10:00[Australia/Sydney]", "days") // 1 — spanMs reports 90000000 (25 hours)
52
+ * @example spanWallClock("2024-03-01T12:00:00+05:30[Asia/Kolkata]", "2024-03-02T18:00:00+05:30[Asia/Kolkata]", "days") // 1 — truncated toward zero
53
+ * @example spanWallClock("2024-03-02T18:00:00+05:30[Asia/Kolkata]", "2024-03-01T12:00:00+05:30[Asia/Kolkata]", "hours") // -30
54
+ * @example spanWallClock("2024-03-10T23:00:00-03:00[America/Sao_Paulo]", "2024-03-11T15:00:00+01:00[Europe/Berlin]", "hours") // 16 — each endpoint's own wall clock
55
+ * @example spanWallClock("2024-03-31T01:30:00[Europe/London]", "2024-04-01T01:30:00[Europe/London]", "hours") // 24 — a wall time that never occurred is measured as written
56
+ * @example spanWallClock("2024-03-01T12:00:00+02:00[Africa/Johannesburg]", "2024-03-02T12:00:00+02:00[Africa/Johannesburg]", "day") // 1 — singular unit name
57
57
  * @example spanWallClock("2024-03-10T12:00:00Z", "2024-03-11T12:00:00Z", "days") // null — no bracketed time zone
58
- * @example spanWallClock("2024-03-01T12:00:00-05:00[America/New_York]", "2024-03-02T12:00:00-05:00[America/New_York]", "minutes") // null
58
+ * @example spanWallClock("2024-03-01T12:00:00+02:00[Africa/Johannesburg]", "2024-03-02T12:00:00+02:00[Africa/Johannesburg]", "minutes") // null
59
59
  */
60
- export declare function spanWallClock(start: string, end: string, unit: WallClockSpanUnit): number | null;
60
+ export declare function spanWallClock(start: string, end: string, unit: WallClockSpanUnit): number | null;
@@ -1,80 +1,73 @@
1
- import { Temporal } from "@js-temporal/polyfill";
2
- import { isValidZonedDateTime } from "../../zoned/validate/index.js";
1
+ import { Temporal } from "../../internal/temporal.js";
2
+ import { isValidZonedDateTime } from "../../zoned/validate/isValidZonedDateTime.js";
3
+
4
+ // src/span/calculate/spanWallClock.ts
3
5
  const WALL_CLOCK_SPAN_UNITS = {
4
- days: "day",
5
- hours: "hour",
6
- day: "day",
7
- hour: "hour",
6
+ days: "day",
7
+ hours: "hour",
8
+ day: "day",
9
+ hour: "hour"
8
10
  };
9
11
  /**
10
- * Return the wall-clock distance between two zoned datetime strings — calendar time, not
11
- * elapsed time.
12
- *
13
- * The counterpart to `spanMs`. Both are correct answers to different questions, and
14
- * conflating them is the most common span bug there is: across a DST transition "one day
15
- * later" and "24 hours later" are not the same moment.
16
- *
17
- * - Reads each endpoint's own local wall clock and measures between them, so a calendar day
18
- * is 1 day and 24 hours in every zone, including one whose offset shifted in between.
19
- * `spanMs` over the same pair reports the 23, 24.5 or 25 hours that actually elapsed.
20
- * - Truncates toward zero, so the result is a whole count and `spanWallClock(b, a, unit)` is
21
- * `-spanWallClock(a, b, unit)`. Noon Friday to 18:00 Saturday is 1 day, or 30 hours — ask
22
- * for `hours` when the remainder matters.
23
- * - **Not a count of boundaries crossed.** 23:00 to 01:00 the next calendar day is `0` days,
24
- * not `1`; that question is about local midnights, and is `startOfZoned`'s to answer.
25
- * - **No disambiguation policy applies, because no local time is converted to an instant.**
26
- * The wall clock is read straight off the string with `Temporal.PlainDateTime.from`. Going
27
- * via `ZonedDateTime` would be a local → instant → local round trip, and that round trip is
28
- * lossy at exactly the DST edges this function exists to get right: an offset-less
29
- * `"2024-03-10T02:30:00[America/New_York]"` names a wall time that never occurred, and
30
- * Temporal's default `compatible` disambiguation would silently advance it to `03:30`,
31
- * turning a 24-hour answer into 23. A nonexistent or ambiguous local time is measured as
32
- * written instead — for a clock-face question, the digits in the string *are* the answer.
33
- * - Requires a bracketed IANA time zone on both endpoints, as `isValidZonedDateTime` does —
34
- * an instant string (`Z`) or a bare offset carries no zone whose wall clock could shift.
35
- * The offset is optional, but a present one must match the zone. Leap seconds and
36
- * `[u-ca=...]` calendar annotations are rejected; `days` and `hours` mean the same thing in
37
- * every calendar system, so the annotation would change nothing.
38
- * - The endpoints need not share a zone. When they differ, this is the distance between two
39
- * local wall clocks — a flight leaving New York at 23:00 and landing in Berlin at 11:00 the
40
- * next local day is 12 wall-clock hours, and 7 elapsed hours by `spanMs`.
41
- * - Returns `null` on invalid input, not `0` — `0` is the span between a wall time and itself.
42
- *
43
- * @param start zoned ISO 8601 datetime string the span is measured from
44
- * @param end zoned ISO 8601 datetime string the span is measured to
45
- * @param unit "days" or "hours" (or the singular "day" or "hour") of wall-clock distance
46
- * @returns whole wall-clock units, negative when start is after end, or null on invalid input
47
- *
48
- * @example spanWallClock("2024-03-09T12:00:00-05:00[America/New_York]", "2024-03-10T12:00:00-04:00[America/New_York]", "hours") // 24 — spanMs reports 82800000 (23 hours)
49
- * @example spanWallClock("2024-11-02T12:00:00-04:00[America/New_York]", "2024-11-03T12:00:00-05:00[America/New_York]", "days") // 1 — spanMs reports 90000000 (25 hours)
50
- * @example spanWallClock("2024-03-01T12:00:00-05:00[America/New_York]", "2024-03-02T18:00:00-05:00[America/New_York]", "days") // 1 — truncated toward zero
51
- * @example spanWallClock("2024-03-02T18:00:00-05:00[America/New_York]", "2024-03-01T12:00:00-05:00[America/New_York]", "hours") // -30
52
- * @example spanWallClock("2024-03-10T23:00:00-04:00[America/New_York]", "2024-03-11T11:00:00+01:00[Europe/Berlin]", "hours") // 12 — each endpoint's own wall clock
53
- * @example spanWallClock("2024-03-10T02:30:00[America/New_York]", "2024-03-11T02:30:00[America/New_York]", "hours") // 24 — a wall time that never occurred is measured as written
54
- * @example spanWallClock("2024-03-01T12:00:00-05:00[America/New_York]", "2024-03-02T12:00:00-05:00[America/New_York]", "day") // 1 — singular unit name
55
- * @example spanWallClock("2024-03-10T12:00:00Z", "2024-03-11T12:00:00Z", "days") // null — no bracketed time zone
56
- * @example spanWallClock("2024-03-01T12:00:00-05:00[America/New_York]", "2024-03-02T12:00:00-05:00[America/New_York]", "minutes") // null
57
- */
58
- export function spanWallClock(start, end, unit) {
59
- if (typeof unit !== "string") {
60
- return null;
61
- }
62
- if (!Object.hasOwn(WALL_CLOCK_SPAN_UNITS, unit) ||
63
- !isValidZonedDateTime(start) ||
64
- !isValidZonedDateTime(end)) {
65
- return null;
66
- }
67
- try {
68
- const startWallClock = Temporal.PlainDateTime.from(start);
69
- const endWallClock = Temporal.PlainDateTime.from(end);
70
- const duration = startWallClock.until(endWallClock, {
71
- largestUnit: WALL_CLOCK_SPAN_UNITS[unit],
72
- });
73
- return WALL_CLOCK_SPAN_UNITS[unit] === "day"
74
- ? duration.days
75
- : duration.hours;
76
- }
77
- catch {
78
- return null;
79
- }
12
+ * Return the wall-clock distance between two zoned datetime strings — calendar time, not
13
+ * elapsed time.
14
+ *
15
+ * The counterpart to `spanMs`. Both are correct answers to different questions, and
16
+ * conflating them is the most common span bug there is: across a DST transition "one day
17
+ * later" and "24 hours later" are not the same moment.
18
+ *
19
+ * - Reads each endpoint's own local wall clock and measures between them, so a calendar day
20
+ * is 1 day and 24 hours in every zone, including one whose offset shifted in between.
21
+ * `spanMs` over the same pair reports the 23, 24.5 or 25 hours that actually elapsed.
22
+ * - Truncates toward zero, so the result is a whole count and `spanWallClock(b, a, unit)` is
23
+ * `-spanWallClock(a, b, unit)`. Noon Friday to 18:00 Saturday is 1 day, or 30 hours — ask
24
+ * for `hours` when the remainder matters.
25
+ * - **Not a count of boundaries crossed.** 23:00 to 01:00 the next calendar day is `0` days,
26
+ * not `1`; that question is about local midnights, and is `startOfZoned`'s to answer.
27
+ * - **No disambiguation policy applies, because no local time is converted to an instant.**
28
+ * The wall clock is read straight off the string with `Temporal.PlainDateTime.from`. Going
29
+ * via `ZonedDateTime` would be a local → instant → local round trip, and that round trip is
30
+ * lossy at exactly the DST edges this function exists to get right: an offset-less
31
+ * `"2024-03-31T01:30:00[Europe/London]"` names a wall time that never occurred, and
32
+ * Temporal's default `compatible` disambiguation would silently advance it to `02:30`,
33
+ * turning a 24-hour answer into 23. A nonexistent or ambiguous local time is measured as
34
+ * written instead — for a clock-face question, the digits in the string *are* the answer.
35
+ * - Requires a bracketed IANA time zone on both endpoints, as `isValidZonedDateTime` does —
36
+ * an instant string (`Z`) or a bare offset carries no zone whose wall clock could shift.
37
+ * The offset is optional, but a present one must match the zone. Leap seconds and
38
+ * `[u-ca=...]` calendar annotations are rejected; `days` and `hours` mean the same thing in
39
+ * every calendar system, so the annotation would change nothing.
40
+ * - The endpoints need not share a zone. When they differ, this is the distance between two
41
+ * local wall clocks — a flight leaving São Paulo at 23:00 and landing in Berlin at 15:00 the
42
+ * next local day is 16 wall-clock hours, and 12 elapsed hours by `spanMs`.
43
+ * - Returns `null` on invalid input, not `0` — `0` is the span between a wall time and itself.
44
+ *
45
+ * @param start zoned ISO 8601 datetime string the span is measured from
46
+ * @param end zoned ISO 8601 datetime string the span is measured to
47
+ * @param unit "days" or "hours" (or the singular "day" or "hour") of wall-clock distance
48
+ * @returns whole wall-clock units, negative when start is after end, or null on invalid input
49
+ *
50
+ * @example spanWallClock("2024-03-30T12:00:00+00:00[Europe/London]", "2024-03-31T12:00:00+01:00[Europe/London]", "hours") // 24 — spanMs reports 82800000 (23 hours)
51
+ * @example spanWallClock("2024-04-06T12:00:00+11:00[Australia/Sydney]", "2024-04-07T12:00:00+10:00[Australia/Sydney]", "days") // 1 — spanMs reports 90000000 (25 hours)
52
+ * @example spanWallClock("2024-03-01T12:00:00+05:30[Asia/Kolkata]", "2024-03-02T18:00:00+05:30[Asia/Kolkata]", "days") // 1 — truncated toward zero
53
+ * @example spanWallClock("2024-03-02T18:00:00+05:30[Asia/Kolkata]", "2024-03-01T12:00:00+05:30[Asia/Kolkata]", "hours") // -30
54
+ * @example spanWallClock("2024-03-10T23:00:00-03:00[America/Sao_Paulo]", "2024-03-11T15:00:00+01:00[Europe/Berlin]", "hours") // 16 — each endpoint's own wall clock
55
+ * @example spanWallClock("2024-03-31T01:30:00[Europe/London]", "2024-04-01T01:30:00[Europe/London]", "hours") // 24 — a wall time that never occurred is measured as written
56
+ * @example spanWallClock("2024-03-01T12:00:00+02:00[Africa/Johannesburg]", "2024-03-02T12:00:00+02:00[Africa/Johannesburg]", "day") // 1 — singular unit name
57
+ * @example spanWallClock("2024-03-10T12:00:00Z", "2024-03-11T12:00:00Z", "days") // null — no bracketed time zone
58
+ * @example spanWallClock("2024-03-01T12:00:00+02:00[Africa/Johannesburg]", "2024-03-02T12:00:00+02:00[Africa/Johannesburg]", "minutes") // null
59
+ */
60
+ function spanWallClock(start, end, unit) {
61
+ if (typeof unit !== "string") return null;
62
+ if (!Object.hasOwn(WALL_CLOCK_SPAN_UNITS, unit) || !isValidZonedDateTime(start) || !isValidZonedDateTime(end)) return null;
63
+ try {
64
+ const startWallClock = Temporal.PlainDateTime.from(start);
65
+ const endWallClock = Temporal.PlainDateTime.from(end);
66
+ const duration = startWallClock.until(endWallClock, { largestUnit: WALL_CLOCK_SPAN_UNITS[unit] });
67
+ return WALL_CLOCK_SPAN_UNITS[unit] === "day" ? duration.days : duration.hours;
68
+ } catch {
69
+ return null;
70
+ }
80
71
  }
72
+
73
+ export { spanWallClock };