@northguild/gmt 1.20.0 → 1.21.0

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