@northguild/gmt 1.20.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 (2133) hide show
  1. package/README.md +64 -25
  2. package/dist/calendar/business/businessDaysBetween.d.ts +3 -2
  3. package/dist/calendar/business/businessDaysBetween.js +56 -61
  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 +3 -2
  7. package/dist/calendar/business/mergeCalendars.js +56 -64
  8. package/dist/calendar/business/nextBusinessDay.d.ts +3 -2
  9. package/dist/calendar/business/nextBusinessDay.js +37 -36
  10. package/dist/calendar/business/previousBusinessDay.d.ts +3 -2
  11. package/dist/calendar/business/previousBusinessDay.js +37 -36
  12. package/dist/calendar/business/rollDate.d.ts +4 -2
  13. package/dist/calendar/business/rollDate.js +74 -78
  14. package/dist/calendar/calculate/bucketRange.d.ts +3 -2
  15. package/dist/calendar/calculate/bucketRange.js +104 -118
  16. package/dist/calendar/calculate/floorToZone.d.ts +4 -3
  17. package/dist/calendar/calculate/floorToZone.js +68 -68
  18. package/dist/calendar/calculate/getFiscalPeriod.d.ts +16 -15
  19. package/dist/calendar/calculate/getFiscalPeriod.js +104 -112
  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 +20 -19
  25. package/dist/calendar/calculate/getQuarter.js +70 -81
  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 +22 -20
  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 +14 -12
  33. package/dist/calendar/hours/isOpenAt.js +47 -48
  34. package/dist/calendar/hours/nextCloseAt.d.ts +22 -20
  35. package/dist/calendar/hours/nextCloseAt.js +52 -55
  36. package/dist/calendar/hours/nextOpenAt.d.ts +22 -20
  37. package/dist/calendar/hours/nextOpenAt.js +48 -51
  38. package/dist/calendar/hours/operatingIntervals.d.ts +14 -11
  39. package/dist/calendar/hours/operatingIntervals.js +52 -53
  40. package/dist/calendar/hours/operatingTimeBetween.d.ts +13 -11
  41. package/dist/calendar/hours/operatingTimeBetween.js +53 -50
  42. package/dist/calendar/hours/recurringWindows.d.ts +14 -11
  43. package/dist/calendar/hours/recurringWindows.js +81 -85
  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 -7
  59. package/dist/calendar/validate/index.js +10 -7
  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 +3 -2
  63. package/dist/calendar/validate/isValidFiscalCalendar.js +33 -38
  64. package/dist/calendar/validate/isValidFiscalExtraWeek.d.ts +3 -2
  65. package/dist/calendar/validate/isValidFiscalExtraWeek.js +22 -21
  66. package/dist/calendar/validate/isValidFiscalPattern.d.ts +3 -2
  67. package/dist/calendar/validate/isValidFiscalPattern.js +28 -27
  68. package/dist/calendar/validate/isValidFiscalYearLabel.d.ts +3 -2
  69. package/dist/calendar/validate/isValidFiscalYearLabel.js +23 -22
  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 +31 -27
  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 +29 -28
  78. package/dist/duration/calculate/addDuration.d.ts +1 -1
  79. package/dist/duration/calculate/addDuration.js +29 -28
  80. package/dist/duration/calculate/durationFromUnits.d.ts +3 -2
  81. package/dist/duration/calculate/durationFromUnits.js +62 -64
  82. package/dist/duration/calculate/getDurationSign.d.ts +1 -1
  83. package/dist/duration/calculate/getDurationSign.js +31 -30
  84. package/dist/duration/calculate/getDurationUnit.d.ts +3 -2
  85. package/dist/duration/calculate/getDurationUnit.js +44 -43
  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 +29 -28
  90. package/dist/duration/calculate/subtractDuration.d.ts +1 -1
  91. package/dist/duration/calculate/subtractDuration.js +30 -29
  92. package/dist/duration/calculate/totalDuration.d.ts +17 -12
  93. package/dist/duration/calculate/totalDuration.js +79 -76
  94. package/dist/duration/calculate/totalUnits.d.ts +4 -2
  95. package/dist/duration/calculate/totalUnits.js +66 -67
  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 +13 -12
  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 +16 -16
  105. package/dist/duration/format/formatDuration.js +93 -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 +43 -42
  115. package/dist/duration/normalize/normalizeDuration.js +64 -64
  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 +24 -24
  119. package/dist/duration/parse/parseDuration.js +31 -33
  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 +6 -17
  126. package/dist/gnss/convert/gnssToUtc.d.ts +2 -2
  127. package/dist/gnss/convert/gnssToUtc.js +38 -37
  128. package/dist/gnss/convert/gnssWeekToUtc.d.ts +2 -2
  129. package/dist/gnss/convert/gnssWeekToUtc.js +75 -78
  130. package/dist/gnss/convert/index.d.ts +7 -6
  131. package/dist/gnss/convert/index.js +8 -6
  132. package/dist/gnss/convert/rinexWeekToUtc.d.ts +2 -2
  133. package/dist/gnss/convert/rinexWeekToUtc.js +55 -55
  134. package/dist/gnss/convert/utcToGnss.d.ts +2 -2
  135. package/dist/gnss/convert/utcToGnss.js +52 -51
  136. package/dist/gnss/convert/utcToGnssWeek.d.ts +2 -2
  137. package/dist/gnss/convert/utcToGnssWeek.js +38 -38
  138. package/dist/gnss/convert/utcToRinexWeek.d.ts +2 -2
  139. package/dist/gnss/convert/utcToRinexWeek.js +40 -43
  140. package/dist/gnss/index.d.ts +8 -2
  141. package/dist/gnss/index.js +9 -3
  142. package/dist/index.d.ts +821 -18
  143. package/dist/index.js +757 -18
  144. package/dist/instant/convert/classifyLocal.d.ts +1 -1
  145. package/dist/instant/convert/classifyLocal.js +55 -55
  146. package/dist/instant/convert/fromOffsetInstant.d.ts +2 -2
  147. package/dist/instant/convert/fromOffsetInstant.js +80 -94
  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 +12 -11
  151. package/dist/instant/convert/resolveLocal.js +64 -74
  152. package/dist/instant/convert/toOffsetInstant.d.ts +18 -18
  153. package/dist/instant/convert/toOffsetInstant.js +124 -152
  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 +6 -1
  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 +111 -134
  168. package/dist/intermodal/calculate/chargeableDays.d.ts +35 -34
  169. package/dist/intermodal/calculate/chargeableDays.js +92 -101
  170. package/dist/intermodal/calculate/demurrageClock.d.ts +24 -23
  171. package/dist/intermodal/calculate/demurrageClock.js +104 -126
  172. package/dist/intermodal/calculate/freeTimeExpiry.d.ts +9 -8
  173. package/dist/intermodal/calculate/freeTimeExpiry.js +87 -93
  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 +17 -17
  177. package/dist/intermodal/calculate/multimodalETA.js +114 -138
  178. package/dist/intermodal/format/bolTimestamp.d.ts +9 -9
  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 +4 -3
  193. package/dist/intermodal/format/formatEpcisEvent.js +68 -76
  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 +87 -99
  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 +13 -46
  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 +22 -7
  293. package/dist/internal/businessCalendar.js +157 -198
  294. package/dist/internal/businessDayValues.d.ts +3 -2
  295. package/dist/internal/businessDayValues.js +41 -48
  296. package/dist/internal/calendarDatePairPolicy.d.ts +7 -6
  297. package/dist/internal/calendarDatePairPolicy.js +29 -23
  298. package/dist/internal/calendarDateString.d.ts +1 -1
  299. package/dist/internal/calendarDateString.js +50 -55
  300. package/dist/internal/calendarSystemIds.d.ts +3 -2
  301. package/dist/internal/calendarSystemIds.js +50 -51
  302. package/dist/internal/calendarValueOfDate.d.ts +3 -2
  303. package/dist/internal/calendarValueOfDate.js +31 -36
  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 +8 -5
  309. package/dist/internal/calendarZonedString.js +61 -65
  310. package/dist/internal/compareUnixEpochs.d.ts +2 -2
  311. package/dist/internal/compareUnixEpochs.js +21 -21
  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 +15 -14
  317. package/dist/internal/cutoffAtResolved.js +112 -139
  318. package/dist/internal/cycleFieldValue.d.ts +3 -3
  319. package/dist/internal/cycleFieldValue.js +42 -46
  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 +4 -2
  335. package/dist/internal/durationUntilString.js +20 -19
  336. package/dist/internal/dutyEngine.d.ts +38 -37
  337. package/dist/internal/dutyEngine.js +1265 -1609
  338. package/dist/internal/dutyLog.d.ts +6 -6
  339. package/dist/internal/dutyLog.js +39 -44
  340. package/dist/internal/dutyPeriods.d.ts +23 -23
  341. package/dist/internal/dutyPeriods.js +290 -337
  342. package/dist/internal/dutyRules.d.ts +128 -127
  343. package/dist/internal/dutyRules.js +385 -427
  344. package/dist/internal/dutyRunIndex.d.ts +43 -43
  345. package/dist/internal/dutyRunIndex.js +320 -326
  346. package/dist/internal/earlierOccurrence.d.ts +5 -5
  347. package/dist/internal/earlierOccurrence.js +54 -52
  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 +221 -251
  352. package/dist/internal/ediDateTimeWriter.d.ts +2 -2
  353. package/dist/internal/ediDateTimeWriter.js +204 -247
  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 +2 -2
  359. package/dist/internal/epochDay.js +81 -104
  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 +50 -57
  364. package/dist/internal/exactMoment.d.ts +8 -8
  365. package/dist/internal/exactMoment.js +100 -103
  366. package/dist/internal/exactSeconds.d.ts +10 -0
  367. package/dist/internal/exactSeconds.js +19 -0
  368. package/dist/internal/fiscalCalendar.d.ts +5 -4
  369. package/dist/internal/fiscalCalendar.js +147 -129
  370. package/dist/internal/floorDivide.d.ts +1 -1
  371. package/dist/internal/floorDivide.js +18 -16
  372. package/dist/internal/foreignEpochs.d.ts +24 -0
  373. package/dist/internal/foreignEpochs.js +149 -127
  374. package/dist/internal/formatCalendarDays.d.ts +2 -2
  375. package/dist/internal/formatCalendarDays.js +40 -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 +10 -7
  379. package/dist/internal/formatRelativeDuration.js +90 -74
  380. package/dist/internal/formatterCache.d.ts +1 -1
  381. package/dist/internal/formatterCache.js +124 -149
  382. package/dist/internal/freeTimeLedger.d.ts +27 -27
  383. package/dist/internal/freeTimeLedger.js +372 -499
  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 +8 -8
  391. package/dist/internal/gnssTimeScales.js +90 -118
  392. package/dist/internal/gnssWeek.d.ts +9 -9
  393. package/dist/internal/gnssWeek.js +176 -184
  394. package/dist/internal/halfOpenIntervals.d.ts +3 -3
  395. package/dist/internal/halfOpenIntervals.js +136 -162
  396. package/dist/internal/hasCalendarAnnotation.d.ts +1 -1
  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 +43 -42
  402. package/dist/internal/httpDateFields.d.ts +10 -10
  403. package/dist/internal/httpDateFields.js +65 -75
  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 -69
  409. package/dist/internal/index.js +79 -73
  410. package/dist/internal/inputChecks.d.ts +49 -3
  411. package/dist/internal/inputChecks.js +173 -115
  412. package/dist/internal/instantFormatOptions.d.ts +2 -2
  413. package/dist/internal/instantFormatOptions.js +76 -86
  414. package/dist/internal/instantIntervalText.d.ts +5 -5
  415. package/dist/internal/instantIntervalText.js +25 -22
  416. package/dist/internal/instantNanoseconds.d.ts +1 -1
  417. package/dist/internal/instantNanoseconds.js +168 -199
  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 +1 -1
  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 +72 -82
  438. package/dist/internal/leapSeconds.d.ts +6 -6
  439. package/dist/internal/leapSeconds.js +118 -140
  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 +12 -12
  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 +3 -3
  457. package/dist/internal/normalizeDateTime.js +24 -33
  458. package/dist/internal/normalizeTimeZone.d.ts +1 -1
  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 +12 -11
  465. package/dist/internal/offsetTimeline.js +110 -144
  466. package/dist/internal/operatingSchedule.d.ts +27 -26
  467. package/dist/internal/operatingSchedule.js +786 -975
  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 -398
  472. package/dist/internal/plainDateAdd.d.ts +1 -1
  473. package/dist/internal/plainDateAdd.js +32 -35
  474. package/dist/internal/plainDateUntil.d.ts +3 -2
  475. package/dist/internal/plainDateUntil.js +38 -46
  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 +137 -151
  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 +3 -2
  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 +1 -1
  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 +6 -6
  523. package/dist/internal/rinexWeek.js +36 -26
  524. package/dist/internal/rollBusinessDate.d.ts +4 -3
  525. package/dist/internal/rollBusinessDate.js +30 -39
  526. package/dist/internal/splitStep.d.ts +2 -2
  527. package/dist/internal/splitStep.js +172 -190
  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 +5 -4
  535. package/dist/internal/startOrEndOfUtc.js +143 -157
  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 -5
  539. package/dist/internal/temporal.js +3 -5
  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 +9 -6
  543. package/dist/internal/temporalCompat/calendarDateFromFields.js +87 -97
  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 +58 -3
  549. package/dist/internal/temporalCompat/capabilities.js +170 -106
  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 +4 -4
  553. package/dist/internal/temporalCompat/fieldSearch.js +38 -57
  554. package/dist/internal/temporalCompat/fixedDay.d.ts +1 -1
  555. package/dist/internal/temporalCompat/fixedDay.js +31 -35
  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 +124 -159
  570. package/dist/internal/temporalCompat/nonIsoArithmetic.d.ts +23 -23
  571. package/dist/internal/temporalCompat/nonIsoArithmetic.js +134 -176
  572. package/dist/internal/temporalCompat/probeRepros.d.ts +43 -28
  573. package/dist/internal/temporalCompat/probeRepros.js +828 -512
  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 +9 -8
  577. package/dist/internal/temporalCompat/repros.js +181 -170
  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 +6 -6
  583. package/dist/internal/timeScaleString.js +67 -79
  584. package/dist/internal/timestampEvents.d.ts +8 -7
  585. package/dist/internal/timestampEvents.js +56 -69
  586. package/dist/internal/toInstantFromUtc.d.ts +1 -1
  587. package/dist/internal/toInstantFromUtc.js +26 -26
  588. package/dist/internal/twoDigitYear.d.ts +1 -1
  589. package/dist/internal/twoDigitYear.js +23 -20
  590. package/dist/internal/unixEpochValue.d.ts +10 -10
  591. package/dist/internal/unixEpochValue.js +192 -221
  592. package/dist/internal/unixFormatReference.d.ts +2 -2
  593. package/dist/internal/unixFormatReference.js +35 -40
  594. package/dist/internal/unixWallClock.d.ts +4 -4
  595. package/dist/internal/unixWallClock.js +33 -32
  596. package/dist/internal/utcOffsetString.d.ts +1 -1
  597. package/dist/internal/utcOffsetString.js +74 -91
  598. package/dist/internal/utcReading.d.ts +5 -5
  599. package/dist/internal/utcReading.js +83 -96
  600. package/dist/internal/utcWallClock.d.ts +2 -2
  601. package/dist/internal/utcWallClock.js +29 -28
  602. package/dist/internal/validatedZones.d.ts +1 -1
  603. package/dist/internal/validatedZones.js +25 -24
  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 +3 -2
  613. package/dist/internal/zoneBucketCap.js +49 -55
  614. package/dist/internal/zoneFrame.d.ts +11 -11
  615. package/dist/internal/zoneFrame.js +182 -195
  616. package/dist/internal/zonedBucket.d.ts +3 -2
  617. package/dist/internal/zonedBucket.js +372 -427
  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 +1 -1
  631. package/dist/internal/zonedFormatReference.js +22 -21
  632. package/dist/internal/zonedLocalDates.d.ts +2 -2
  633. package/dist/internal/zonedLocalDates.js +45 -49
  634. package/dist/internal/zonedNowUnitValue.d.ts +1 -1
  635. package/dist/internal/zonedNowUnitValue.js +47 -56
  636. package/dist/internal/zonedTransitionSearch.d.ts +1 -1
  637. package/dist/internal/zonedTransitionSearch.js +221 -317
  638. package/dist/internal/zonedWallClock.d.ts +16 -6
  639. package/dist/internal/zonedWallClock.js +301 -426
  640. package/dist/internal/zonedWallClockDifference.d.ts +12 -45
  641. package/dist/internal/zonedWallClockDifference.js +139 -1166
  642. package/dist/internal/zonedWallClockOperations.d.ts +16 -13
  643. package/dist/internal/zonedWallClockOperations.js +385 -555
  644. package/dist/internal/zonelessCalendarDate.d.ts +1 -1
  645. package/dist/internal/zonelessCalendarDate.js +20 -18
  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 +3 -2
  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 +36 -42
  678. package/dist/plain/calculate/addTime.d.ts +3 -2
  679. package/dist/plain/calculate/addTime.js +36 -39
  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 +38 -43
  684. package/dist/plain/calculate/closestDateTo.d.ts +1 -1
  685. package/dist/plain/calculate/closestDateTo.js +44 -52
  686. package/dist/plain/calculate/cycleDate.d.ts +19 -17
  687. package/dist/plain/calculate/cycleDate.js +55 -55
  688. package/dist/plain/calculate/cycleDateTime.d.ts +19 -17
  689. package/dist/plain/calculate/cycleDateTime.js +52 -52
  690. package/dist/plain/calculate/cycleTime.d.ts +11 -10
  691. package/dist/plain/calculate/cycleTime.js +50 -50
  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 +4 -2
  697. package/dist/plain/calculate/diffDateTime.js +72 -91
  698. package/dist/plain/calculate/diffDateTimeAsDuration.d.ts +5 -2
  699. package/dist/plain/calculate/diffDateTimeAsDuration.js +50 -51
  700. package/dist/plain/calculate/diffTime.d.ts +4 -2
  701. package/dist/plain/calculate/diffTime.js +73 -92
  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 +9 -9
  705. package/dist/plain/calculate/endOfDate.js +66 -69
  706. package/dist/plain/calculate/endOfDateTime.d.ts +19 -18
  707. package/dist/plain/calculate/endOfDateTime.js +140 -150
  708. package/dist/plain/calculate/endOfQuarterForDate.d.ts +1 -1
  709. package/dist/plain/calculate/endOfQuarterForDate.js +33 -31
  710. package/dist/plain/calculate/endOfQuarterForDateTime.d.ts +1 -1
  711. package/dist/plain/calculate/endOfQuarterForDateTime.js +41 -45
  712. package/dist/plain/calculate/endOfTime.d.ts +11 -10
  713. package/dist/plain/calculate/endOfTime.js +96 -102
  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 +26 -25
  718. package/dist/plain/calculate/getDaysInMonth.d.ts +1 -1
  719. package/dist/plain/calculate/getDaysInMonth.js +26 -25
  720. package/dist/plain/calculate/getDaysInYear.d.ts +4 -1
  721. package/dist/plain/calculate/getDaysInYear.js +27 -23
  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 +1 -1
  731. package/dist/plain/calculate/getLocaleDayOfWeek.js +37 -38
  732. package/dist/plain/calculate/getLocaleEndOfWeek.d.ts +1 -1
  733. package/dist/plain/calculate/getLocaleEndOfWeek.js +42 -42
  734. package/dist/plain/calculate/getLocaleStartOfWeek.d.ts +1 -1
  735. package/dist/plain/calculate/getLocaleStartOfWeek.js +42 -42
  736. package/dist/plain/calculate/getLocaleWeekYear.d.ts +9 -9
  737. package/dist/plain/calculate/getLocaleWeekYear.js +58 -61
  738. package/dist/plain/calculate/getQuarterForDate.d.ts +1 -1
  739. package/dist/plain/calculate/getQuarterForDate.js +28 -27
  740. package/dist/plain/calculate/getQuarterForDateTime.d.ts +1 -1
  741. package/dist/plain/calculate/getQuarterForDateTime.js +28 -27
  742. package/dist/plain/calculate/getWeekNumber.d.ts +1 -1
  743. package/dist/plain/calculate/getWeekNumber.js +51 -57
  744. package/dist/plain/calculate/getWeekOfMonth.d.ts +1 -1
  745. package/dist/plain/calculate/getWeekOfMonth.js +43 -44
  746. package/dist/plain/calculate/getWeekYear.d.ts +1 -1
  747. package/dist/plain/calculate/getWeekYear.js +31 -30
  748. package/dist/plain/calculate/getWeeksInLocaleWeekYear.d.ts +9 -9
  749. package/dist/plain/calculate/getWeeksInLocaleWeekYear.js +56 -59
  750. package/dist/plain/calculate/getWeeksInMonth.d.ts +1 -1
  751. package/dist/plain/calculate/getWeeksInMonth.js +41 -42
  752. package/dist/plain/calculate/getWeeksInYear.d.ts +1 -1
  753. package/dist/plain/calculate/getWeeksInYear.js +36 -35
  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 +32 -37
  758. package/dist/plain/calculate/maxDateTime.d.ts +1 -1
  759. package/dist/plain/calculate/maxDateTime.js +32 -37
  760. package/dist/plain/calculate/maxTime.d.ts +1 -1
  761. package/dist/plain/calculate/maxTime.js +32 -37
  762. package/dist/plain/calculate/minDate.d.ts +1 -1
  763. package/dist/plain/calculate/minDate.js +32 -37
  764. package/dist/plain/calculate/minDateTime.d.ts +1 -1
  765. package/dist/plain/calculate/minDateTime.js +32 -37
  766. package/dist/plain/calculate/minTime.d.ts +1 -1
  767. package/dist/plain/calculate/minTime.js +32 -37
  768. package/dist/plain/calculate/nextWeekday.d.ts +8 -8
  769. package/dist/plain/calculate/nextWeekday.js +48 -48
  770. package/dist/plain/calculate/previousWeekday.d.ts +8 -8
  771. package/dist/plain/calculate/previousWeekday.js +48 -48
  772. package/dist/plain/calculate/roundDate.d.ts +25 -24
  773. package/dist/plain/calculate/roundDate.js +82 -102
  774. package/dist/plain/calculate/roundDateTime.d.ts +27 -26
  775. package/dist/plain/calculate/roundDateTime.js +98 -126
  776. package/dist/plain/calculate/roundTime.d.ts +23 -23
  777. package/dist/plain/calculate/roundTime.js +48 -50
  778. package/dist/plain/calculate/setDate.d.ts +10 -9
  779. package/dist/plain/calculate/setDate.js +58 -63
  780. package/dist/plain/calculate/setDateTime.d.ts +11 -10
  781. package/dist/plain/calculate/setDateTime.js +52 -57
  782. package/dist/plain/calculate/setTime.d.ts +10 -9
  783. package/dist/plain/calculate/setTime.js +54 -59
  784. package/dist/plain/calculate/sortDateTimes.d.ts +1 -1
  785. package/dist/plain/calculate/sortDateTimes.js +33 -37
  786. package/dist/plain/calculate/sortDates.d.ts +1 -1
  787. package/dist/plain/calculate/sortDates.js +33 -37
  788. package/dist/plain/calculate/sortTimes.d.ts +1 -1
  789. package/dist/plain/calculate/sortTimes.js +33 -37
  790. package/dist/plain/calculate/startOfDate.d.ts +9 -9
  791. package/dist/plain/calculate/startOfDate.js +64 -69
  792. package/dist/plain/calculate/startOfDateTime.d.ts +19 -18
  793. package/dist/plain/calculate/startOfDateTime.js +96 -98
  794. package/dist/plain/calculate/startOfQuarterForDate.d.ts +1 -1
  795. package/dist/plain/calculate/startOfQuarterForDate.js +33 -29
  796. package/dist/plain/calculate/startOfQuarterForDateTime.d.ts +1 -1
  797. package/dist/plain/calculate/startOfQuarterForDateTime.js +39 -40
  798. package/dist/plain/calculate/startOfTime.d.ts +11 -10
  799. package/dist/plain/calculate/startOfTime.js +53 -59
  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 +3 -2
  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 +50 -51
  806. package/dist/plain/calculate/subtractDateTime.d.ts +11 -9
  807. package/dist/plain/calculate/subtractDateTime.js +36 -42
  808. package/dist/plain/calculate/subtractTime.d.ts +3 -2
  809. package/dist/plain/calculate/subtractTime.js +36 -39
  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 +26 -25
  814. package/dist/plain/calculate/weekOfYearForDateTime.d.ts +1 -1
  815. package/dist/plain/calculate/weekOfYearForDateTime.js +29 -28
  816. package/dist/plain/chop/chopDate.d.ts +1 -1
  817. package/dist/plain/chop/chopDate.js +23 -21
  818. package/dist/plain/chop/chopMilliseconds.d.ts +1 -1
  819. package/dist/plain/chop/chopMilliseconds.js +27 -31
  820. package/dist/plain/chop/chopSeconds.d.ts +1 -1
  821. package/dist/plain/chop/chopSeconds.js +27 -31
  822. package/dist/plain/chop/chopTime.d.ts +1 -1
  823. package/dist/plain/chop/chopTime.js +23 -21
  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 +27 -34
  828. package/dist/plain/compare/areDateTimesEqualBy.d.ts +9 -9
  829. package/dist/plain/compare/areDateTimesEqualBy.js +60 -67
  830. package/dist/plain/compare/areDatesEqual.d.ts +1 -1
  831. package/dist/plain/compare/areDatesEqual.js +29 -30
  832. package/dist/plain/compare/areDatesEqualBy.d.ts +9 -9
  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 +30 -34
  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 +26 -25
  848. package/dist/plain/compare/isAfterDateTime.d.ts +1 -1
  849. package/dist/plain/compare/isAfterDateTime.js +27 -26
  850. package/dist/plain/compare/isAfterTime.d.ts +1 -1
  851. package/dist/plain/compare/isAfterTime.js +27 -26
  852. package/dist/plain/compare/isBeforeDate.d.ts +1 -1
  853. package/dist/plain/compare/isBeforeDate.js +27 -26
  854. package/dist/plain/compare/isBeforeDateTime.d.ts +1 -1
  855. package/dist/plain/compare/isBeforeDateTime.js +27 -26
  856. package/dist/plain/compare/isBeforeTime.d.ts +1 -1
  857. package/dist/plain/compare/isBeforeTime.js +27 -26
  858. package/dist/plain/compare/isBetweenDate.d.ts +15 -15
  859. package/dist/plain/compare/isBetweenDate.js +45 -60
  860. package/dist/plain/compare/isBetweenDateTime.d.ts +15 -15
  861. package/dist/plain/compare/isBetweenDateTime.js +45 -62
  862. package/dist/plain/compare/isBetweenTime.d.ts +15 -15
  863. package/dist/plain/compare/isBetweenTime.js +47 -62
  864. package/dist/plain/compare/isBusinessDay.d.ts +3 -2
  865. package/dist/plain/compare/isBusinessDay.js +50 -51
  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 +1 -1
  871. package/dist/plain/compare/isRelativeDay.js +43 -45
  872. package/dist/plain/compare/isThisUnit.d.ts +2 -2
  873. package/dist/plain/compare/isThisUnit.js +65 -69
  874. package/dist/plain/compare/isWeekend.d.ts +1 -1
  875. package/dist/plain/compare/isWeekend.js +39 -38
  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 +12 -11
  883. package/dist/plain/format/formatCalendar.js +72 -94
  884. package/dist/plain/format/formatDate.d.ts +3 -2
  885. package/dist/plain/format/formatDate.js +52 -61
  886. package/dist/plain/format/formatDateRange.d.ts +3 -2
  887. package/dist/plain/format/formatDateRange.js +49 -55
  888. package/dist/plain/format/formatDateTime.d.ts +3 -2
  889. package/dist/plain/format/formatDateTime.js +50 -55
  890. package/dist/plain/format/formatDateTimeRange.d.ts +3 -2
  891. package/dist/plain/format/formatDateTimeRange.js +50 -55
  892. package/dist/plain/format/formatDateTimeToParts.d.ts +14 -13
  893. package/dist/plain/format/formatDateTimeToParts.js +70 -74
  894. package/dist/plain/format/formatDateToParts.d.ts +14 -13
  895. package/dist/plain/format/formatDateToParts.js +66 -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 +14 -12
  899. package/dist/plain/format/formatRelativeDate.js +75 -76
  900. package/dist/plain/format/formatRelativeDateTime.d.ts +13 -11
  901. package/dist/plain/format/formatRelativeDateTime.js +50 -59
  902. package/dist/plain/format/formatRelativeTime.d.ts +14 -12
  903. package/dist/plain/format/formatRelativeTime.js +63 -65
  904. package/dist/plain/format/formatSqlDateTime.d.ts +4 -3
  905. package/dist/plain/format/formatSqlDateTime.js +38 -37
  906. package/dist/plain/format/formatTime.d.ts +3 -2
  907. package/dist/plain/format/formatTime.js +48 -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 +29 -28
  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 +1 -1
  959. package/dist/plain/interval/intervalAbutsDate.js +55 -60
  960. package/dist/plain/interval/intervalAbutsDateTime.d.ts +1 -1
  961. package/dist/plain/interval/intervalAbutsDateTime.js +48 -54
  962. package/dist/plain/interval/intervalAbutsTime.d.ts +1 -1
  963. package/dist/plain/interval/intervalAbutsTime.js +52 -58
  964. package/dist/plain/interval/intervalContainsDate.d.ts +1 -1
  965. package/dist/plain/interval/intervalContainsDate.js +62 -65
  966. package/dist/plain/interval/intervalContainsDateTime.d.ts +1 -1
  967. package/dist/plain/interval/intervalContainsDateTime.js +57 -61
  968. package/dist/plain/interval/intervalContainsTime.d.ts +1 -1
  969. package/dist/plain/interval/intervalContainsTime.js +62 -66
  970. package/dist/plain/interval/intervalCountDate.d.ts +1 -1
  971. package/dist/plain/interval/intervalCountDate.js +69 -88
  972. package/dist/plain/interval/intervalCountDateTime.d.ts +1 -1
  973. package/dist/plain/interval/intervalCountDateTime.js +85 -106
  974. package/dist/plain/interval/intervalCountTime.d.ts +1 -1
  975. package/dist/plain/interval/intervalCountTime.js +55 -64
  976. package/dist/plain/interval/intervalDifferenceDate.d.ts +12 -12
  977. package/dist/plain/interval/intervalDifferenceDate.js +71 -71
  978. package/dist/plain/interval/intervalDifferenceDateTime.d.ts +12 -12
  979. package/dist/plain/interval/intervalDifferenceDateTime.js +54 -60
  980. package/dist/plain/interval/intervalDifferenceTime.d.ts +12 -12
  981. package/dist/plain/interval/intervalDifferenceTime.js +56 -62
  982. package/dist/plain/interval/intervalDivideEquallyDate.d.ts +20 -20
  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 +72 -91
  986. package/dist/plain/interval/intervalDivideEquallyTime.d.ts +20 -20
  987. package/dist/plain/interval/intervalDivideEquallyTime.js +66 -84
  988. package/dist/plain/interval/intervalEngulfsDate.d.ts +1 -1
  989. package/dist/plain/interval/intervalEngulfsDate.js +56 -61
  990. package/dist/plain/interval/intervalEngulfsDateTime.d.ts +1 -1
  991. package/dist/plain/interval/intervalEngulfsDateTime.js +51 -57
  992. package/dist/plain/interval/intervalEngulfsTime.d.ts +1 -1
  993. package/dist/plain/interval/intervalEngulfsTime.js +56 -62
  994. package/dist/plain/interval/intervalFromDurationDate.d.ts +21 -20
  995. package/dist/plain/interval/intervalFromDurationDate.js +63 -68
  996. package/dist/plain/interval/intervalFromDurationDateTime.d.ts +21 -20
  997. package/dist/plain/interval/intervalFromDurationDateTime.js +50 -56
  998. package/dist/plain/interval/intervalFromDurationTime.d.ts +12 -12
  999. package/dist/plain/interval/intervalFromDurationTime.js +60 -74
  1000. package/dist/plain/interval/intervalIntersectionDate.d.ts +12 -12
  1001. package/dist/plain/interval/intervalIntersectionDate.js +70 -72
  1002. package/dist/plain/interval/intervalIntersectionDateTime.d.ts +12 -12
  1003. package/dist/plain/interval/intervalIntersectionDateTime.js +55 -60
  1004. package/dist/plain/interval/intervalIntersectionTime.d.ts +12 -12
  1005. package/dist/plain/interval/intervalIntersectionTime.js +55 -60
  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 +43 -47
  1010. package/dist/plain/interval/intervalLengthTime.d.ts +1 -1
  1011. package/dist/plain/interval/intervalLengthTime.js +40 -46
  1012. package/dist/plain/interval/intervalOverlappingDaysDate.d.ts +1 -1
  1013. package/dist/plain/interval/intervalOverlappingDaysDate.js +66 -75
  1014. package/dist/plain/interval/intervalOverlappingDaysDateTime.d.ts +1 -1
  1015. package/dist/plain/interval/intervalOverlappingDaysDateTime.js +51 -64
  1016. package/dist/plain/interval/intervalSplitAtDate.d.ts +12 -12
  1017. package/dist/plain/interval/intervalSplitAtDate.js +79 -84
  1018. package/dist/plain/interval/intervalSplitAtDateTime.d.ts +12 -12
  1019. package/dist/plain/interval/intervalSplitAtDateTime.js +64 -73
  1020. package/dist/plain/interval/intervalSplitAtTime.d.ts +12 -12
  1021. package/dist/plain/interval/intervalSplitAtTime.js +66 -75
  1022. package/dist/plain/interval/intervalUnionDate.d.ts +12 -12
  1023. package/dist/plain/interval/intervalUnionDate.js +74 -76
  1024. package/dist/plain/interval/intervalUnionDateTime.d.ts +12 -12
  1025. package/dist/plain/interval/intervalUnionDateTime.js +58 -63
  1026. package/dist/plain/interval/intervalUnionTime.d.ts +12 -12
  1027. package/dist/plain/interval/intervalUnionTime.js +58 -63
  1028. package/dist/plain/interval/intervalXorAllDate.d.ts +14 -14
  1029. package/dist/plain/interval/intervalXorAllDate.js +58 -63
  1030. package/dist/plain/interval/intervalXorAllDateTime.d.ts +14 -14
  1031. package/dist/plain/interval/intervalXorAllDateTime.js +48 -53
  1032. package/dist/plain/interval/intervalXorAllTime.d.ts +14 -14
  1033. package/dist/plain/interval/intervalXorAllTime.js +49 -54
  1034. package/dist/plain/interval/intervalXorDate.d.ts +12 -12
  1035. package/dist/plain/interval/intervalXorDate.js +65 -68
  1036. package/dist/plain/interval/intervalXorDateTime.d.ts +12 -12
  1037. package/dist/plain/interval/intervalXorDateTime.js +51 -60
  1038. package/dist/plain/interval/intervalXorTime.d.ts +12 -12
  1039. package/dist/plain/interval/intervalXorTime.js +51 -60
  1040. package/dist/plain/interval/intervalsOverlapDate.d.ts +1 -1
  1041. package/dist/plain/interval/intervalsOverlapDate.js +55 -60
  1042. package/dist/plain/interval/intervalsOverlapDateTime.d.ts +1 -1
  1043. package/dist/plain/interval/intervalsOverlapDateTime.js +49 -55
  1044. package/dist/plain/interval/intervalsOverlapTime.d.ts +1 -1
  1045. package/dist/plain/interval/intervalsOverlapTime.js +50 -56
  1046. package/dist/plain/interval/mergeIntervalsDate.d.ts +14 -14
  1047. package/dist/plain/interval/mergeIntervalsDate.js +57 -62
  1048. package/dist/plain/interval/mergeIntervalsDateTime.d.ts +14 -14
  1049. package/dist/plain/interval/mergeIntervalsDateTime.js +47 -53
  1050. package/dist/plain/interval/mergeIntervalsTime.d.ts +14 -14
  1051. package/dist/plain/interval/mergeIntervalsTime.js +47 -53
  1052. package/dist/plain/interval/splitIntervalByUnitDate.d.ts +20 -20
  1053. package/dist/plain/interval/splitIntervalByUnitDate.js +85 -108
  1054. package/dist/plain/interval/splitIntervalByUnitDateTime.d.ts +20 -20
  1055. package/dist/plain/interval/splitIntervalByUnitDateTime.js +76 -95
  1056. package/dist/plain/interval/splitIntervalByUnitTime.d.ts +20 -20
  1057. package/dist/plain/interval/splitIntervalByUnitTime.js +78 -103
  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 +1 -1
  1061. package/dist/plain/interval/validate/isValidDateInterval.js +35 -36
  1062. package/dist/plain/interval/validate/isValidDateTimeInterval.d.ts +1 -1
  1063. package/dist/plain/interval/validate/isValidDateTimeInterval.js +34 -35
  1064. package/dist/plain/interval/validate/isValidTimeInterval.d.ts +1 -1
  1065. package/dist/plain/interval/validate/isValidTimeInterval.js +34 -35
  1066. package/dist/plain/locale/getLocaleEraNames.d.ts +2 -2
  1067. package/dist/plain/locale/getLocaleEraNames.js +69 -79
  1068. package/dist/plain/locale/getLocaleMeridiems.d.ts +1 -1
  1069. package/dist/plain/locale/getLocaleMeridiems.js +42 -48
  1070. package/dist/plain/locale/getLocaleMonthNames.d.ts +1 -1
  1071. package/dist/plain/locale/getLocaleMonthNames.js +57 -63
  1072. package/dist/plain/locale/getLocaleWeekdayNames.d.ts +2 -2
  1073. package/dist/plain/locale/getLocaleWeekdayNames.js +58 -69
  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 +56 -75
  1080. package/dist/plain/map/mapDaysInMonth.d.ts +1 -1
  1081. package/dist/plain/map/mapDaysInMonth.js +29 -28
  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 +9 -5
  1085. package/dist/plain/parse/parseDateTimeWithPattern.js +133 -138
  1086. package/dist/plain/parse/parseDateWithPattern.d.ts +9 -5
  1087. package/dist/plain/parse/parseDateWithPattern.js +113 -114
  1088. package/dist/plain/parse/parseDayFromDate.d.ts +1 -1
  1089. package/dist/plain/parse/parseDayFromDate.js +23 -22
  1090. package/dist/plain/parse/parseDayFromDateTime.d.ts +1 -1
  1091. package/dist/plain/parse/parseDayFromDateTime.js +24 -23
  1092. package/dist/plain/parse/parseDayOfWeekFromDate.d.ts +1 -1
  1093. package/dist/plain/parse/parseDayOfWeekFromDate.js +25 -25
  1094. package/dist/plain/parse/parseDayOfWeekFromDateTime.d.ts +1 -1
  1095. package/dist/plain/parse/parseDayOfWeekFromDateTime.js +24 -24
  1096. package/dist/plain/parse/parseHourFromDateTime.d.ts +1 -1
  1097. package/dist/plain/parse/parseHourFromDateTime.js +24 -23
  1098. package/dist/plain/parse/parseHourFromTime.d.ts +1 -1
  1099. package/dist/plain/parse/parseHourFromTime.js +23 -22
  1100. package/dist/plain/parse/parseMicrosecondFromDateTime.d.ts +1 -1
  1101. package/dist/plain/parse/parseMicrosecondFromDateTime.js +25 -24
  1102. package/dist/plain/parse/parseMicrosecondFromTime.d.ts +1 -1
  1103. package/dist/plain/parse/parseMicrosecondFromTime.js +22 -21
  1104. package/dist/plain/parse/parseMillisecondFromDateTime.d.ts +1 -1
  1105. package/dist/plain/parse/parseMillisecondFromDateTime.js +24 -23
  1106. package/dist/plain/parse/parseMillisecondFromTime.d.ts +1 -1
  1107. package/dist/plain/parse/parseMillisecondFromTime.js +24 -23
  1108. package/dist/plain/parse/parseMinuteFromDateTime.d.ts +1 -1
  1109. package/dist/plain/parse/parseMinuteFromDateTime.js +24 -23
  1110. package/dist/plain/parse/parseMinuteFromTime.d.ts +1 -1
  1111. package/dist/plain/parse/parseMinuteFromTime.js +24 -23
  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 +23 -22
  1122. package/dist/plain/parse/parseMonthFromDateTime.d.ts +1 -1
  1123. package/dist/plain/parse/parseMonthFromDateTime.js +23 -22
  1124. package/dist/plain/parse/parseNanosecondFromDateTime.d.ts +1 -1
  1125. package/dist/plain/parse/parseNanosecondFromDateTime.js +25 -24
  1126. package/dist/plain/parse/parseNanosecondFromTime.d.ts +1 -1
  1127. package/dist/plain/parse/parseNanosecondFromTime.js +25 -24
  1128. package/dist/plain/parse/parseSecondFromDateTime.d.ts +1 -1
  1129. package/dist/plain/parse/parseSecondFromDateTime.js +24 -23
  1130. package/dist/plain/parse/parseSecondFromTime.d.ts +1 -1
  1131. package/dist/plain/parse/parseSecondFromTime.js +24 -23
  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 +1 -1
  1135. package/dist/plain/parse/parseTimeWithPattern.js +85 -94
  1136. package/dist/plain/parse/parseUnitFromDate.d.ts +10 -10
  1137. package/dist/plain/parse/parseUnitFromDate.js +56 -67
  1138. package/dist/plain/parse/parseUnitFromDateTime.d.ts +10 -10
  1139. package/dist/plain/parse/parseUnitFromDateTime.js +62 -80
  1140. package/dist/plain/parse/parseUnitFromTime.d.ts +1 -1
  1141. package/dist/plain/parse/parseUnitFromTime.js +42 -48
  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 +35 -41
  1146. package/dist/plain/parse/parseYearFromDate.d.ts +1 -1
  1147. package/dist/plain/parse/parseYearFromDate.js +27 -25
  1148. package/dist/plain/parse/parseYearFromDateTime.d.ts +1 -1
  1149. package/dist/plain/parse/parseYearFromDateTime.js +26 -24
  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/hasSecond60.d.ts +1 -1
  1159. package/dist/plain/validate/hasSecond60.js +41 -39
  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 +29 -28
  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 +6 -25
  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 +37 -49
  1174. package/dist/plain/validate/isValidDateTime.d.ts +6 -1
  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 +38 -47
  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 +21 -44
  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 +6 -22
  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 +39 -48
  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 +1 -1
  1219. package/dist/precision/convert/fromNanoseconds.js +48 -53
  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 +1 -1
  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 +7 -2
  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 +1 -1
  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 +1 -1
  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 +1 -1
  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 +1 -1
  1349. package/dist/span/calculate/spanMs.js +75 -80
  1350. package/dist/span/calculate/spanNs.d.ts +1 -1
  1351. package/dist/span/calculate/spanNs.js +58 -56
  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 +1 -1
  1355. package/dist/span/calculate/spanWallClock.js +68 -75
  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 +1 -1
  1361. package/dist/span/validate/isValidSpan.js +47 -44
  1362. package/dist/timescale/calculate/index.d.ts +4 -3
  1363. package/dist/timescale/calculate/index.js +5 -3
  1364. package/dist/timescale/calculate/leapSecondsBetween.d.ts +1 -1
  1365. package/dist/timescale/calculate/leapSecondsBetween.js +52 -57
  1366. package/dist/timescale/calculate/nextLeapSecond.d.ts +1 -1
  1367. package/dist/timescale/calculate/nextLeapSecond.js +31 -31
  1368. package/dist/timescale/calculate/taiMinusUtc.d.ts +1 -1
  1369. package/dist/timescale/calculate/taiMinusUtc.js +36 -36
  1370. package/dist/timescale/convert/fromTAI.d.ts +1 -1
  1371. package/dist/timescale/convert/fromTAI.js +36 -33
  1372. package/dist/timescale/convert/index.d.ts +3 -2
  1373. package/dist/timescale/convert/index.js +4 -2
  1374. package/dist/timescale/convert/toTAI.d.ts +1 -1
  1375. package/dist/timescale/convert/toTAI.js +41 -37
  1376. package/dist/timescale/index.d.ts +8 -4
  1377. package/dist/timescale/index.js +9 -5
  1378. package/dist/timescale/validate/index.d.ts +2 -1
  1379. package/dist/timescale/validate/index.js +3 -1
  1380. package/dist/timescale/validate/isLeapSecond.d.ts +1 -1
  1381. package/dist/timescale/validate/isLeapSecond.js +36 -34
  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 +10 -10
  1385. package/dist/transport/calculate/crossingTime.js +69 -77
  1386. package/dist/transport/calculate/cutoffAt.d.ts +29 -27
  1387. package/dist/transport/calculate/cutoffAt.js +86 -97
  1388. package/dist/transport/calculate/cutoffSchedule.d.ts +34 -34
  1389. package/dist/transport/calculate/cutoffSchedule.js +87 -94
  1390. package/dist/transport/calculate/dwellTime.d.ts +15 -15
  1391. package/dist/transport/calculate/dwellTime.js +110 -127
  1392. package/dist/transport/calculate/estimateDrift.d.ts +24 -23
  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 +16 -16
  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 +68 -68
  1401. package/dist/transport/calculate/scheduleDelivery.js +236 -274
  1402. package/dist/transport/calculate/transitTime.d.ts +1 -1
  1403. package/dist/transport/calculate/transitTime.js +87 -96
  1404. package/dist/transport/compare/classifyPunctuality.d.ts +3 -2
  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 +1 -1
  1409. package/dist/transport/compare/isPastCutoff.js +43 -44
  1410. package/dist/transport/compare/scheduleDeviation.d.ts +1 -1
  1411. package/dist/transport/compare/scheduleDeviation.js +47 -50
  1412. package/dist/transport/compare/timeToCutoff.d.ts +1 -1
  1413. package/dist/transport/compare/timeToCutoff.js +41 -44
  1414. package/dist/transport/convert/etaAtZone.d.ts +2 -2
  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 +17 -17
  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 +18 -18
  1443. package/dist/types/holiday-rule.d.ts +123 -0
  1444. package/dist/types/holiday-rule.js +0 -0
  1445. package/dist/types/index.d.ts +49 -44
  1446. package/dist/types/index.js +0 -43
  1447. package/dist/types/interval.d.ts +8 -8
  1448. package/dist/types/now-unit.d.ts +3 -1
  1449. package/dist/types/observance-policy.d.ts +19 -0
  1450. package/dist/types/observance-policy.js +0 -0
  1451. package/dist/types/offset.d.ts +2 -2
  1452. package/dist/types/operating-schedule.d.ts +47 -47
  1453. package/dist/types/overflow.d.ts +2 -2
  1454. package/dist/types/recurrence.d.ts +131 -0
  1455. package/dist/types/recurrence.js +0 -0
  1456. package/dist/types/relative-date-time-unit.d.ts +1 -1
  1457. package/dist/types/relative-date-unit.d.ts +1 -1
  1458. package/dist/types/relative-rounding-method.d.ts +1 -1
  1459. package/dist/types/relative-time-options.d.ts +40 -40
  1460. package/dist/types/relative-time-unit.d.ts +1 -1
  1461. package/dist/types/relative-unit.d.ts +1 -1
  1462. package/dist/types/roll-convention.d.ts +1 -1
  1463. package/dist/types/rounding-options.d.ts +27 -27
  1464. package/dist/types/stored-zoned-classification.d.ts +62 -62
  1465. package/dist/types/time-cycle-field.d.ts +1 -1
  1466. package/dist/types/time-duration-unit.d.ts +2 -2
  1467. package/dist/types/time-unit.d.ts +2 -2
  1468. package/dist/types/transport-timestamps.d.ts +25 -25
  1469. package/dist/types/two-digit-year.d.ts +15 -15
  1470. package/dist/types/unix-now-unit.d.ts +2 -1
  1471. package/dist/types/utc-now-unit.d.ts +3 -1
  1472. package/dist/types/zone-bucket-unit.d.ts +1 -1
  1473. package/dist/unix/calculate/addUnix.d.ts +28 -26
  1474. package/dist/unix/calculate/addUnix.js +56 -60
  1475. package/dist/unix/calculate/diffUnix.d.ts +22 -20
  1476. package/dist/unix/calculate/diffUnix.js +96 -109
  1477. package/dist/unix/calculate/diffUnixAsDuration.d.ts +23 -20
  1478. package/dist/unix/calculate/diffUnixAsDuration.js +69 -75
  1479. package/dist/unix/calculate/endOfQuarterForUnix.d.ts +18 -18
  1480. package/dist/unix/calculate/endOfQuarterForUnix.js +37 -38
  1481. package/dist/unix/calculate/endOfUnix.d.ts +27 -27
  1482. package/dist/unix/calculate/endOfUnix.js +46 -48
  1483. package/dist/unix/calculate/index.d.ts +16 -14
  1484. package/dist/unix/calculate/index.js +17 -14
  1485. package/dist/unix/calculate/isBetweenUnix.d.ts +32 -32
  1486. package/dist/unix/calculate/isBetweenUnix.js +43 -58
  1487. package/dist/unix/calculate/maxUnix.d.ts +1 -1
  1488. package/dist/unix/calculate/maxUnix.js +26 -27
  1489. package/dist/unix/calculate/minUnix.d.ts +1 -1
  1490. package/dist/unix/calculate/minUnix.js +26 -27
  1491. package/dist/unix/calculate/roundUnix.d.ts +40 -40
  1492. package/dist/unix/calculate/roundUnix.js +79 -87
  1493. package/dist/unix/calculate/secondsUntilUnix.d.ts +55 -0
  1494. package/dist/unix/calculate/secondsUntilUnix.js +62 -0
  1495. package/dist/unix/calculate/setUnix.d.ts +47 -44
  1496. package/dist/unix/calculate/setUnix.js +80 -87
  1497. package/dist/unix/calculate/sortUnix.d.ts +1 -1
  1498. package/dist/unix/calculate/sortUnix.js +31 -33
  1499. package/dist/unix/calculate/startOfQuarterForUnix.d.ts +18 -18
  1500. package/dist/unix/calculate/startOfQuarterForUnix.js +38 -39
  1501. package/dist/unix/calculate/startOfUnix.d.ts +27 -27
  1502. package/dist/unix/calculate/startOfUnix.js +46 -48
  1503. package/dist/unix/calculate/subtractUnix.d.ts +28 -26
  1504. package/dist/unix/calculate/subtractUnix.js +55 -59
  1505. package/dist/unix/compare/areUnixEqual.d.ts +9 -9
  1506. package/dist/unix/compare/areUnixEqual.js +33 -34
  1507. package/dist/unix/compare/areUnixEqualBy.d.ts +27 -27
  1508. package/dist/unix/compare/areUnixEqualBy.js +54 -54
  1509. package/dist/unix/compare/index.d.ts +5 -4
  1510. package/dist/unix/compare/index.js +6 -4
  1511. package/dist/unix/compare/isAfterUnix.d.ts +9 -9
  1512. package/dist/unix/compare/isAfterUnix.js +31 -32
  1513. package/dist/unix/compare/isBeforeUnix.d.ts +9 -9
  1514. package/dist/unix/compare/isBeforeUnix.js +32 -33
  1515. package/dist/unix/convert/convertUnixToPlainDate.d.ts +22 -22
  1516. package/dist/unix/convert/convertUnixToPlainDate.js +42 -47
  1517. package/dist/unix/convert/convertUnixToPlainDateTime.d.ts +22 -22
  1518. package/dist/unix/convert/convertUnixToPlainDateTime.js +40 -45
  1519. package/dist/unix/convert/convertUnixToPlainTime.d.ts +22 -22
  1520. package/dist/unix/convert/convertUnixToPlainTime.js +40 -45
  1521. package/dist/unix/convert/convertUnixToUtc.d.ts +9 -9
  1522. package/dist/unix/convert/convertUnixToUtc.js +32 -33
  1523. package/dist/unix/convert/convertUnixToZoned.d.ts +9 -9
  1524. package/dist/unix/convert/convertUnixToZoned.js +43 -47
  1525. package/dist/unix/convert/index.d.ts +6 -5
  1526. package/dist/unix/convert/index.js +7 -5
  1527. package/dist/unix/format/formatCalendarUnix.d.ts +33 -33
  1528. package/dist/unix/format/formatCalendarUnix.js +53 -60
  1529. package/dist/unix/format/formatRelativeUnix.d.ts +60 -58
  1530. package/dist/unix/format/formatRelativeUnix.js +64 -73
  1531. package/dist/unix/format/formatUnix.d.ts +24 -24
  1532. package/dist/unix/format/formatUnix.js +68 -75
  1533. package/dist/unix/format/index.d.ts +4 -3
  1534. package/dist/unix/format/index.js +5 -3
  1535. package/dist/unix/get/getUnixAgo.d.ts +38 -0
  1536. package/dist/unix/get/getUnixAgo.js +44 -0
  1537. package/dist/unix/get/getUnixDay.d.ts +2 -2
  1538. package/dist/unix/get/getUnixDay.js +16 -15
  1539. package/dist/unix/get/getUnixHour.d.ts +2 -2
  1540. package/dist/unix/get/getUnixHour.js +16 -15
  1541. package/dist/unix/get/getUnixIn.d.ts +40 -0
  1542. package/dist/unix/get/getUnixIn.js +46 -0
  1543. package/dist/unix/get/getUnixMicrosecond.d.ts +2 -2
  1544. package/dist/unix/get/getUnixMicrosecond.js +16 -14
  1545. package/dist/unix/get/getUnixMillisecond.d.ts +2 -2
  1546. package/dist/unix/get/getUnixMillisecond.js +16 -15
  1547. package/dist/unix/get/getUnixMinute.d.ts +2 -2
  1548. package/dist/unix/get/getUnixMinute.js +16 -15
  1549. package/dist/unix/get/getUnixMonth.d.ts +2 -2
  1550. package/dist/unix/get/getUnixMonth.js +16 -15
  1551. package/dist/unix/get/getUnixNanosecond.d.ts +2 -2
  1552. package/dist/unix/get/getUnixNanosecond.js +16 -14
  1553. package/dist/unix/get/getUnixNow.d.ts +19 -16
  1554. package/dist/unix/get/getUnixNow.js +14 -35
  1555. package/dist/unix/get/getUnixNowUnit.d.ts +4 -3
  1556. package/dist/unix/get/getUnixNowUnit.js +34 -32
  1557. package/dist/unix/get/getUnixSecond.d.ts +2 -2
  1558. package/dist/unix/get/getUnixSecond.js +16 -15
  1559. package/dist/unix/get/getUnixYear.d.ts +2 -2
  1560. package/dist/unix/get/getUnixYear.js +18 -14
  1561. package/dist/unix/get/index.d.ts +15 -11
  1562. package/dist/unix/get/index.js +15 -11
  1563. package/dist/unix/index.d.ts +85 -9
  1564. package/dist/unix/index.js +79 -10
  1565. package/dist/unix/interval/index.d.ts +19 -18
  1566. package/dist/unix/interval/index.js +20 -18
  1567. package/dist/unix/interval/intervalAbutsUnix.d.ts +1 -1
  1568. package/dist/unix/interval/intervalAbutsUnix.js +36 -34
  1569. package/dist/unix/interval/intervalContainsUnix.d.ts +1 -1
  1570. package/dist/unix/interval/intervalContainsUnix.js +48 -45
  1571. package/dist/unix/interval/intervalCountUnix.d.ts +18 -18
  1572. package/dist/unix/interval/intervalCountUnix.js +64 -71
  1573. package/dist/unix/interval/intervalDifferenceUnix.d.ts +9 -9
  1574. package/dist/unix/interval/intervalDifferenceUnix.js +38 -37
  1575. package/dist/unix/interval/intervalDivideEquallyUnix.d.ts +17 -17
  1576. package/dist/unix/interval/intervalDivideEquallyUnix.js +65 -72
  1577. package/dist/unix/interval/intervalEngulfsUnix.d.ts +1 -1
  1578. package/dist/unix/interval/intervalEngulfsUnix.js +35 -32
  1579. package/dist/unix/interval/intervalFromDurationUnix.d.ts +38 -37
  1580. package/dist/unix/interval/intervalFromDurationUnix.js +74 -87
  1581. package/dist/unix/interval/intervalIntersectionUnix.d.ts +9 -9
  1582. package/dist/unix/interval/intervalIntersectionUnix.js +35 -34
  1583. package/dist/unix/interval/intervalLengthUnix.d.ts +18 -18
  1584. package/dist/unix/interval/intervalLengthUnix.js +55 -63
  1585. package/dist/unix/interval/intervalOverlappingDaysUnix.d.ts +18 -18
  1586. package/dist/unix/interval/intervalOverlappingDaysUnix.js +85 -93
  1587. package/dist/unix/interval/intervalSplitAtUnix.d.ts +9 -9
  1588. package/dist/unix/interval/intervalSplitAtUnix.js +61 -62
  1589. package/dist/unix/interval/intervalUnionUnix.d.ts +9 -9
  1590. package/dist/unix/interval/intervalUnionUnix.js +36 -34
  1591. package/dist/unix/interval/intervalXorAllUnix.d.ts +11 -11
  1592. package/dist/unix/interval/intervalXorAllUnix.js +37 -40
  1593. package/dist/unix/interval/intervalXorUnix.d.ts +9 -9
  1594. package/dist/unix/interval/intervalXorUnix.js +41 -40
  1595. package/dist/unix/interval/intervalsOverlapUnix.d.ts +1 -1
  1596. package/dist/unix/interval/intervalsOverlapUnix.js +35 -33
  1597. package/dist/unix/interval/mergeIntervalsUnix.d.ts +11 -11
  1598. package/dist/unix/interval/mergeIntervalsUnix.js +38 -42
  1599. package/dist/unix/interval/splitIntervalByUnitUnix.d.ts +37 -37
  1600. package/dist/unix/interval/splitIntervalByUnitUnix.js +91 -108
  1601. package/dist/unix/interval/validate/index.d.ts +2 -1
  1602. package/dist/unix/interval/validate/index.js +3 -1
  1603. package/dist/unix/interval/validate/isValidUnixInterval.d.ts +1 -1
  1604. package/dist/unix/interval/validate/isValidUnixInterval.js +32 -30
  1605. package/dist/unix/parse/index.d.ts +15 -14
  1606. package/dist/unix/parse/index.js +16 -14
  1607. package/dist/unix/parse/parseDateFromUnix.d.ts +18 -18
  1608. package/dist/unix/parse/parseDateFromUnix.js +28 -29
  1609. package/dist/unix/parse/parseDayFromUnix.d.ts +18 -18
  1610. package/dist/unix/parse/parseDayFromUnix.js +26 -27
  1611. package/dist/unix/parse/parseDayOfWeekFromUnix.d.ts +18 -18
  1612. package/dist/unix/parse/parseDayOfWeekFromUnix.js +27 -28
  1613. package/dist/unix/parse/parseHourFromUnix.d.ts +18 -18
  1614. package/dist/unix/parse/parseHourFromUnix.js +26 -27
  1615. package/dist/unix/parse/parseMicrosecondFromUnix.d.ts +18 -18
  1616. package/dist/unix/parse/parseMicrosecondFromUnix.js +26 -27
  1617. package/dist/unix/parse/parseMillisecondFromUnix.d.ts +18 -18
  1618. package/dist/unix/parse/parseMillisecondFromUnix.js +26 -27
  1619. package/dist/unix/parse/parseMinuteFromUnix.d.ts +18 -18
  1620. package/dist/unix/parse/parseMinuteFromUnix.js +26 -27
  1621. package/dist/unix/parse/parseMonthFromUnix.d.ts +18 -18
  1622. package/dist/unix/parse/parseMonthFromUnix.js +27 -28
  1623. package/dist/unix/parse/parseNanosecondFromUnix.d.ts +18 -18
  1624. package/dist/unix/parse/parseNanosecondFromUnix.js +27 -28
  1625. package/dist/unix/parse/parseSecondFromUnix.d.ts +18 -18
  1626. package/dist/unix/parse/parseSecondFromUnix.js +26 -27
  1627. package/dist/unix/parse/parseTimeFromUnix.d.ts +18 -18
  1628. package/dist/unix/parse/parseTimeFromUnix.js +29 -30
  1629. package/dist/unix/parse/parseUnitFromUnix.d.ts +28 -28
  1630. package/dist/unix/parse/parseUnitFromUnix.js +60 -80
  1631. package/dist/unix/parse/parseWeekFromUnix.d.ts +26 -26
  1632. package/dist/unix/parse/parseWeekFromUnix.js +37 -41
  1633. package/dist/unix/parse/parseYearFromUnix.d.ts +18 -18
  1634. package/dist/unix/parse/parseYearFromUnix.js +30 -31
  1635. package/dist/unix/validate/index.d.ts +5 -4
  1636. package/dist/unix/validate/index.js +6 -4
  1637. package/dist/unix/validate/isValidUnixMilliseconds.d.ts +1 -1
  1638. package/dist/unix/validate/isValidUnixMilliseconds.js +21 -17
  1639. package/dist/unix/validate/isValidUnixRange.d.ts +22 -22
  1640. package/dist/unix/validate/isValidUnixRange.js +37 -39
  1641. package/dist/unix/validate/isValidUnixSeconds.d.ts +1 -1
  1642. package/dist/unix/validate/isValidUnixSeconds.js +21 -17
  1643. package/dist/unix/validate/isValidUnixUnit.d.ts +1 -1
  1644. package/dist/unix/validate/isValidUnixUnit.js +21 -17
  1645. package/dist/utc/calculate/addUtc.d.ts +11 -9
  1646. package/dist/utc/calculate/addUtc.js +37 -46
  1647. package/dist/utc/calculate/diffUtc.d.ts +4 -2
  1648. package/dist/utc/calculate/diffUtc.js +80 -99
  1649. package/dist/utc/calculate/diffUtcAsDuration.d.ts +5 -2
  1650. package/dist/utc/calculate/diffUtcAsDuration.js +50 -52
  1651. package/dist/utc/calculate/endOfQuarterForUtc.d.ts +1 -1
  1652. package/dist/utc/calculate/endOfQuarterForUtc.js +39 -45
  1653. package/dist/utc/calculate/endOfUtc.d.ts +20 -19
  1654. package/dist/utc/calculate/endOfUtc.js +33 -34
  1655. package/dist/utc/calculate/index.d.ts +17 -14
  1656. package/dist/utc/calculate/index.js +18 -14
  1657. package/dist/utc/calculate/isBetweenUtc.d.ts +15 -15
  1658. package/dist/utc/calculate/isBetweenUtc.js +47 -63
  1659. package/dist/utc/calculate/maxUtc.d.ts +1 -1
  1660. package/dist/utc/calculate/maxUtc.js +33 -38
  1661. package/dist/utc/calculate/minUtc.d.ts +1 -1
  1662. package/dist/utc/calculate/minUtc.js +33 -38
  1663. package/dist/utc/calculate/roundUtc.d.ts +32 -31
  1664. package/dist/utc/calculate/roundUtc.js +51 -54
  1665. package/dist/utc/calculate/secondsUntilHttpDate.d.ts +34 -0
  1666. package/dist/utc/calculate/secondsUntilHttpDate.js +50 -0
  1667. package/dist/utc/calculate/secondsUntilRetryAfter.d.ts +29 -0
  1668. package/dist/utc/calculate/secondsUntilRetryAfter.js +51 -0
  1669. package/dist/utc/calculate/setUtc.d.ts +10 -9
  1670. package/dist/utc/calculate/setUtc.js +61 -68
  1671. package/dist/utc/calculate/sortUtc.d.ts +1 -1
  1672. package/dist/utc/calculate/sortUtc.js +35 -39
  1673. package/dist/utc/calculate/startOfQuarterForUtc.d.ts +1 -1
  1674. package/dist/utc/calculate/startOfQuarterForUtc.js +37 -40
  1675. package/dist/utc/calculate/startOfUtc.d.ts +20 -19
  1676. package/dist/utc/calculate/startOfUtc.js +28 -29
  1677. package/dist/utc/calculate/subtractUtc.d.ts +11 -9
  1678. package/dist/utc/calculate/subtractUtc.js +37 -46
  1679. package/dist/utc/chop/chopUtc.d.ts +1 -1
  1680. package/dist/utc/chop/chopUtc.js +23 -22
  1681. package/dist/utc/chop/index.d.ts +2 -1
  1682. package/dist/utc/chop/index.js +3 -1
  1683. package/dist/utc/compare/areUtcEqual.d.ts +1 -1
  1684. package/dist/utc/compare/areUtcEqual.js +27 -26
  1685. package/dist/utc/compare/areUtcEqualBy.d.ts +9 -9
  1686. package/dist/utc/compare/areUtcEqualBy.js +53 -61
  1687. package/dist/utc/compare/index.d.ts +5 -4
  1688. package/dist/utc/compare/index.js +6 -4
  1689. package/dist/utc/compare/isAfterUtc.d.ts +1 -1
  1690. package/dist/utc/compare/isAfterUtc.js +27 -25
  1691. package/dist/utc/compare/isBeforeUtc.d.ts +1 -1
  1692. package/dist/utc/compare/isBeforeUtc.js +27 -26
  1693. package/dist/utc/convert/convertUtcToPlainDate.d.ts +10 -10
  1694. package/dist/utc/convert/convertUtcToPlainDate.js +38 -45
  1695. package/dist/utc/convert/convertUtcToPlainDateTime.d.ts +10 -10
  1696. package/dist/utc/convert/convertUtcToPlainDateTime.js +39 -47
  1697. package/dist/utc/convert/convertUtcToPlainTime.d.ts +10 -10
  1698. package/dist/utc/convert/convertUtcToPlainTime.js +36 -43
  1699. package/dist/utc/convert/convertUtcToUnix.d.ts +9 -9
  1700. package/dist/utc/convert/convertUtcToUnix.js +36 -38
  1701. package/dist/utc/convert/convertUtcToZoned.d.ts +1 -1
  1702. package/dist/utc/convert/convertUtcToZoned.js +30 -29
  1703. package/dist/utc/convert/index.d.ts +6 -5
  1704. package/dist/utc/convert/index.js +7 -5
  1705. package/dist/utc/format/formatCalendarUtc.d.ts +20 -19
  1706. package/dist/utc/format/formatCalendarUtc.js +51 -62
  1707. package/dist/utc/format/formatHttpDate.d.ts +1 -1
  1708. package/dist/utc/format/formatHttpDate.js +40 -41
  1709. package/dist/utc/format/formatHttpDateFromNow.d.ts +31 -0
  1710. package/dist/utc/format/formatHttpDateFromNow.js +45 -0
  1711. package/dist/utc/format/formatRelativeUtc.d.ts +28 -26
  1712. package/dist/utc/format/formatRelativeUtc.js +60 -71
  1713. package/dist/utc/format/formatUtc.d.ts +17 -17
  1714. package/dist/utc/format/formatUtc.js +60 -68
  1715. package/dist/utc/format/index.d.ts +6 -4
  1716. package/dist/utc/format/index.js +7 -4
  1717. package/dist/utc/get/getUtcAgo.d.ts +31 -0
  1718. package/dist/utc/get/getUtcAgo.js +47 -0
  1719. package/dist/utc/get/getUtcDay.d.ts +2 -2
  1720. package/dist/utc/get/getUtcDay.js +16 -15
  1721. package/dist/utc/get/getUtcHour.d.ts +2 -2
  1722. package/dist/utc/get/getUtcHour.js +16 -15
  1723. package/dist/utc/get/getUtcIn.d.ts +31 -0
  1724. package/dist/utc/get/getUtcIn.js +47 -0
  1725. package/dist/utc/get/getUtcMicrosecond.d.ts +2 -2
  1726. package/dist/utc/get/getUtcMicrosecond.js +16 -14
  1727. package/dist/utc/get/getUtcMillisecond.d.ts +2 -2
  1728. package/dist/utc/get/getUtcMillisecond.js +16 -15
  1729. package/dist/utc/get/getUtcMinute.d.ts +2 -2
  1730. package/dist/utc/get/getUtcMinute.js +16 -15
  1731. package/dist/utc/get/getUtcMonth.d.ts +2 -2
  1732. package/dist/utc/get/getUtcMonth.js +16 -15
  1733. package/dist/utc/get/getUtcNanosecond.d.ts +2 -2
  1734. package/dist/utc/get/getUtcNanosecond.js +16 -14
  1735. package/dist/utc/get/getUtcNow.d.ts +2 -2
  1736. package/dist/utc/get/getUtcNow.js +15 -11
  1737. package/dist/utc/get/getUtcNowUnit.d.ts +4 -3
  1738. package/dist/utc/get/getUtcNowUnit.js +36 -36
  1739. package/dist/utc/get/getUtcSecond.d.ts +2 -2
  1740. package/dist/utc/get/getUtcSecond.js +16 -15
  1741. package/dist/utc/get/getUtcYear.d.ts +2 -2
  1742. package/dist/utc/get/getUtcYear.js +18 -14
  1743. package/dist/utc/get/index.d.ts +15 -11
  1744. package/dist/utc/get/index.js +15 -11
  1745. package/dist/utc/index.d.ts +90 -10
  1746. package/dist/utc/index.js +84 -11
  1747. package/dist/utc/interval/index.d.ts +19 -18
  1748. package/dist/utc/interval/index.js +20 -18
  1749. package/dist/utc/interval/intervalAbutsUtc.d.ts +1 -1
  1750. package/dist/utc/interval/intervalAbutsUtc.js +49 -55
  1751. package/dist/utc/interval/intervalContainsUtc.d.ts +1 -1
  1752. package/dist/utc/interval/intervalContainsUtc.js +59 -62
  1753. package/dist/utc/interval/intervalCountUtc.d.ts +1 -1
  1754. package/dist/utc/interval/intervalCountUtc.js +48 -58
  1755. package/dist/utc/interval/intervalDifferenceUtc.d.ts +9 -9
  1756. package/dist/utc/interval/intervalDifferenceUtc.js +44 -48
  1757. package/dist/utc/interval/intervalDivideEquallyUtc.d.ts +17 -17
  1758. package/dist/utc/interval/intervalDivideEquallyUtc.js +68 -81
  1759. package/dist/utc/interval/intervalEngulfsUtc.d.ts +1 -1
  1760. package/dist/utc/interval/intervalEngulfsUtc.js +51 -57
  1761. package/dist/utc/interval/intervalFromDurationUtc.d.ts +18 -17
  1762. package/dist/utc/interval/intervalFromDurationUtc.js +52 -63
  1763. package/dist/utc/interval/intervalIntersectionUtc.d.ts +9 -9
  1764. package/dist/utc/interval/intervalIntersectionUtc.js +42 -45
  1765. package/dist/utc/interval/intervalLengthUtc.d.ts +1 -1
  1766. package/dist/utc/interval/intervalLengthUtc.js +41 -47
  1767. package/dist/utc/interval/intervalOverlappingDaysUtc.d.ts +1 -1
  1768. package/dist/utc/interval/intervalOverlappingDaysUtc.js +52 -61
  1769. package/dist/utc/interval/intervalSplitAtUtc.d.ts +9 -9
  1770. package/dist/utc/interval/intervalSplitAtUtc.js +62 -69
  1771. package/dist/utc/interval/intervalUnionUtc.d.ts +9 -9
  1772. package/dist/utc/interval/intervalUnionUtc.js +45 -52
  1773. package/dist/utc/interval/intervalXorAllUtc.d.ts +11 -11
  1774. package/dist/utc/interval/intervalXorAllUtc.js +48 -55
  1775. package/dist/utc/interval/intervalXorUtc.d.ts +9 -9
  1776. package/dist/utc/interval/intervalXorUtc.js +51 -60
  1777. package/dist/utc/interval/intervalsOverlapUtc.d.ts +1 -1
  1778. package/dist/utc/interval/intervalsOverlapUtc.js +40 -41
  1779. package/dist/utc/interval/mergeIntervalsUtc.d.ts +11 -11
  1780. package/dist/utc/interval/mergeIntervalsUtc.js +39 -45
  1781. package/dist/utc/interval/splitIntervalByUnitUtc.d.ts +17 -17
  1782. package/dist/utc/interval/splitIntervalByUnitUtc.js +78 -96
  1783. package/dist/utc/interval/validate/index.d.ts +2 -1
  1784. package/dist/utc/interval/validate/index.js +3 -1
  1785. package/dist/utc/interval/validate/isValidUtcInterval.d.ts +1 -1
  1786. package/dist/utc/interval/validate/isValidUtcInterval.js +37 -38
  1787. package/dist/utc/parse/index.d.ts +16 -15
  1788. package/dist/utc/parse/index.js +17 -15
  1789. package/dist/utc/parse/parseDateFromUtc.d.ts +10 -10
  1790. package/dist/utc/parse/parseDateFromUtc.js +26 -27
  1791. package/dist/utc/parse/parseDayFromUtc.d.ts +10 -10
  1792. package/dist/utc/parse/parseDayFromUtc.js +26 -27
  1793. package/dist/utc/parse/parseDayOfWeekFromUtc.d.ts +10 -10
  1794. package/dist/utc/parse/parseDayOfWeekFromUtc.js +34 -39
  1795. package/dist/utc/parse/parseHourFromUtc.d.ts +10 -10
  1796. package/dist/utc/parse/parseHourFromUtc.js +26 -27
  1797. package/dist/utc/parse/parseHttpDate.d.ts +4 -2
  1798. package/dist/utc/parse/parseHttpDate.js +86 -87
  1799. package/dist/utc/parse/parseMicrosecondFromUtc.d.ts +10 -10
  1800. package/dist/utc/parse/parseMicrosecondFromUtc.js +27 -30
  1801. package/dist/utc/parse/parseMillisecondFromUtc.d.ts +10 -10
  1802. package/dist/utc/parse/parseMillisecondFromUtc.js +26 -29
  1803. package/dist/utc/parse/parseMinuteFromUtc.d.ts +10 -10
  1804. package/dist/utc/parse/parseMinuteFromUtc.js +26 -27
  1805. package/dist/utc/parse/parseMonthFromUtc.d.ts +10 -10
  1806. package/dist/utc/parse/parseMonthFromUtc.js +26 -27
  1807. package/dist/utc/parse/parseNanosecondFromUtc.d.ts +10 -10
  1808. package/dist/utc/parse/parseNanosecondFromUtc.js +27 -30
  1809. package/dist/utc/parse/parseSecondFromUtc.d.ts +10 -10
  1810. package/dist/utc/parse/parseSecondFromUtc.js +26 -27
  1811. package/dist/utc/parse/parseTimeFromUtc.d.ts +10 -10
  1812. package/dist/utc/parse/parseTimeFromUtc.js +35 -42
  1813. package/dist/utc/parse/parseUnitFromUtc.d.ts +19 -19
  1814. package/dist/utc/parse/parseUnitFromUtc.js +62 -80
  1815. package/dist/utc/parse/parseWeekFromUtc.d.ts +19 -19
  1816. package/dist/utc/parse/parseWeekFromUtc.js +41 -46
  1817. package/dist/utc/parse/parseYearFromUtc.d.ts +10 -10
  1818. package/dist/utc/parse/parseYearFromUtc.js +28 -29
  1819. package/dist/utc/validate/index.d.ts +5 -4
  1820. package/dist/utc/validate/index.js +6 -4
  1821. package/dist/utc/validate/isValidHttpDate.d.ts +8 -3
  1822. package/dist/utc/validate/isValidHttpDate.js +6 -36
  1823. package/dist/utc/validate/isValidUtc.d.ts +6 -1
  1824. package/dist/utc/validate/isValidUtc.js +16 -43
  1825. package/dist/utc/validate/isValidUtcRange.d.ts +17 -17
  1826. package/dist/utc/validate/isValidUtcRange.js +39 -48
  1827. package/dist/utc/validate/isValidUtcTimestamp.d.ts +6 -2
  1828. package/dist/utc/validate/isValidUtcTimestamp.js +6 -45
  1829. package/dist/workforce/calculate/dutyDayFor.d.ts +4 -2
  1830. package/dist/workforce/calculate/dutyDayFor.js +61 -67
  1831. package/dist/workforce/calculate/dutyTotals.d.ts +4 -2
  1832. package/dist/workforce/calculate/dutyTotals.js +37 -37
  1833. package/dist/workforce/calculate/dutyViolations.d.ts +28 -25
  1834. package/dist/workforce/calculate/dutyViolations.js +61 -62
  1835. package/dist/workforce/calculate/evaluateDutyLog.d.ts +27 -25
  1836. package/dist/workforce/calculate/evaluateDutyLog.js +70 -71
  1837. package/dist/workforce/calculate/index.d.ts +8 -7
  1838. package/dist/workforce/calculate/index.js +9 -7
  1839. package/dist/workforce/calculate/longestRun.d.ts +8 -6
  1840. package/dist/workforce/calculate/longestRun.js +44 -49
  1841. package/dist/workforce/calculate/qualifyingRestPairs.d.ts +12 -11
  1842. package/dist/workforce/calculate/qualifyingRestPairs.js +54 -53
  1843. package/dist/workforce/calculate/qualifyingRests.d.ts +8 -6
  1844. package/dist/workforce/calculate/qualifyingRests.js +40 -44
  1845. package/dist/workforce/index.d.ts +11 -3
  1846. package/dist/workforce/index.js +11 -4
  1847. package/dist/workforce/validate/index.d.ts +2 -1
  1848. package/dist/workforce/validate/index.js +3 -1
  1849. package/dist/workforce/validate/isValidDutyLog.d.ts +1 -1
  1850. package/dist/workforce/validate/isValidDutyLog.js +32 -31
  1851. package/dist/zoned/calculate/addZoned.d.ts +23 -20
  1852. package/dist/zoned/calculate/addZoned.js +85 -89
  1853. package/dist/zoned/calculate/addZonedBusinessDays.d.ts +1 -1
  1854. package/dist/zoned/calculate/addZonedBusinessDays.js +29 -31
  1855. package/dist/zoned/calculate/clampZoned.d.ts +1 -1
  1856. package/dist/zoned/calculate/clampZoned.js +39 -46
  1857. package/dist/zoned/calculate/closestZonedTo.d.ts +1 -1
  1858. package/dist/zoned/calculate/closestZonedTo.js +43 -53
  1859. package/dist/zoned/calculate/cycleZoned.d.ts +42 -38
  1860. package/dist/zoned/calculate/cycleZoned.js +56 -56
  1861. package/dist/zoned/calculate/diffZoned.d.ts +5 -3
  1862. package/dist/zoned/calculate/diffZoned.js +98 -117
  1863. package/dist/zoned/calculate/diffZonedAsDuration.d.ts +6 -3
  1864. package/dist/zoned/calculate/diffZonedAsDuration.js +65 -69
  1865. package/dist/zoned/calculate/endOfQuarterForZoned.d.ts +11 -10
  1866. package/dist/zoned/calculate/endOfQuarterForZoned.js +41 -46
  1867. package/dist/zoned/calculate/endOfZoned.d.ts +21 -19
  1868. package/dist/zoned/calculate/endOfZoned.js +39 -40
  1869. package/dist/zoned/calculate/getHoursInZonedDay.d.ts +1 -1
  1870. package/dist/zoned/calculate/getHoursInZonedDay.js +41 -39
  1871. package/dist/zoned/calculate/getLocaleZonedDayOfWeek.d.ts +1 -1
  1872. package/dist/zoned/calculate/getLocaleZonedDayOfWeek.js +39 -38
  1873. package/dist/zoned/calculate/getLocaleZonedEndOfWeek.d.ts +11 -10
  1874. package/dist/zoned/calculate/getLocaleZonedEndOfWeek.js +57 -59
  1875. package/dist/zoned/calculate/getLocaleZonedStartOfWeek.d.ts +10 -9
  1876. package/dist/zoned/calculate/getLocaleZonedStartOfWeek.js +55 -57
  1877. package/dist/zoned/calculate/getQuarterForZoned.d.ts +1 -1
  1878. package/dist/zoned/calculate/getQuarterForZoned.js +27 -26
  1879. package/dist/zoned/calculate/index.d.ts +24 -23
  1880. package/dist/zoned/calculate/index.js +25 -23
  1881. package/dist/zoned/calculate/maxZoned.d.ts +1 -1
  1882. package/dist/zoned/calculate/maxZoned.js +35 -40
  1883. package/dist/zoned/calculate/minZoned.d.ts +1 -1
  1884. package/dist/zoned/calculate/minZoned.js +35 -40
  1885. package/dist/zoned/calculate/roundZoned.d.ts +24 -24
  1886. package/dist/zoned/calculate/roundZoned.js +69 -72
  1887. package/dist/zoned/calculate/setZoned.d.ts +32 -29
  1888. package/dist/zoned/calculate/setZoned.js +76 -82
  1889. package/dist/zoned/calculate/sortZoned.d.ts +1 -1
  1890. package/dist/zoned/calculate/sortZoned.js +37 -41
  1891. package/dist/zoned/calculate/startOfQuarterForZoned.d.ts +10 -9
  1892. package/dist/zoned/calculate/startOfQuarterForZoned.js +37 -40
  1893. package/dist/zoned/calculate/startOfZoned.d.ts +21 -19
  1894. package/dist/zoned/calculate/startOfZoned.js +34 -35
  1895. package/dist/zoned/calculate/subtractZoned.d.ts +23 -20
  1896. package/dist/zoned/calculate/subtractZoned.js +81 -84
  1897. package/dist/zoned/calculate/subtractZonedBusinessDays.d.ts +1 -1
  1898. package/dist/zoned/calculate/subtractZonedBusinessDays.js +29 -29
  1899. package/dist/zoned/chop/chopZonedDate.d.ts +1 -1
  1900. package/dist/zoned/chop/chopZonedDate.js +23 -21
  1901. package/dist/zoned/chop/chopZonedDateTime.d.ts +1 -1
  1902. package/dist/zoned/chop/chopZonedDateTime.js +23 -23
  1903. package/dist/zoned/chop/chopZonedMilliseconds.d.ts +1 -1
  1904. package/dist/zoned/chop/chopZonedMilliseconds.js +23 -23
  1905. package/dist/zoned/chop/chopZonedSeconds.d.ts +1 -1
  1906. package/dist/zoned/chop/chopZonedSeconds.js +23 -23
  1907. package/dist/zoned/chop/chopZonedTime.d.ts +1 -1
  1908. package/dist/zoned/chop/chopZonedTime.js +23 -21
  1909. package/dist/zoned/chop/chopZonedTimezone.d.ts +1 -1
  1910. package/dist/zoned/chop/chopZonedTimezone.js +23 -21
  1911. package/dist/zoned/chop/index.d.ts +7 -6
  1912. package/dist/zoned/chop/index.js +8 -6
  1913. package/dist/zoned/classify/classifyStoredZoned.d.ts +3 -2
  1914. package/dist/zoned/classify/classifyStoredZoned.js +131 -150
  1915. package/dist/zoned/classify/index.d.ts +2 -1
  1916. package/dist/zoned/classify/index.js +3 -1
  1917. package/dist/zoned/compare/areZonedEqual.d.ts +20 -4
  1918. package/dist/zoned/compare/areZonedEqual.js +51 -44
  1919. package/dist/zoned/compare/areZonedEqualBy.d.ts +13 -11
  1920. package/dist/zoned/compare/areZonedEqualBy.js +68 -77
  1921. package/dist/zoned/compare/index.d.ts +13 -12
  1922. package/dist/zoned/compare/index.js +14 -12
  1923. package/dist/zoned/compare/isAfterZoned.d.ts +1 -1
  1924. package/dist/zoned/compare/isAfterZoned.js +34 -34
  1925. package/dist/zoned/compare/isBeforeZoned.d.ts +1 -1
  1926. package/dist/zoned/compare/isBeforeZoned.js +34 -34
  1927. package/dist/zoned/compare/isBetweenZoned.d.ts +15 -15
  1928. package/dist/zoned/compare/isBetweenZoned.js +50 -68
  1929. package/dist/zoned/compare/isInDaylightSaving.d.ts +1 -1
  1930. package/dist/zoned/compare/isInDaylightSaving.js +64 -62
  1931. package/dist/zoned/compare/isZonedBusinessDay.d.ts +1 -1
  1932. package/dist/zoned/compare/isZonedBusinessDay.js +38 -36
  1933. package/dist/zoned/compare/isZonedFuture.d.ts +2 -2
  1934. package/dist/zoned/compare/isZonedFuture.js +31 -29
  1935. package/dist/zoned/compare/isZonedPast.d.ts +2 -2
  1936. package/dist/zoned/compare/isZonedPast.js +31 -29
  1937. package/dist/zoned/compare/isZonedRelativeDay.d.ts +1 -1
  1938. package/dist/zoned/compare/isZonedRelativeDay.js +39 -38
  1939. package/dist/zoned/compare/isZonedThisUnit.d.ts +1 -1
  1940. package/dist/zoned/compare/isZonedThisUnit.js +63 -69
  1941. package/dist/zoned/compare/isZonedWeekend.d.ts +1 -1
  1942. package/dist/zoned/compare/isZonedWeekend.js +42 -40
  1943. package/dist/zoned/convert/convertPlainDateTimeToZoned.d.ts +20 -19
  1944. package/dist/zoned/convert/convertPlainDateTimeToZoned.js +47 -54
  1945. package/dist/zoned/convert/convertZonedToCalendar.d.ts +3 -2
  1946. package/dist/zoned/convert/convertZonedToCalendar.js +50 -50
  1947. package/dist/zoned/convert/convertZonedToPlainDateTime.d.ts +1 -1
  1948. package/dist/zoned/convert/convertZonedToPlainDateTime.js +29 -28
  1949. package/dist/zoned/convert/convertZonedToUnix.d.ts +10 -10
  1950. package/dist/zoned/convert/convertZonedToUnix.js +35 -37
  1951. package/dist/zoned/convert/convertZonedToUtc.d.ts +1 -1
  1952. package/dist/zoned/convert/convertZonedToUtc.js +24 -23
  1953. package/dist/zoned/convert/convertZonedToZoned.d.ts +1 -1
  1954. package/dist/zoned/convert/convertZonedToZoned.js +30 -29
  1955. package/dist/zoned/convert/index.d.ts +7 -6
  1956. package/dist/zoned/convert/index.js +8 -6
  1957. package/dist/zoned/format/formatCalendarZoned.d.ts +19 -19
  1958. package/dist/zoned/format/formatCalendarZoned.js +49 -63
  1959. package/dist/zoned/format/formatRelativeZoned.d.ts +45 -43
  1960. package/dist/zoned/format/formatRelativeZoned.js +59 -75
  1961. package/dist/zoned/format/formatRfc2822.d.ts +1 -1
  1962. package/dist/zoned/format/formatRfc2822.js +55 -58
  1963. package/dist/zoned/format/formatRfc3339.d.ts +1 -1
  1964. package/dist/zoned/format/formatRfc3339.js +52 -60
  1965. package/dist/zoned/format/formatTimeZoneName.d.ts +10 -10
  1966. package/dist/zoned/format/formatTimeZoneName.js +61 -68
  1967. package/dist/zoned/format/formatZonedDateTime.d.ts +3 -2
  1968. package/dist/zoned/format/formatZonedDateTime.js +54 -61
  1969. package/dist/zoned/format/formatZonedRange.d.ts +13 -4
  1970. package/dist/zoned/format/formatZonedRange.js +100 -79
  1971. package/dist/zoned/format/formatZonedToParts.d.ts +14 -13
  1972. package/dist/zoned/format/formatZonedToParts.js +70 -77
  1973. package/dist/zoned/format/index.d.ts +9 -8
  1974. package/dist/zoned/format/index.js +10 -8
  1975. package/dist/zoned/get/getDstTransitions.d.ts +7 -7
  1976. package/dist/zoned/get/getDstTransitions.js +69 -73
  1977. package/dist/zoned/get/getSystemTimeZone.d.ts +1 -1
  1978. package/dist/zoned/get/getSystemTimeZone.js +22 -19
  1979. package/dist/zoned/get/getTimeZoneOffset.d.ts +1 -1
  1980. package/dist/zoned/get/getTimeZoneOffset.js +56 -62
  1981. package/dist/zoned/get/getTimeZones.d.ts +1 -1
  1982. package/dist/zoned/get/getTimeZones.js +19 -17
  1983. package/dist/zoned/get/getZonedAgo.d.ts +33 -0
  1984. package/dist/zoned/get/getZonedAgo.js +52 -0
  1985. package/dist/zoned/get/getZonedDay.d.ts +2 -2
  1986. package/dist/zoned/get/getZonedDay.js +24 -22
  1987. package/dist/zoned/get/getZonedDayOfWeek.d.ts +2 -2
  1988. package/dist/zoned/get/getZonedDayOfWeek.js +25 -24
  1989. package/dist/zoned/get/getZonedHour.d.ts +2 -2
  1990. package/dist/zoned/get/getZonedHour.js +24 -22
  1991. package/dist/zoned/get/getZonedIn.d.ts +33 -0
  1992. package/dist/zoned/get/getZonedIn.js +52 -0
  1993. package/dist/zoned/get/getZonedMicrosecond.d.ts +2 -2
  1994. package/dist/zoned/get/getZonedMicrosecond.js +24 -24
  1995. package/dist/zoned/get/getZonedMillisecond.d.ts +2 -2
  1996. package/dist/zoned/get/getZonedMillisecond.js +24 -22
  1997. package/dist/zoned/get/getZonedMinute.d.ts +2 -2
  1998. package/dist/zoned/get/getZonedMinute.js +24 -22
  1999. package/dist/zoned/get/getZonedMonth.d.ts +2 -2
  2000. package/dist/zoned/get/getZonedMonth.js +24 -22
  2001. package/dist/zoned/get/getZonedNanosecond.d.ts +2 -2
  2002. package/dist/zoned/get/getZonedNanosecond.js +24 -24
  2003. package/dist/zoned/get/getZonedNow.d.ts +10 -10
  2004. package/dist/zoned/get/getZonedNow.js +40 -51
  2005. package/dist/zoned/get/getZonedNowUnit.d.ts +3 -3
  2006. package/dist/zoned/get/getZonedNowUnit.js +52 -53
  2007. package/dist/zoned/get/getZonedSecond.d.ts +2 -2
  2008. package/dist/zoned/get/getZonedSecond.js +24 -22
  2009. package/dist/zoned/get/getZonedToday.d.ts +2 -2
  2010. package/dist/zoned/get/getZonedToday.js +24 -24
  2011. package/dist/zoned/get/getZonedWeekOfYear.d.ts +2 -2
  2012. package/dist/zoned/get/getZonedWeekOfYear.js +25 -24
  2013. package/dist/zoned/get/getZonedYear.d.ts +2 -2
  2014. package/dist/zoned/get/getZonedYear.js +27 -25
  2015. package/dist/zoned/get/index.d.ts +21 -18
  2016. package/dist/zoned/get/index.js +22 -18
  2017. package/dist/zoned/index.d.ts +134 -12
  2018. package/dist/zoned/index.js +127 -13
  2019. package/dist/zoned/interval/index.d.ts +20 -18
  2020. package/dist/zoned/interval/index.js +21 -18
  2021. package/dist/zoned/interval/intervalAbutsZoned.d.ts +1 -1
  2022. package/dist/zoned/interval/intervalAbutsZoned.js +65 -70
  2023. package/dist/zoned/interval/intervalContainsZoned.d.ts +1 -1
  2024. package/dist/zoned/interval/intervalContainsZoned.js +69 -75
  2025. package/dist/zoned/interval/intervalCountZoned.d.ts +1 -1
  2026. package/dist/zoned/interval/intervalCountZoned.js +68 -83
  2027. package/dist/zoned/interval/intervalDifferenceZoned.d.ts +12 -12
  2028. package/dist/zoned/interval/intervalDifferenceZoned.js +76 -79
  2029. package/dist/zoned/interval/intervalDivideEquallyZoned.d.ts +20 -20
  2030. package/dist/zoned/interval/intervalDivideEquallyZoned.js +78 -98
  2031. package/dist/zoned/interval/intervalEngulfsZoned.d.ts +1 -1
  2032. package/dist/zoned/interval/intervalEngulfsZoned.js +63 -68
  2033. package/dist/zoned/interval/intervalFromDurationZoned.d.ts +33 -31
  2034. package/dist/zoned/interval/intervalFromDurationZoned.js +84 -90
  2035. package/dist/zoned/interval/intervalIntersectionZoned.d.ts +12 -12
  2036. package/dist/zoned/interval/intervalIntersectionZoned.js +75 -80
  2037. package/dist/zoned/interval/intervalLengthZoned.d.ts +1 -1
  2038. package/dist/zoned/interval/intervalLengthZoned.js +60 -73
  2039. package/dist/zoned/interval/intervalOverlappingDaysZoned.d.ts +1 -1
  2040. package/dist/zoned/interval/intervalOverlappingDaysZoned.js +88 -98
  2041. package/dist/zoned/interval/intervalSplitAtZoned.d.ts +12 -12
  2042. package/dist/zoned/interval/intervalSplitAtZoned.js +84 -91
  2043. package/dist/zoned/interval/intervalUnionZoned.d.ts +12 -12
  2044. package/dist/zoned/interval/intervalUnionZoned.js +77 -81
  2045. package/dist/zoned/interval/intervalXorAllZoned.d.ts +14 -14
  2046. package/dist/zoned/interval/intervalXorAllZoned.js +60 -73
  2047. package/dist/zoned/interval/intervalXorZoned.d.ts +12 -12
  2048. package/dist/zoned/interval/intervalXorZoned.js +81 -87
  2049. package/dist/zoned/interval/intervalsOverlapZoned.d.ts +1 -1
  2050. package/dist/zoned/interval/intervalsOverlapZoned.js +63 -68
  2051. package/dist/zoned/interval/mergeIntervalsZoned.d.ts +14 -14
  2052. package/dist/zoned/interval/mergeIntervalsZoned.js +64 -76
  2053. package/dist/zoned/interval/splitIntervalByUnitZoned.d.ts +20 -20
  2054. package/dist/zoned/interval/splitIntervalByUnitZoned.js +92 -112
  2055. package/dist/zoned/interval/validate/index.d.ts +3 -2
  2056. package/dist/zoned/interval/validate/index.js +4 -2
  2057. package/dist/zoned/interval/validate/isValidCalendarZonedInterval.d.ts +1 -1
  2058. package/dist/zoned/interval/validate/isValidCalendarZonedInterval.js +46 -45
  2059. package/dist/zoned/interval/validate/isValidZonedInterval.d.ts +1 -1
  2060. package/dist/zoned/interval/validate/isValidZonedInterval.js +37 -36
  2061. package/dist/zoned/map/index.d.ts +3 -2
  2062. package/dist/zoned/map/index.js +4 -2
  2063. package/dist/zoned/map/mapZonedDatesInRange.d.ts +12 -10
  2064. package/dist/zoned/map/mapZonedDatesInRange.js +66 -86
  2065. package/dist/zoned/map/mapZonedHoursInDay.d.ts +1 -1
  2066. package/dist/zoned/map/mapZonedHoursInDay.js +36 -36
  2067. package/dist/zoned/parse/getZonedOffset.d.ts +1 -1
  2068. package/dist/zoned/parse/getZonedOffset.js +28 -27
  2069. package/dist/zoned/parse/getZonedOffsetAs.d.ts +1 -1
  2070. package/dist/zoned/parse/getZonedOffsetAs.js +41 -45
  2071. package/dist/zoned/parse/index.d.ts +21 -20
  2072. package/dist/zoned/parse/index.js +22 -20
  2073. package/dist/zoned/parse/parseDateFromZoned.d.ts +1 -1
  2074. package/dist/zoned/parse/parseDateFromZoned.js +24 -24
  2075. package/dist/zoned/parse/parseDateTimeFromZoned.d.ts +1 -1
  2076. package/dist/zoned/parse/parseDateTimeFromZoned.js +24 -23
  2077. package/dist/zoned/parse/parseDayFromZoned.d.ts +1 -1
  2078. package/dist/zoned/parse/parseDayFromZoned.js +24 -24
  2079. package/dist/zoned/parse/parseDayOfWeekFromZoned.d.ts +1 -1
  2080. package/dist/zoned/parse/parseDayOfWeekFromZoned.js +25 -25
  2081. package/dist/zoned/parse/parseHourFromZoned.d.ts +1 -1
  2082. package/dist/zoned/parse/parseHourFromZoned.js +24 -24
  2083. package/dist/zoned/parse/parseMicrosecondFromZoned.d.ts +1 -1
  2084. package/dist/zoned/parse/parseMicrosecondFromZoned.js +25 -25
  2085. package/dist/zoned/parse/parseMillisecondFromZoned.d.ts +1 -1
  2086. package/dist/zoned/parse/parseMillisecondFromZoned.js +24 -24
  2087. package/dist/zoned/parse/parseMinuteFromZoned.d.ts +1 -1
  2088. package/dist/zoned/parse/parseMinuteFromZoned.js +24 -24
  2089. package/dist/zoned/parse/parseMonthFromZoned.d.ts +1 -1
  2090. package/dist/zoned/parse/parseMonthFromZoned.js +24 -24
  2091. package/dist/zoned/parse/parseNanosecondFromZoned.d.ts +1 -1
  2092. package/dist/zoned/parse/parseNanosecondFromZoned.js +25 -25
  2093. package/dist/zoned/parse/parseRfc2822.d.ts +1 -1
  2094. package/dist/zoned/parse/parseRfc2822.js +66 -69
  2095. package/dist/zoned/parse/parseRfc3339.d.ts +1 -1
  2096. package/dist/zoned/parse/parseRfc3339.js +44 -45
  2097. package/dist/zoned/parse/parseSecondFromZoned.d.ts +1 -1
  2098. package/dist/zoned/parse/parseSecondFromZoned.js +24 -24
  2099. package/dist/zoned/parse/parseTimeFromZoned.d.ts +1 -1
  2100. package/dist/zoned/parse/parseTimeFromZoned.js +24 -24
  2101. package/dist/zoned/parse/parseTimeZoneFromZoned.d.ts +1 -1
  2102. package/dist/zoned/parse/parseTimeZoneFromZoned.js +24 -23
  2103. package/dist/zoned/parse/parseUnitFromZoned.d.ts +11 -11
  2104. package/dist/zoned/parse/parseUnitFromZoned.js +73 -93
  2105. package/dist/zoned/parse/parseWeekFromZoned.d.ts +10 -10
  2106. package/dist/zoned/parse/parseWeekFromZoned.js +44 -49
  2107. package/dist/zoned/parse/parseYearFromZoned.d.ts +1 -1
  2108. package/dist/zoned/parse/parseYearFromZoned.js +27 -26
  2109. package/dist/zoned/validate/hasDaylightSaving.d.ts +10 -10
  2110. package/dist/zoned/validate/hasDaylightSaving.js +59 -62
  2111. package/dist/zoned/validate/index.d.ts +8 -7
  2112. package/dist/zoned/validate/index.js +9 -7
  2113. package/dist/zoned/validate/isValidCalendarZonedDateTime.d.ts +7 -2
  2114. package/dist/zoned/validate/isValidCalendarZonedDateTime.js +12 -55
  2115. package/dist/zoned/validate/isValidRfc2822DateTime.d.ts +7 -2
  2116. package/dist/zoned/validate/isValidRfc2822DateTime.js +6 -33
  2117. package/dist/zoned/validate/isValidRfc3339DateTime.d.ts +7 -2
  2118. package/dist/zoned/validate/isValidRfc3339DateTime.js +6 -32
  2119. package/dist/zoned/validate/isValidTimeZone.d.ts +6 -1
  2120. package/dist/zoned/validate/isValidTimeZone.js +6 -33
  2121. package/dist/zoned/validate/isValidZonedDateTime.d.ts +7 -2
  2122. package/dist/zoned/validate/isValidZonedDateTime.js +14 -57
  2123. package/dist/zoned/validate/isValidZonedRange.d.ts +17 -17
  2124. package/dist/zoned/validate/isValidZonedRange.js +51 -64
  2125. package/package.json +67 -9
  2126. package/skills/gmt-arithmetic/SKILL.md +94 -13
  2127. package/skills/gmt-basics/SKILL.md +42 -8
  2128. package/skills/gmt-gnss/SKILL.md +1 -1
  2129. package/skills/gmt-integration/SKILL.md +61 -28
  2130. package/skills/gmt-intermodal/SKILL.md +3 -1
  2131. package/skills/gmt-timezone/SKILL.md +64 -6
  2132. package/skills/gmt-transport/SKILL.md +1 -1
  2133. package/skills/gmt-workforce/SKILL.md +1 -1
