@northguild/gmt 1.19.0 → 1.21.0

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