@@ -1,97 +1,91 @@
1
- import { isoDateString } from "../../internal/epochDay.js";
2
1
  import { Temporal } from "../../internal/temporal.js";
3
- import { frameZoned, instantFrom, parseFreeDays, parseFreeTimeTerms, walkFreeTime, zoneFrame, } from "../../internal/index.js";
2
+ import { isoDateString } from "../../internal/epochDay.js";
3
+ import { instantFrom } from "../../internal/instantNanoseconds.js";
4
+ import { frameZoned, zoneFrame } from "../../internal/zoneFrame.js";
5
+ import { parseFreeDays, parseFreeTimeTerms, walkFreeTime } from "../../internal/freeTimeLedger.js";
4
6
  import { isValidInstant } from "../../precision/validate/isValidInstant.js";
7
+
8
+ // src/intermodal/calculate/freeTimeExpiry.ts
5
9
  /**
6
- * Lay out a container's free time from the instant its clock started, and say when it ends.
7
- *
8
- * Free time is the money calculation in container logistics, and none of its terms is a fact
9
- * about the port: the number of free days, whether the day of discharge is free day one, and
10
- * whether weekends count are all set by the carrier's tariff or the service contract. So every
11
- * term is a parameter. No regulation or industry standard fixes how free time is counted (DCSA types only its unit: calendar days, working days, hours or day of discharge; GMT counts
12
- * days); the result is the window every tariff states, and what an invoice can print about it:
13
- * the free time allowed and the dates it starts and ends.
14
- *
15
- * - **Days are the terminal's local days.** `clockStart` is an instant (`Z`, an offset, or a
16
- * bracketed zone, of which only the instant is read, a minute-rounded offset as the zone's
17
- * real one, as `isValidInstant` describes); its local date in `options.timeZone` is the
18
- * event day. A container discharged at 23:00 has used a free day by 00:01 under
19
- * `firstDay: "eventDay"`. Day boundaries are the zone's real ones, as `floorToZone` and
20
- * `dwellTime` find them: a 23- or 25-hour day is one day, a date the zone deleted is never a
21
- * free day, and a fall-back that re-enters an earlier date never moves the count backwards.
22
- * - **`firstDay` has no default.** `"eventDay"` makes the event day free day one; `"nextDay"`
23
- * starts free time on the following counted day. The two differ by exactly one day of charges,
24
- * and a silent default here is a wrong invoice, so omitting it returns `null`.
25
- * - **`basis` decides which days count.** `"calendar"` counts every local day, so a weekend
26
- * burns two free days while the terminal is shut. `"working"` counts only the working days of
27
- * `options.calendar` (its weekend and holidays; `calendar.timeZone` is not read), and is
28
- * required to have one: a working-day count without a calendar is a guess and returns `null`.
29
- * Under `"working"` a Saturday discharge starts free time on Monday under either `firstDay`.
30
- * A tariff counting "calendar days excluding bank holidays" (Hapag-Lloyd Japan, MSC Vietnam) is
31
- * `"working"` with an empty `weekend`. How days after expiry are charged is a separate term;
32
- * see `chargeableDays`'s `chargeBasis`.
33
- * - **`expiresAt` is half-open.** It is the first instant of the local day after `lastFreeDay`,
34
- * as a UTC instant. A gate-out at exactly `expiresAt` is not a chargeable day; see
35
- * `chargeableDays`. Under `"working"` it can fall on a weekend, which is then simply not
36
- * chargeable.
37
- * - `freeDays` is a whole number of at least `1`: with no free days there is no last free day
38
- * to name, and `chargeableDays` accepts `0` for that tariff.
39
- * - Returns `null` when `clockStart` is not an instant, `freeDays` is not a whole number of at
40
- * least `1`, `options` is not an object, `basis` or `firstDay` is missing or unknown,
41
- * `timeZone` is invalid, `basis` is `"working"` without a valid `BusinessCalendar`, or the walk
42
- * would pass 10,000 local days.
43
- * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
44
- * moved by its seconds, and the moved instant must be inside Temporal's range. So within the
45
- * offset's seconds (under a minute) of the last instant Temporal supports
46
- * (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
47
- * (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
48
- * such limit.
49
- *
50
- * @param clockStart ISO 8601 instant string of the event that starts the clock (discharge, availability or gate-out)
51
- * @param freeDays whole number of free days the tariff allows, at least 1
52
- * @param options The tariff's counting terms: which days count, in which zone, and where day one starts
53
- * @returns the free-time start and last free day as local dates, and the expiry instant, or null on invalid input
54
- *
55
- * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "calendar", timeZone: "America/Port_of_Spain", firstDay: "eventDay" }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-16", expiresAt: "2024-06-17T04:00:00Z" } (a Friday discharge: the weekend is consumed)
56
- * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "calendar", timeZone: "America/Port_of_Spain", firstDay: "nextDay" }) // { freeTimeStart: "2024-06-15", lastFreeDay: "2024-06-17", expiresAt: "2024-06-18T04:00:00Z" } (the same tariff read the other way: one more day)
57
- * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "working", timeZone: "America/Port_of_Spain", firstDay: "eventDay", calendar: { weekend: [6, 7], holidays: [], timeZone: "America/Port_of_Spain" } }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-18", expiresAt: "2024-06-19T04:00:00Z" } (Friday, Monday, Tuesday: the weekend does not count)
58
- * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "working", timeZone: "America/Port_of_Spain", firstDay: "eventDay", calendar: { weekend: [6, 7], holidays: ["2024-06-17"], timeZone: "America/Port_of_Spain" } }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-19", expiresAt: "2024-06-20T04:00:00Z" } (a terminal holiday on the Monday moves expiry a day)
59
- * @example freeTimeExpiry("2024-06-15T14:00:00Z", 2, { basis: "working", timeZone: "America/Port_of_Spain", firstDay: "eventDay", calendar: { weekend: [6, 7], holidays: [], timeZone: "America/Port_of_Spain" } }) // { freeTimeStart: "2024-06-17", lastFreeDay: "2024-06-18", expiresAt: "2024-06-19T04:00:00Z" } (a Saturday discharge: free time starts Monday)
60
- * @example freeTimeExpiry("2024-06-15T03:00:00Z", 1, { basis: "calendar", timeZone: "America/Port_of_Spain", firstDay: "eventDay" }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-14", expiresAt: "2024-06-15T04:00:00Z" } (23:00 local on the 14th: the free day is over an hour later)
61
- * @example freeTimeExpiry("2024-09-07T15:00:00Z", 1, { basis: "calendar", timeZone: "America/Santiago", firstDay: "eventDay" }) // { freeTimeStart: "2024-09-07", lastFreeDay: "2024-09-07", expiresAt: "2024-09-08T04:00:00Z" } (Santiago skipped midnight on the 8th, so the day starts at 01:00)
62
- * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "calendar", timeZone: "Europe/London" }) // null (firstDay has no default)
63
- * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "working", timeZone: "Asia/Tokyo", firstDay: "eventDay" }) // null (a working-day count needs the terminal's calendar)
64
- * @example freeTimeExpiry("2024-06-14T19:00:00Z", 0, { basis: "calendar", timeZone: "Australia/Sydney", firstDay: "eventDay" }) // null (no free days means no last free day)
65
- * @example freeTimeExpiry("2024-06-14T19:00:00", 3, { basis: "calendar", timeZone: "Asia/Kolkata", firstDay: "eventDay" }) // null (no offset: not an instant)
66
- * @example freeTimeExpiry("1970-01-01T00:30:00Z", 3, { basis: "calendar", firstDay: "eventDay", timeZone: "-00:44:30" }) // { freeTimeStart: "1969-12-31", lastFreeDay: "1970-01-02", expiresAt: "1970-01-03T00:44:30Z" }
67
- */
68
- export function freeTimeExpiry(clockStart, freeDays, options) {
69
- try {
70
- const terms = parseFreeTimeTerms(options);
71
- const allowed = parseFreeDays(freeDays, 1);
72
- const frame = terms === null ? null : zoneFrame(terms.timeZone);
73
- if (!isValidInstant(clockStart) ||
74
- terms === null ||
75
- frame === null ||
76
- allowed === null) {
77
- return null;
78
- }
79
- const start = frameZoned(instantFrom(clockStart), frame);
80
- const ledger = walkFreeTime(start, allowed, terms);
81
- if (ledger === null ||
82
- ledger.firstFree === null ||
83
- ledger.lastFree === null) {
84
- return null;
85
- }
86
- return {
87
- freeTimeStart: isoDateString(ledger.firstFree),
88
- lastFreeDay: isoDateString(ledger.lastFree),
89
- expiresAt: Temporal.Instant.fromEpochNanoseconds(ledger.expiresAtNs).toString(),
90
- };
91
- }
92
- catch {
93
- // Never throws (Core Rule 3): a hostile
94
- // argument is invalid input, not an exception.
95
- return null;
96
- }
10
+ * Lay out a container's free time from the instant its clock started, and say when it ends.
11
+ *
12
+ * Free time is the money calculation in container logistics, and none of its terms is a fact
13
+ * about the port: the number of free days, whether the day of discharge is free day one, and
14
+ * whether weekends count are all set by the carrier's tariff or the service contract. So every
15
+ * term is a parameter. No regulation or industry standard fixes how free time is counted (DCSA types only its unit: calendar days, working days, hours or day of discharge; GMT counts
16
+ * days); the result is the window every tariff states, and what an invoice can print about it:
17
+ * the free time allowed and the dates it starts and ends.
18
+ *
19
+ * - **Days are the terminal's local days.** `clockStart` is an instant (`Z`, an offset, or a
20
+ * bracketed zone, of which only the instant is read, a minute-rounded offset as the zone's
21
+ * real one, as `isValidInstant` describes); its local date in `options.timeZone` is the
22
+ * event day. A container discharged at 23:00 has used a free day by 00:01 under
23
+ * `firstDay: "eventDay"`. Day boundaries are the zone's real ones, as `floorToZone` and
24
+ * `dwellTime` find them: a 23- or 25-hour day is one day, a date the zone deleted is never a
25
+ * free day, and a fall-back that re-enters an earlier date never moves the count backwards.
26
+ * - **`firstDay` has no default.** `"eventDay"` makes the event day free day one; `"nextDay"`
27
+ * starts free time on the following counted day. The two differ by exactly one day of charges,
28
+ * and a silent default here is a wrong invoice, so omitting it returns `null`.
29
+ * - **`basis` decides which days count.** `"calendar"` counts every local day, so a weekend
30
+ * burns two free days while the terminal is shut. `"working"` counts only the working days of
31
+ * `options.calendar` (its weekend and holidays; `calendar.timeZone` is not read), and is
32
+ * required to have one: a working-day count without a calendar is a guess and returns `null`.
33
+ * Under `"working"` a Saturday discharge starts free time on Monday under either `firstDay`.
34
+ * A tariff counting "calendar days excluding bank holidays" (Hapag-Lloyd Japan, MSC Vietnam) is
35
+ * `"working"` with an empty `weekend`. How days after expiry are charged is a separate term;
36
+ * see `chargeableDays`'s `chargeBasis`.
37
+ * - **`expiresAt` is half-open.** It is the first instant of the local day after `lastFreeDay`,
38
+ * as a UTC instant. A gate-out at exactly `expiresAt` is not a chargeable day; see
39
+ * `chargeableDays`. Under `"working"` it can fall on a weekend, which is then simply not
40
+ * chargeable.
41
+ * - `freeDays` is a whole number of at least `1`: with no free days there is no last free day
42
+ * to name, and `chargeableDays` accepts `0` for that tariff.
43
+ * - Returns `null` when `clockStart` is not an instant, `freeDays` is not a whole number of at
44
+ * least `1`, `options` is not an object, `basis` or `firstDay` is missing or unknown,
45
+ * `timeZone` is invalid, `basis` is `"working"` without a valid `BusinessCalendar`, or the walk
46
+ * would pass 10,000 local days.
47
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
48
+ * moved by its seconds, and the moved instant must be inside Temporal's range. So within the
49
+ * offset's seconds (under a minute) of the last instant Temporal supports
50
+ * (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
51
+ * (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
52
+ * such limit.
53
+ *
54
+ * @param clockStart ISO 8601 instant string of the event that starts the clock (discharge, availability or gate-out)
55
+ * @param freeDays whole number of free days the tariff allows, at least 1
56
+ * @param options The tariff's counting terms: which days count, in which zone, and where day one starts
57
+ * @returns the free-time start and last free day as local dates, and the expiry instant, or null on invalid input
58
+ *
59
+ * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "calendar", timeZone: "America/Port_of_Spain", firstDay: "eventDay" }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-16", expiresAt: "2024-06-17T04:00:00Z" } (a Friday discharge: the weekend is consumed)
60
+ * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "calendar", timeZone: "America/Port_of_Spain", firstDay: "nextDay" }) // { freeTimeStart: "2024-06-15", lastFreeDay: "2024-06-17", expiresAt: "2024-06-18T04:00:00Z" } (the same tariff read the other way: one more day)
61
+ * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "working", timeZone: "America/Port_of_Spain", firstDay: "eventDay", calendar: { weekend: [6, 7], holidays: [], timeZone: "America/Port_of_Spain" } }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-18", expiresAt: "2024-06-19T04:00:00Z" } (Friday, Monday, Tuesday: the weekend does not count)
62
+ * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "working", timeZone: "America/Port_of_Spain", firstDay: "eventDay", calendar: { weekend: [6, 7], holidays: ["2024-06-17"], timeZone: "America/Port_of_Spain" } }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-19", expiresAt: "2024-06-20T04:00:00Z" } (a terminal holiday on the Monday moves expiry a day)
63
+ * @example freeTimeExpiry("2024-06-15T14:00:00Z", 2, { basis: "working", timeZone: "America/Port_of_Spain", firstDay: "eventDay", calendar: { weekend: [6, 7], holidays: [], timeZone: "America/Port_of_Spain" } }) // { freeTimeStart: "2024-06-17", lastFreeDay: "2024-06-18", expiresAt: "2024-06-19T04:00:00Z" } (a Saturday discharge: free time starts Monday)
64
+ * @example freeTimeExpiry("2024-06-15T03:00:00Z", 1, { basis: "calendar", timeZone: "America/Port_of_Spain", firstDay: "eventDay" }) // { freeTimeStart: "2024-06-14", lastFreeDay: "2024-06-14", expiresAt: "2024-06-15T04:00:00Z" } (23:00 local on the 14th: the free day is over an hour later)
65
+ * @example freeTimeExpiry("2024-09-07T15:00:00Z", 1, { basis: "calendar", timeZone: "America/Santiago", firstDay: "eventDay" }) // { freeTimeStart: "2024-09-07", lastFreeDay: "2024-09-07", expiresAt: "2024-09-08T04:00:00Z" } (Santiago skipped midnight on the 8th, so the day starts at 01:00)
66
+ * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "calendar", timeZone: "Europe/London" }) // null (firstDay has no default)
67
+ * @example freeTimeExpiry("2024-06-14T19:00:00Z", 3, { basis: "working", timeZone: "Asia/Tokyo", firstDay: "eventDay" }) // null (a working-day count needs the terminal's calendar)
68
+ * @example freeTimeExpiry("2024-06-14T19:00:00Z", 0, { basis: "calendar", timeZone: "Australia/Sydney", firstDay: "eventDay" }) // null (no free days means no last free day)
69
+ * @example freeTimeExpiry("2024-06-14T19:00:00", 3, { basis: "calendar", timeZone: "Asia/Kolkata", firstDay: "eventDay" }) // null (no offset: not an instant)
70
+ * @example freeTimeExpiry("1970-01-01T00:30:00Z", 3, { basis: "calendar", firstDay: "eventDay", timeZone: "-00:44:30" }) // { freeTimeStart: "1969-12-31", lastFreeDay: "1970-01-02", expiresAt: "1970-01-03T00:44:30Z" }
71
+ */
72
+ function freeTimeExpiry(clockStart, freeDays, options) {
73
+ try {
74
+ const terms = parseFreeTimeTerms(options);
75
+ const allowed = parseFreeDays(freeDays, 1);
76
+ const frame = terms === null ? null : zoneFrame(terms.timeZone);
77
+ if (!isValidInstant(clockStart) || terms === null || frame === null || allowed === null) return null;
78
+ const start = frameZoned(instantFrom(clockStart), frame);
79
+ const ledger = walkFreeTime(start, allowed, terms);
80
+ if (ledger === null || ledger.firstFree === null || ledger.lastFree === null) return null;
81
+ return {
82
+ freeTimeStart: isoDateString(ledger.firstFree),
83
+ lastFreeDay: isoDateString(ledger.lastFree),
84
+ expiresAt: Temporal.Instant.fromEpochNanoseconds(ledger.expiresAtNs).toString()
85
+ };
86
+ } catch {
87
+ return null;
88
+ }
97
89
  }
90
+
91
+ export { freeTimeExpiry };
@@ -1,5 +1,6 @@
1
- export * from "./billingTimeline.js";
2
- export * from "./chargeableDays.js";
3
- export * from "./demurrageClock.js";
4
- export * from "./freeTimeExpiry.js";
5
- export * from "./multimodalETA.js";
1
+ import { BillingDates, BillingDeadlines, BillingWindows, billingTimeline } from "./billingTimeline.js";
2
+ import { FreeTimeChargeOptions, FreeTimeCharges, TierBand, chargeableDays } from "./chargeableDays.js";
3
+ import { ClockDirection, ClockEvent, ClockEventType, ClockOptions, ClockScope, ClockStartEvent, demurrageClock } from "./demurrageClock.js";
4
+ import { FreeTime, freeTimeExpiry } from "./freeTimeExpiry.js";
5
+ import { MultimodalJourney, multimodalETA } from "./multimodalETA.js";
6
+ export { BillingDates, BillingDeadlines, BillingWindows, ClockDirection, ClockEvent, ClockEventType, ClockOptions, ClockScope, ClockStartEvent, FreeTime, FreeTimeChargeOptions, FreeTimeCharges, MultimodalJourney, TierBand, billingTimeline, chargeableDays, demurrageClock, freeTimeExpiry, multimodalETA };
@@ -1,5 +1,7 @@
1
- export * from "./billingTimeline.js";
2
- export * from "./chargeableDays.js";
3
- export * from "./demurrageClock.js";
4
- export * from "./freeTimeExpiry.js";
5
- export * from "./multimodalETA.js";
1
+ import { billingTimeline } from "./billingTimeline.js";
2
+ import { chargeableDays } from "./chargeableDays.js";
3
+ import { demurrageClock } from "./demurrageClock.js";
4
+ import { freeTimeExpiry } from "./freeTimeExpiry.js";
5
+ import { multimodalETA } from "./multimodalETA.js";
6
+
7
+ export { billingTimeline, chargeableDays, demurrageClock, freeTimeExpiry, multimodalETA };
@@ -1,21 +1,21 @@
1
- import { type Leg, type ScheduleDeliveryOptions } from "../../transport/calculate/scheduleDelivery.js";
1
+ import { Leg, ScheduleDeliveryOptions } from "../../transport/calculate/scheduleDelivery.js";
2
2
  /** What `multimodalETA` returns: the end-to-end ETA, with the time moving and the time waiting kept apart. */
3
3
  export interface MultimodalJourney {
4
- /** The last leg's arrival rendered in its `timeZone`, as `scheduleDelivery` gives it. `""` only for an empty legs array. */
5
- eta: string;
6
- /** The number of legs in the journey. */
7
- totalLegs: number;
8
- /**
9
- * The time the cargo spent moving: every leg's `duration` added up, as an ISO 8601 duration of
10
- * elapsed time with hours as the largest unit.
11
- */
12
- totalTransit: string;
13
- /**
14
- * The time the cargo spent at the handoffs between legs: each leg's departure minus the previous
15
- * leg's arrival, added up, in the same form as `totalTransit`. It includes any wait for a
16
- * scheduled departure on top of the handoff's `dwellAfter`.
17
- */
18
- totalDwell: string;
4
+ /** The last leg's arrival rendered in its `timeZone`, as `scheduleDelivery` gives it. `""` only for an empty legs array. */
5
+ eta: string;
6
+ /** The number of legs in the journey. */
7
+ totalLegs: number;
8
+ /**
9
+ * The time the cargo spent moving: every leg's `duration` added up, as an ISO 8601 duration of
10
+ * elapsed time with hours as the largest unit.
11
+ */
12
+ totalTransit: string;
13
+ /**
14
+ * The time the cargo spent at the handoffs between legs: each leg's departure minus the previous
15
+ * leg's arrival, added up, in the same form as `totalTransit`. It includes any wait for a
16
+ * scheduled departure on top of the handoff's `dwellAfter`.
17
+ */
18
+ totalDwell: string;
19
19
  }
20
20
  /**
21
21
  * Compute an end-to-end ETA across the legs of a multimodal move, and report the time in transit
@@ -73,4 +73,4 @@ export interface MultimodalJourney {
73
73
  * @example multimodalETA([{ departure: "2024-06-15T10:00:00Z", duration: "P1M", timeZone: "UTC" }]) // null (calendar units have no exact length)
74
74
  * @example multimodalETA("legs") // null
75
75
  */
76
- export declare function multimodalETA(legs: Leg[], options?: ScheduleDeliveryOptions): MultimodalJourney | null;
76
+ export declare function multimodalETA(legs: Leg[], options?: ScheduleDeliveryOptions): MultimodalJourney | null;
@@ -1,145 +1,121 @@
1
1
  import { Temporal } from "../../internal/temporal.js";
2
- import { exactDurationNanoseconds } from "../../internal/index.js";
3
- import { formatHourDuration } from "../../internal/hourDurationString.js";
4
- import { scheduleDelivery, } from "../../transport/calculate/scheduleDelivery.js";
5
2
  import { isObject } from "../../internal/isObject.js";
3
+ import { exactDurationNanoseconds } from "../../internal/exactDuration.js";
4
+ import { formatHourDuration } from "../../internal/hourDurationString.js";
5
+ import { scheduleDelivery } from "../../transport/calculate/scheduleDelivery.js";
6
+
7
+ // src/intermodal/calculate/multimodalETA.ts
8
+ const LEG_KEYS = Object.keys({
9
+ departure: true,
10
+ duration: true,
11
+ timeZone: true,
12
+ dwellAfter: true,
13
+ mode: true,
14
+ origin: true,
15
+ destination: true
16
+ });
6
17
  /**
7
- * Every field of a `Leg`, each read once into a plain copy. Typed as a record of `keyof Leg`, so a
8
- * field added to `Leg` and missing here, or a key here that `Leg` does not have, fails to compile
9
- * rather than being dropped from the copy.
10
- */
11
- const LEG_FIELDS = {
12
- departure: true,
13
- duration: true,
14
- timeZone: true,
15
- dwellAfter: true,
16
- mode: true,
17
- origin: true,
18
- destination: true,
19
- };
20
- const LEG_KEYS = Object.keys(LEG_FIELDS);
21
- /**
22
- * A plain copy of one leg with every field read exactly once, so the schedule and the totals are
23
- * computed from the same values even when a field is a getter. An undefined field stays absent,
24
- * which `scheduleDelivery` reads as omitted either way. A leg that is not an object is passed
25
- * through for `scheduleDelivery` to refuse.
26
- */
18
+ * A plain copy of one leg with every field read exactly once, so the schedule and the totals are
19
+ * computed from the same values even when a field is a getter. An undefined field stays absent,
20
+ * which `scheduleDelivery` reads as omitted either way. A leg that is not an object is passed
21
+ * through for `scheduleDelivery` to refuse.
22
+ */
27
23
  function snapshotLeg(leg) {
28
- if (!isObject(leg)) {
29
- return leg;
30
- }
31
- const copy = {};
32
- for (const key of LEG_KEYS) {
33
- const value = Reflect.get(leg, key);
34
- if (value !== undefined) {
35
- copy[key] = value;
36
- }
37
- }
38
- return copy;
24
+ if (!isObject(leg)) return leg;
25
+ const copy = {};
26
+ for (const key of LEG_KEYS) {
27
+ const value = Reflect.get(leg, key);
28
+ if (value !== void 0) copy[key] = value;
29
+ }
30
+ return copy;
39
31
  }
40
32
  /**
41
- * Compute an end-to-end ETA across the legs of a multimodal move, and report the time in transit
42
- * and the time in dwell separately.
43
- *
44
- * A truck→ship→rail move spends its time two ways: moving, and sitting at a handoff. The two are
45
- * forecast differently and fail differently, so one opaque total hides the part a planner needs.
46
- * `multimodalETA` schedules the legs with `scheduleDelivery` and splits the elapsed time from the
47
- * first departure to the ETA into the two.
48
- *
49
- * - **The legs are `scheduleDelivery`'s.** Each leg's arrival plus its `dwellAfter` is the next
50
- * leg's departure unless the next leg names a scheduled `departure`; a scheduled departure
51
- * inside the dwell is a missed connection. Departures, zones and every validity rule are that
52
- * function's, and `eta` is its `eta`.
53
- * - **Local-time resolution policy (`"compatible"`), as `scheduleDelivery` applies it.** A zoneless
54
- * first departure read in `startTimeZone`, a zoneless later-leg departure read in the previous
55
- * leg's `timeZone`, and a zoned departure written without an offset are wall times. An
56
- * **ambiguous** one (a fall-back hour the clock ran through twice) resolves to the **earlier**
57
- * instant and a **nonexistent** one (a spring-forward hour the clock skipped) to the **later**
58
- * instant, except that on any leg but the first a repeated hour takes the earliest pass at or
59
- * after the previous arrival plus its dwell, the first the cargo can catch. Write the offset to
60
- * pick a pass yourself.
61
- * - **`totalTransit` is every leg's `duration` added up.** Durations are exact time: a day is 24
62
- * hours, and years, months and weeks return `null`. The sum is elapsed time, so a leg across a
63
- * DST change counts the hours that passed, not the change in the wall clock.
64
- * - **`totalDwell` is the time actually spent at the handoffs**: each leg's departure minus the
65
- * previous leg's arrival. When every leg after the first chains from its predecessor, that is the
66
- * sum of the `dwellAfter` values. When a leg waits for a scheduled departure, the wait is dwell
67
- * too: the cargo is at the handoff either way. Dwell is never estimated; it is the caller's
68
- * `dwellAfter` and schedule.
69
- * - **Transit plus dwell is the elapsed time** from the first departure to the ETA, exactly.
70
- * - **The last leg's `dwellAfter` is not dwell.** There is no handoff after it, so it moves
71
- * nothing; it is still checked as a duration, as `scheduleDelivery` checks it.
72
- * - Both totals are ISO 8601 durations with hours as the largest unit (`"PT400H"`, `"PT2H15M"`),
73
- * as `crossingTime` and `dwellTime` report elapsed time; they do not depend on any zone.
74
- * - Each leg's fields are read once, so the totals always agree with the schedule.
75
- * - An empty legs array returns `{ eta: "", totalLegs: 0, totalTransit: "PT0S", totalDwell: "PT0S" }`.
76
- * Returns `null` on invalid input: a non-array, a malformed leg, a missed connection, an invalid
77
- * `startTimeZone`, or an arrival outside the instant range.
78
- * - An offset with seconds (`-00:44:30`) as a leg's `timeZone` or as `startTimeZone` returns
79
- * `null`, as in `scheduleDelivery`. A written zone cannot carry seconds (RFC 9557 §4.1), so `eta`
80
- * could not name it. Pass the IANA name.
81
- *
82
- * @param legs the journey's legs, in travel order
83
- * @param options The zone a zoneless first-leg departure is read in
84
- * @returns the ETA, the number of legs, and the total transit and dwell, or null on invalid input
85
- *
86
- * @example multimodalETA([{ departure: "2024-06-10T08:00:00+08:00[Asia/Shanghai]", duration: "PT6H", timeZone: "Asia/Shanghai", dwellAfter: "P2D" }, { duration: "P14DT6H", timeZone: "America/Los_Angeles", dwellAfter: "PT36H" }, { duration: "PT52H", timeZone: "America/Chicago" }]) // { eta: "2024-06-29T23:00:00-05:00[America/Chicago]", totalLegs: 3, totalTransit: "PT400H", totalDwell: "PT84H" } (truck, ship and rail: 484 hours door to door)
87
- * @example multimodalETA([{ departure: "2024-06-15T00:00:00Z", duration: "PT10H", timeZone: "UTC", dwellAfter: "PT2H" }, { duration: "PT5H", timeZone: "Asia/Tokyo" }]) // { eta: "2024-06-16T02:00:00+09:00[Asia/Tokyo]", totalLegs: 2, totalTransit: "PT15H", totalDwell: "PT2H" }
88
- * @example multimodalETA([{ departure: "2024-06-15T00:00:00Z", duration: "PT10H", timeZone: "UTC", dwellAfter: "PT2H" }, { departure: "2024-06-15T13:00:00Z", duration: "PT1H", timeZone: "UTC" }]) // { eta: "2024-06-15T14:00:00+00:00[UTC]", totalLegs: 2, totalTransit: "PT11H", totalDwell: "PT3H" } (two hours' handling and an hour's wait for the 13:00 departure)
89
- * @example multimodalETA([{ departure: "2024-06-15T10:00:00Z", duration: "PT36H", timeZone: "Asia/Tokyo", dwellAfter: "PT5H" }]) // { eta: "2024-06-17T07:00:00+09:00[Asia/Tokyo]", totalLegs: 1, totalTransit: "PT36H", totalDwell: "PT0S" } (no handoff after the last leg)
90
- * @example multimodalETA([{ departure: "2024-06-15T10:00:00", duration: "PT1H", timeZone: "UTC" }], { startTimeZone: "America/Sao_Paulo" }) // { eta: "2024-06-15T14:00:00+00:00[UTC]", totalLegs: 1, totalTransit: "PT1H", totalDwell: "PT0S" } (a published 10:00 wall time, read in São Paulo)
91
- * @example multimodalETA([]) // { eta: "", totalLegs: 0, totalTransit: "PT0S", totalDwell: "PT0S" }
92
- * @example multimodalETA([{ departure: "2024-06-15T00:00:00Z", duration: "PT10H", timeZone: "UTC", dwellAfter: "PT2H" }, { departure: "2024-06-15T11:00:00Z", duration: "PT1H", timeZone: "UTC" }]) // null (the connection leaves inside the dwell: missed)
93
- * @example multimodalETA([{ departure: "2024-06-15T10:00:00Z", duration: "P1M", timeZone: "UTC" }]) // null (calendar units have no exact length)
94
- * @example multimodalETA("legs") // null
95
- */
96
- export function multimodalETA(legs, options) {
97
- try {
98
- if (!Array.isArray(legs)) {
99
- return null;
100
- }
101
- const snapshot = legs.map(snapshotLeg);
102
- const schedule = scheduleDelivery(snapshot, options);
103
- if (schedule === null) {
104
- return null;
105
- }
106
- const first = schedule.legTimes.at(0);
107
- const last = schedule.legTimes.at(-1);
108
- if (first === undefined || last === undefined) {
109
- return {
110
- eta: "",
111
- totalLegs: 0,
112
- totalTransit: "PT0S",
113
- totalDwell: "PT0S",
114
- };
115
- }
116
- // scheduleDelivery has accepted every duration as exact and not negative.
117
- const durations = snapshot.map((leg) => exactDurationNanoseconds(leg.duration));
118
- if (durations.some((nanoseconds) => nanoseconds === null)) {
119
- return null;
120
- }
121
- const transit = durations.reduce((sum, ns) => sum + ns, 0n);
122
- // Arrivals are the Z strings scheduleDelivery wrote. The first leg left its own duration
123
- // before it arrived; the time between that departure and the last arrival that was not spent
124
- // moving was spent at the handoffs.
125
- const departure = Temporal.Instant.from(first.arrival).epochNanoseconds -
126
- durations[0];
127
- const elapsed = Temporal.Instant.from(last.arrival).epochNanoseconds - departure;
128
- const totalTransit = formatHourDuration(transit);
129
- const totalDwell = formatHourDuration(elapsed - transit);
130
- if (totalTransit === "" || totalDwell === "") {
131
- return null;
132
- }
133
- return {
134
- eta: schedule.eta,
135
- totalLegs: snapshot.length,
136
- totalTransit,
137
- totalDwell,
138
- };
139
- }
140
- catch {
141
- // Never throws (Core Rule 3): a hostile
142
- // argument is invalid input, not an exception.
143
- return null;
144
- }
33
+ * Compute an end-to-end ETA across the legs of a multimodal move, and report the time in transit
34
+ * and the time in dwell separately.
35
+ *
36
+ * A truck→ship→rail move spends its time two ways: moving, and sitting at a handoff. The two are
37
+ * forecast differently and fail differently, so one opaque total hides the part a planner needs.
38
+ * `multimodalETA` schedules the legs with `scheduleDelivery` and splits the elapsed time from the
39
+ * first departure to the ETA into the two.
40
+ *
41
+ * - **The legs are `scheduleDelivery`'s.** Each leg's arrival plus its `dwellAfter` is the next
42
+ * leg's departure unless the next leg names a scheduled `departure`; a scheduled departure
43
+ * inside the dwell is a missed connection. Departures, zones and every validity rule are that
44
+ * function's, and `eta` is its `eta`.
45
+ * - **Local-time resolution policy (`"compatible"`), as `scheduleDelivery` applies it.** A zoneless
46
+ * first departure read in `startTimeZone`, a zoneless later-leg departure read in the previous
47
+ * leg's `timeZone`, and a zoned departure written without an offset are wall times. An
48
+ * **ambiguous** one (a fall-back hour the clock ran through twice) resolves to the **earlier**
49
+ * instant and a **nonexistent** one (a spring-forward hour the clock skipped) to the **later**
50
+ * instant, except that on any leg but the first a repeated hour takes the earliest pass at or
51
+ * after the previous arrival plus its dwell, the first the cargo can catch. Write the offset to
52
+ * pick a pass yourself.
53
+ * - **`totalTransit` is every leg's `duration` added up.** Durations are exact time: a day is 24
54
+ * hours, and years, months and weeks return `null`. The sum is elapsed time, so a leg across a
55
+ * DST change counts the hours that passed, not the change in the wall clock.
56
+ * - **`totalDwell` is the time actually spent at the handoffs**: each leg's departure minus the
57
+ * previous leg's arrival. When every leg after the first chains from its predecessor, that is the
58
+ * sum of the `dwellAfter` values. When a leg waits for a scheduled departure, the wait is dwell
59
+ * too: the cargo is at the handoff either way. Dwell is never estimated; it is the caller's
60
+ * `dwellAfter` and schedule.
61
+ * - **Transit plus dwell is the elapsed time** from the first departure to the ETA, exactly.
62
+ * - **The last leg's `dwellAfter` is not dwell.** There is no handoff after it, so it moves
63
+ * nothing; it is still checked as a duration, as `scheduleDelivery` checks it.
64
+ * - Both totals are ISO 8601 durations with hours as the largest unit (`"PT400H"`, `"PT2H15M"`),
65
+ * as `crossingTime` and `dwellTime` report elapsed time; they do not depend on any zone.
66
+ * - Each leg's fields are read once, so the totals always agree with the schedule.
67
+ * - An empty legs array returns `{ eta: "", totalLegs: 0, totalTransit: "PT0S", totalDwell: "PT0S" }`.
68
+ * Returns `null` on invalid input: a non-array, a malformed leg, a missed connection, an invalid
69
+ * `startTimeZone`, or an arrival outside the instant range.
70
+ * - An offset with seconds (`-00:44:30`) as a leg's `timeZone` or as `startTimeZone` returns
71
+ * `null`, as in `scheduleDelivery`. A written zone cannot carry seconds (RFC 9557 §4.1), so `eta`
72
+ * could not name it. Pass the IANA name.
73
+ *
74
+ * @param legs the journey's legs, in travel order
75
+ * @param options The zone a zoneless first-leg departure is read in
76
+ * @returns the ETA, the number of legs, and the total transit and dwell, or null on invalid input
77
+ *
78
+ * @example multimodalETA([{ departure: "2024-06-10T08:00:00+08:00[Asia/Shanghai]", duration: "PT6H", timeZone: "Asia/Shanghai", dwellAfter: "P2D" }, { duration: "P14DT6H", timeZone: "America/Los_Angeles", dwellAfter: "PT36H" }, { duration: "PT52H", timeZone: "America/Chicago" }]) // { eta: "2024-06-29T23:00:00-05:00[America/Chicago]", totalLegs: 3, totalTransit: "PT400H", totalDwell: "PT84H" } (truck, ship and rail: 484 hours door to door)
79
+ * @example multimodalETA([{ departure: "2024-06-15T00:00:00Z", duration: "PT10H", timeZone: "UTC", dwellAfter: "PT2H" }, { duration: "PT5H", timeZone: "Asia/Tokyo" }]) // { eta: "2024-06-16T02:00:00+09:00[Asia/Tokyo]", totalLegs: 2, totalTransit: "PT15H", totalDwell: "PT2H" }
80
+ * @example multimodalETA([{ departure: "2024-06-15T00:00:00Z", duration: "PT10H", timeZone: "UTC", dwellAfter: "PT2H" }, { departure: "2024-06-15T13:00:00Z", duration: "PT1H", timeZone: "UTC" }]) // { eta: "2024-06-15T14:00:00+00:00[UTC]", totalLegs: 2, totalTransit: "PT11H", totalDwell: "PT3H" } (two hours' handling and an hour's wait for the 13:00 departure)
81
+ * @example multimodalETA([{ departure: "2024-06-15T10:00:00Z", duration: "PT36H", timeZone: "Asia/Tokyo", dwellAfter: "PT5H" }]) // { eta: "2024-06-17T07:00:00+09:00[Asia/Tokyo]", totalLegs: 1, totalTransit: "PT36H", totalDwell: "PT0S" } (no handoff after the last leg)
82
+ * @example multimodalETA([{ departure: "2024-06-15T10:00:00", duration: "PT1H", timeZone: "UTC" }], { startTimeZone: "America/Sao_Paulo" }) // { eta: "2024-06-15T14:00:00+00:00[UTC]", totalLegs: 1, totalTransit: "PT1H", totalDwell: "PT0S" } (a published 10:00 wall time, read in São Paulo)
83
+ * @example multimodalETA([]) // { eta: "", totalLegs: 0, totalTransit: "PT0S", totalDwell: "PT0S" }
84
+ * @example multimodalETA([{ departure: "2024-06-15T00:00:00Z", duration: "PT10H", timeZone: "UTC", dwellAfter: "PT2H" }, { departure: "2024-06-15T11:00:00Z", duration: "PT1H", timeZone: "UTC" }]) // null (the connection leaves inside the dwell: missed)
85
+ * @example multimodalETA([{ departure: "2024-06-15T10:00:00Z", duration: "P1M", timeZone: "UTC" }]) // null (calendar units have no exact length)
86
+ * @example multimodalETA("legs") // null
87
+ */
88
+ function multimodalETA(legs, options) {
89
+ try {
90
+ if (!Array.isArray(legs)) return null;
91
+ const snapshot = legs.map(snapshotLeg);
92
+ const schedule = scheduleDelivery(snapshot, options);
93
+ if (schedule === null) return null;
94
+ const first = schedule.legTimes.at(0);
95
+ const last = schedule.legTimes.at(-1);
96
+ if (first === void 0 || last === void 0) return {
97
+ eta: "",
98
+ totalLegs: 0,
99
+ totalTransit: "PT0S",
100
+ totalDwell: "PT0S"
101
+ };
102
+ const durations = snapshot.map((leg) => exactDurationNanoseconds(leg.duration));
103
+ if (durations.some((nanoseconds) => nanoseconds === null)) return null;
104
+ const transit = durations.reduce((sum, ns) => sum + ns, 0n);
105
+ const departure = Temporal.Instant.from(first.arrival).epochNanoseconds - durations[0];
106
+ const elapsed = Temporal.Instant.from(last.arrival).epochNanoseconds - departure;
107
+ const totalTransit = formatHourDuration(transit);
108
+ const totalDwell = formatHourDuration(elapsed - transit);
109
+ if (totalTransit === "" || totalDwell === "") return null;
110
+ return {
111
+ eta: schedule.eta,
112
+ totalLegs: snapshot.length,
113
+ totalTransit,
114
+ totalDwell
115
+ };
116
+ } catch {
117
+ return null;
118
+ }
145
119
  }
120
+
121
+ export { multimodalETA };
@@ -13,14 +13,14 @@
13
13
  export type BillOfLadingEvent = "issue" | "received" | "shippedOnBoard";
14
14
  /** Options for `bolTimestamp`. */
15
15
  export interface BolTimestampOptions {
16
- /**
17
- * The zone of the place the event happened, as an IANA name or a UTC offset: the place of issue
18
- * for `issue`, and the terminal at the port of loading for `received` and `shippedOnBoard`. A UTC
19
- * offset is a time zone identifier (`+05:30`, `+0530`, `-08`) or a stored offset (`±HH:MM[:SS]`,
20
- * what `getTimeZoneOffset` returns). It is required, because every B/L date is local and a UTC
21
- * date is a different date for part of every day.
22
- */
23
- timeZone: string;
16
+ /**
17
+ * The zone of the place the event happened, as an IANA name or a UTC offset: the place of issue
18
+ * for `issue`, and the terminal at the port of loading for `received` and `shippedOnBoard`. A UTC
19
+ * offset is a time zone identifier (`+05:30`, `+0530`, `-08`) or a stored offset (`±HH:MM[:SS]`,
20
+ * what `getTimeZoneOffset` returns). It is required, because every B/L date is local and a UTC
21
+ * date is a different date for part of every day.
22
+ */
23
+ timeZone: string;
24
24
  }
25
25
  /**
26
26
  * Render an instant as the date a bill of lading carries for an event: the calendar date on the
@@ -73,4 +73,4 @@ export interface BolTimestampOptions {
73
73
  * @example bolTimestamp("2024-06-16T01:00:00Z", "shippedOnBoard", { timeZone: "America/Nowhere" }) // ""
74
74
  * @example bolTimestamp("1970-01-01T00:30:00Z", "issue", { timeZone: "-00:44:30" }) // "1969-12-31" (23:45:30 the day before, at a stored offset with seconds)
75
75
  */
76
- export declare function bolTimestamp(value: string, event: BillOfLadingEvent, options: BolTimestampOptions): string;
76
+ export declare function bolTimestamp(value: string, event: BillOfLadingEvent, options: BolTimestampOptions): string;