@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,80 +1,59 @@
1
- import { EXCEL_1900_EPOCH_NANOSECONDS, EXCEL_1900_PRE_PHANTOM_EPOCH_NANOSECONDS, EXCEL_1904_EPOCH_NANOSECONDS, EXCEL_PHANTOM_SERIAL, MAX_EXCEL_1900_SERIAL_EXCLUSIVE, MAX_EXCEL_1904_SERIAL_EXCLUSIVE, MILLISECONDS_PER_DAY, MIN_EXCEL_1900_SERIAL, MIN_EXCEL_1904_SERIAL, NANOSECONDS_PER_MILLISECOND, } from "../../internal/index.js";
2
- import { fromNanoseconds } from "./fromNanoseconds.js";
3
1
  import { isOptionsArgument } from "../../internal/isObject.js";
4
2
  import { optionOrDefault } from "../../internal/optionOrDefault.js";
3
+ import { EXCEL_1900_EPOCH_NANOSECONDS, EXCEL_1900_PRE_PHANTOM_EPOCH_NANOSECONDS, EXCEL_1904_EPOCH_NANOSECONDS, EXCEL_PHANTOM_SERIAL, MAX_EXCEL_1900_SERIAL_EXCLUSIVE, MAX_EXCEL_1904_SERIAL_EXCLUSIVE, MILLISECONDS_PER_DAY, MIN_EXCEL_1900_SERIAL, MIN_EXCEL_1904_SERIAL, NANOSECONDS_PER_MILLISECOND } from "../../internal/foreignEpochs.js";
4
+ import { fromNanoseconds } from "./fromNanoseconds.js";
5
+
6
+ // src/precision/convert/fromExcelSerial.ts
5
7
  /**
6
- * Convert an Excel day serial back to an ISO 8601 instant string.
7
- *
8
- * - The serial is days with the time of day as the fraction, read as a UTC wall clock.
9
- * - **Serial 60 in the 1900 system returns ""** — it is the phantom 29 February 1900, a date
10
- * that never existed. Lotus 1-2-3 treated 1900 as a leap year and Excel keeps the bug for
11
- * compatibility, so the whole serial day `[60, 61)` is a hole: 59 is 1900-02-28 and 61 is
12
- * 1900-03-01. Mapping 60 to either neighbour would put every earlier date one day out.
13
- * - In the 1904 system serial 60 is a real 1904-03-01.
14
- * - Accepted range is Excel's own: serial 1 (1900-01-01) to just under 2958466 (the end of
15
- * 9999-12-31) in the 1900 system, serial 0 to just under 2957004 in the 1904 system.
16
- * Serial 0 in the 1900 system is Excel's "January 0, 1900" placeholder, not a date.
17
- * - Rounds to the nearest millisecond. A serial is a `double`, whose resolution is about a
18
- * microsecond near 2024 and about 40 µs near 9999 — finer than a millisecond nowhere in
19
- * the range, so rounding there is what makes the round trip through `toExcelSerial` exact.
20
- * - Returns "" on invalid input.
21
- *
22
- * @param value Excel day serial (number, may carry a fractional time of day)
23
- * @param options Which Excel date system the serial is in
24
- * @returns ISO 8601 instant string (UTC), or "" on invalid input
25
- *
26
- * @example fromExcelSerial(1) // "1900-01-01T00:00:00Z" — Excel's first serial
27
- * @example fromExcelSerial(25569) // "1970-01-01T00:00:00Z"
28
- * @example fromExcelSerial(45361.5) // "2024-03-10T12:00:00Z"
29
- * @example fromExcelSerial(59) // "1900-02-28T00:00:00Z"
30
- * @example fromExcelSerial(60) // "" — the phantom 1900-02-29, a date that never existed
31
- * @example fromExcelSerial(61) // "1900-03-01T00:00:00Z"
32
- * @example fromExcelSerial(60, { system: "1904" }) // "1904-03-01T00:00:00Z" — no phantom day here
33
- * @example fromExcelSerial(43899.5, { system: "1904" }) // "2024-03-10T12:00:00Z"
34
- * @example fromExcelSerial(0) // "" — Excel's "January 0, 1900", not a date
35
- * @example fromExcelSerial(-1) // ""
36
- */
37
- export function fromExcelSerial(value, options) {
38
- try {
39
- if (!isOptionsArgument(options)) {
40
- return "";
41
- }
42
- const system = optionOrDefault(options?.system, "1900");
43
- if (system !== "1900" && system !== "1904") {
44
- return "";
45
- }
46
- if (!Number.isFinite(value)) {
47
- return "";
48
- }
49
- // Snap to the millisecond grid before deciding anything: the range and phantom-day
50
- // comparisons must be made against the value actually built, not against a serial that
51
- // rounds across a boundary on the way there.
52
- const dayMilliseconds = Math.round(value * MILLISECONDS_PER_DAY);
53
- const minimum = system === "1904" ? MIN_EXCEL_1904_SERIAL : MIN_EXCEL_1900_SERIAL;
54
- const maximumExclusive = system === "1904"
55
- ? MAX_EXCEL_1904_SERIAL_EXCLUSIVE
56
- : MAX_EXCEL_1900_SERIAL_EXCLUSIVE;
57
- if (dayMilliseconds < minimum * MILLISECONDS_PER_DAY ||
58
- dayMilliseconds >= maximumExclusive * MILLISECONDS_PER_DAY) {
59
- return "";
60
- }
61
- if (system === "1904") {
62
- return fromNanoseconds(BigInt(dayMilliseconds) * NANOSECONDS_PER_MILLISECOND +
63
- EXCEL_1904_EPOCH_NANOSECONDS);
64
- }
65
- const phantomStart = EXCEL_PHANTOM_SERIAL * MILLISECONDS_PER_DAY;
66
- const phantomEnd = (EXCEL_PHANTOM_SERIAL + 1) * MILLISECONDS_PER_DAY;
67
- if (dayMilliseconds >= phantomStart && dayMilliseconds < phantomEnd) {
68
- return "";
69
- }
70
- return fromNanoseconds(BigInt(dayMilliseconds) * NANOSECONDS_PER_MILLISECOND +
71
- (dayMilliseconds >= phantomEnd
72
- ? EXCEL_1900_EPOCH_NANOSECONDS
73
- : EXCEL_1900_PRE_PHANTOM_EPOCH_NANOSECONDS));
74
- }
75
- catch {
76
- // Never throws (Core Rule 3): a hostile
77
- // argument is invalid input, not an exception.
78
- return "";
79
- }
8
+ * Convert an Excel day serial back to an ISO 8601 instant string.
9
+ *
10
+ * - The serial is days with the time of day as the fraction, read as a UTC wall clock.
11
+ * - **Serial 60 in the 1900 system returns ""** — it is the phantom 29 February 1900, a date
12
+ * that never existed. Lotus 1-2-3 treated 1900 as a leap year and Excel keeps the bug for
13
+ * compatibility, so the whole serial day `[60, 61)` is a hole: 59 is 1900-02-28 and 61 is
14
+ * 1900-03-01. Mapping 60 to either neighbour would put every earlier date one day out.
15
+ * - In the 1904 system serial 60 is a real 1904-03-01.
16
+ * - Accepted range is Excel's own: serial 1 (1900-01-01) to just under 2958466 (the end of
17
+ * 9999-12-31) in the 1900 system, serial 0 to just under 2957004 in the 1904 system.
18
+ * Serial 0 in the 1900 system is Excel's "January 0, 1900" placeholder, not a date.
19
+ * - Rounds to the nearest millisecond. A serial is a `double`, whose resolution is about a
20
+ * microsecond near 2024 and about 40 µs near 9999 — finer than a millisecond nowhere in
21
+ * the range, so rounding there is what makes the round trip through `toExcelSerial` exact.
22
+ * - Returns "" on invalid input.
23
+ *
24
+ * @param value Excel day serial (number, may carry a fractional time of day)
25
+ * @param options Which Excel date system the serial is in
26
+ * @returns ISO 8601 instant string (UTC), or "" on invalid input
27
+ *
28
+ * @example fromExcelSerial(1) // "1900-01-01T00:00:00Z" — Excel's first serial
29
+ * @example fromExcelSerial(25569) // "1970-01-01T00:00:00Z"
30
+ * @example fromExcelSerial(45361.5) // "2024-03-10T12:00:00Z"
31
+ * @example fromExcelSerial(59) // "1900-02-28T00:00:00Z"
32
+ * @example fromExcelSerial(60) // "" — the phantom 1900-02-29, a date that never existed
33
+ * @example fromExcelSerial(61) // "1900-03-01T00:00:00Z"
34
+ * @example fromExcelSerial(60, { system: "1904" }) // "1904-03-01T00:00:00Z" — no phantom day here
35
+ * @example fromExcelSerial(43899.5, { system: "1904" }) // "2024-03-10T12:00:00Z"
36
+ * @example fromExcelSerial(0) // "" — Excel's "January 0, 1900", not a date
37
+ * @example fromExcelSerial(-1) // ""
38
+ */
39
+ function fromExcelSerial(value, options) {
40
+ try {
41
+ if (!isOptionsArgument(options)) return "";
42
+ const system = optionOrDefault(options?.system, "1900");
43
+ if (system !== "1900" && system !== "1904") return "";
44
+ if (!Number.isFinite(value)) return "";
45
+ const dayMilliseconds = Math.round(value * MILLISECONDS_PER_DAY);
46
+ const minimum = system === "1904" ? 0 : 1;
47
+ const maximumExclusive = system === "1904" ? MAX_EXCEL_1904_SERIAL_EXCLUSIVE : MAX_EXCEL_1900_SERIAL_EXCLUSIVE;
48
+ if (dayMilliseconds < minimum * 864e5 || dayMilliseconds >= maximumExclusive * 864e5) return "";
49
+ if (system === "1904") return fromNanoseconds(BigInt(dayMilliseconds) * NANOSECONDS_PER_MILLISECOND + EXCEL_1904_EPOCH_NANOSECONDS);
50
+ const phantomStart = 60 * MILLISECONDS_PER_DAY;
51
+ const phantomEnd = (60 + 1) * MILLISECONDS_PER_DAY;
52
+ if (dayMilliseconds >= phantomStart && dayMilliseconds < phantomEnd) return "";
53
+ return fromNanoseconds(BigInt(dayMilliseconds) * NANOSECONDS_PER_MILLISECOND + (dayMilliseconds >= phantomEnd ? EXCEL_1900_EPOCH_NANOSECONDS : EXCEL_1900_PRE_PHANTOM_EPOCH_NANOSECONDS));
54
+ } catch {
55
+ return "";
56
+ }
80
57
  }
58
+
59
+ export { fromExcelSerial };
@@ -27,4 +27,4 @@
27
27
  * @example fromFileTime(-1n) // "" — FILETIME is unsigned
28
28
  * @example fromFileTime(116444736000000000) // "" — number, not bigint
29
29
  */
30
- export declare function fromFileTime(value: bigint): string;
30
+ export declare function fromFileTime(value: bigint): string;
@@ -1,39 +1,39 @@
1
- import { FILE_TIME_EPOCH_OFFSET_TICKS, MAX_FILE_TIME, MIN_FILE_TIME, NANOSECONDS_PER_TICK, } from "../../internal/index.js";
1
+ import { FILE_TIME_EPOCH_OFFSET_TICKS, MAX_FILE_TIME, MIN_FILE_TIME, NANOSECONDS_PER_TICK } from "../../internal/foreignEpochs.js";
2
2
  import { fromNanoseconds } from "./fromNanoseconds.js";
3
+
4
+ // src/precision/convert/fromFileTime.ts
3
5
  /**
4
- * Convert a Windows `FILETIME` back to an ISO 8601 instant string.
5
- *
6
- * - `value` counts 100-nanosecond intervals since 1601-01-01T00:00:00Z.
7
- * - The accepted range is `0n` to `2^63 − 1`, 1601-01-01 to
8
- * `+030828-09-14T02:48:05.4775807Z`. `FILETIME` is a pair of `DWORD`s, so a negative value is
9
- * rejected rather than read as a pre-1601 instant. Values from `2^63` up are rejected too:
10
- * Microsoft's `FileTimeToSystemTime` requires a value "less than 0x8000000000000000", and
11
- * `SetFileTime` uses `0xFFFFFFFFFFFFFFFF` (`2^64 − 1`) as its "do not modify" marker.
12
- * - To decode the raw unsigned count anyway, for example to inspect a marker, compute
13
- * `fromNanoseconds((value - 116444736000000000n) * 100n)`.
14
- * - Exact in this direction — 100 ns is coarser than the nanoseconds an ISO string carries,
15
- * so nothing is rounded. The loss, if any, happened in `toFileTime`.
16
- * - Returns "" on invalid input.
17
- *
18
- * @param value 100-nanosecond intervals since 1601-01-01 (bigint, 0n to 2^63 − 1)
19
- * @returns ISO 8601 instant string (UTC), or "" on invalid input
20
- *
21
- * @example fromFileTime(0n) // "1601-01-01T00:00:00Z" — the FILETIME epoch
22
- * @example fromFileTime(116444736000000000n) // "1970-01-01T00:00:00Z"
23
- * @example fromFileTime(133545476967890000n) // "2024-03-10T12:34:56.789Z"
24
- * @example fromFileTime(2650467743999999999n) // "9999-12-31T23:59:59.9999999Z" — .NET's DateTime maximum
25
- * @example fromFileTime(9223372036854775807n) // "+030828-09-14T02:48:05.4775807Z" — 2^63 − 1, the largest accepted
26
- * @example fromFileTime(9223372036854775808n) // "" — 2^63, which FileTimeToSystemTime rejects
27
- * @example fromFileTime(18446744073709551615n) // "" — SetFileTime's do-not-modify marker
28
- * @example fromNanoseconds((18446744073709551615n - 116444736000000000n) * 100n) // "+060056-05-28T05:36:10.9551615Z" — raw unsigned decode
29
- * @example fromFileTime(-1n) // "" — FILETIME is unsigned
30
- * @example fromFileTime(116444736000000000) // "" — number, not bigint
31
- */
32
- export function fromFileTime(value) {
33
- if (typeof value !== "bigint" ||
34
- value < MIN_FILE_TIME ||
35
- value > MAX_FILE_TIME) {
36
- return "";
37
- }
38
- return fromNanoseconds((value - FILE_TIME_EPOCH_OFFSET_TICKS) * NANOSECONDS_PER_TICK);
6
+ * Convert a Windows `FILETIME` back to an ISO 8601 instant string.
7
+ *
8
+ * - `value` counts 100-nanosecond intervals since 1601-01-01T00:00:00Z.
9
+ * - The accepted range is `0n` to `2^63 − 1`, 1601-01-01 to
10
+ * `+030828-09-14T02:48:05.4775807Z`. `FILETIME` is a pair of `DWORD`s, so a negative value is
11
+ * rejected rather than read as a pre-1601 instant. Values from `2^63` up are rejected too:
12
+ * Microsoft's `FileTimeToSystemTime` requires a value "less than 0x8000000000000000", and
13
+ * `SetFileTime` uses `0xFFFFFFFFFFFFFFFF` (`2^64 − 1`) as its "do not modify" marker.
14
+ * - To decode the raw unsigned count anyway, for example to inspect a marker, compute
15
+ * `fromNanoseconds((value - 116444736000000000n) * 100n)`.
16
+ * - Exact in this direction — 100 ns is coarser than the nanoseconds an ISO string carries,
17
+ * so nothing is rounded. The loss, if any, happened in `toFileTime`.
18
+ * - Returns "" on invalid input.
19
+ *
20
+ * @param value 100-nanosecond intervals since 1601-01-01 (bigint, 0n to 2^63 − 1)
21
+ * @returns ISO 8601 instant string (UTC), or "" on invalid input
22
+ *
23
+ * @example fromFileTime(0n) // "1601-01-01T00:00:00Z" — the FILETIME epoch
24
+ * @example fromFileTime(116444736000000000n) // "1970-01-01T00:00:00Z"
25
+ * @example fromFileTime(133545476967890000n) // "2024-03-10T12:34:56.789Z"
26
+ * @example fromFileTime(2650467743999999999n) // "9999-12-31T23:59:59.9999999Z" — .NET's DateTime maximum
27
+ * @example fromFileTime(9223372036854775807n) // "+030828-09-14T02:48:05.4775807Z" — 2^63 − 1, the largest accepted
28
+ * @example fromFileTime(9223372036854775808n) // "" — 2^63, which FileTimeToSystemTime rejects
29
+ * @example fromFileTime(18446744073709551615n) // "" — SetFileTime's do-not-modify marker
30
+ * @example fromNanoseconds((18446744073709551615n - 116444736000000000n) * 100n) // "+060056-05-28T05:36:10.9551615Z" — raw unsigned decode
31
+ * @example fromFileTime(-1n) // "" — FILETIME is unsigned
32
+ * @example fromFileTime(116444736000000000) // "" — number, not bigint
33
+ */
34
+ function fromFileTime(value) {
35
+ if (typeof value !== "bigint" || value < 0n || value > 9223372036854775807n) return "";
36
+ return fromNanoseconds((value - FILE_TIME_EPOCH_OFFSET_TICKS) * NANOSECONDS_PER_TICK);
39
37
  }
38
+
39
+ export { fromFileTime };
@@ -32,4 +32,4 @@
32
32
  * @example fromNanoseconds(0n, undefined) // "1970-01-01T00:00:00Z" — undefined is the same as omitted
33
33
  * @example fromNanoseconds(1710072000123456789) // "" — number, not bigint
34
34
  */
35
- export declare function fromNanoseconds(nanoseconds: bigint, timeZone?: string): string;
35
+ export declare function fromNanoseconds(nanoseconds: bigint, timeZone?: string): string;
@@ -1,56 +1,51 @@
1
1
  import { Temporal } from "../../internal/temporal.js";
2
- import { isValidEpochNanoseconds } from "../../internal/index.js";
3
- import { isValidTimeZone } from "../../zoned/validate/index.js";
2
+ import { isValidEpochNanoseconds } from "../../internal/epochNanoseconds.js";
3
+ import { isValidTimeZone } from "../../zoned/validate/isValidTimeZone.js";
4
+ import { instantStringFromEpochNanoseconds } from "../../internal/instantStringFromEpochNanoseconds.js";
5
+
6
+ // src/precision/convert/fromNanoseconds.ts
4
7
  /**
5
- * Convert nanoseconds since the Unix epoch back to an ISO 8601 string.
6
- *
7
- * - Returns a UTC instant string when no time zone is given, and a zoned string
8
- * (`"...[Asia/Tokyo]"`) when one is.
9
- * - No disambiguation policy applies: an instant maps to exactly one wall time in a zone,
10
- * so DST gaps and overlaps cannot arise on this direction of the conversion.
11
- * - A time zone, when given, must be a time zone identifier: an IANA name or a UTC offset to the
12
- * minute. `undefined` is the same as omitting it (UTC), as TC39 treats an undefined argument as
13
- * absent.
14
- * - Rejects values outside the range `Temporal.Instant` can represent
15
- * (±8_640_000_000_000_000_000_000n, i.e. ±10^8 days from the epoch).
16
- * - **Storage round-trip:** most engines cannot hold nanoseconds — PostgreSQL `timestamptz`
17
- * stores microseconds — so writing this value and reading it back breaks equality unless
18
- * the caller applies `truncateNanoseconds` to the target precision first.
19
- * - Returns "" on invalid input.
20
- * - An offset with seconds (`-00:44:30`) returns `""`. A written zone cannot carry seconds (RFC
21
- * 9557 §4.1), so the result could not name it. Pass the IANA name, or call
22
- * `fromOffsetInstant({ instant, offset })` for the local time with its full offset and no
23
- * bracket.
24
- *
25
- * @param nanoseconds nanoseconds since the Unix epoch (bigint)
26
- * @param timeZone optional IANA name or a UTC offset to the minute (what `isValidTimeZone`
27
- * accepts); omitted or `undefined` is UTC
28
- * @returns ISO 8601 instant string (UTC), zoned ISO 8601 string when a timeZone is given, or "" on invalid input
29
- *
30
- * @example fromNanoseconds(0n) // "1970-01-01T00:00:00Z"
31
- * @example fromNanoseconds(1710072000123456789n) // "2024-03-10T12:00:00.123456789Z"
32
- * @example fromNanoseconds(1710072000123456789n, "Asia/Tokyo") // "2024-03-10T21:00:00.123456789+09:00[Asia/Tokyo]"
33
- * @example fromNanoseconds(-1000000000n) // "1969-12-31T23:59:59Z"
34
- * @example fromNanoseconds(0n, "Not/AZone") // ""
35
- * @example fromNanoseconds(0n, undefined) // "1970-01-01T00:00:00Z" — undefined is the same as omitted
36
- * @example fromNanoseconds(1710072000123456789) // "" — number, not bigint
37
- */
38
- export function fromNanoseconds(nanoseconds, timeZone) {
39
- if (!isValidEpochNanoseconds(nanoseconds)) {
40
- return "";
41
- }
42
- // An explicit `undefined` is the same as omitting the argument (TC39 optional parameters).
43
- if (timeZone !== undefined &&
44
- (typeof timeZone !== "string" || !isValidTimeZone(timeZone))) {
45
- return "";
46
- }
47
- try {
48
- const instant = Temporal.Instant.fromEpochNanoseconds(nanoseconds);
49
- return typeof timeZone === "string"
50
- ? instant.toZonedDateTimeISO(timeZone).toString()
51
- : instant.toString();
52
- }
53
- catch {
54
- return "";
55
- }
8
+ * Convert nanoseconds since the Unix epoch back to an ISO 8601 string.
9
+ *
10
+ * - Returns a UTC instant string when no time zone is given, and a zoned string
11
+ * (`"...[Asia/Tokyo]"`) when one is.
12
+ * - No disambiguation policy applies: an instant maps to exactly one wall time in a zone,
13
+ * so DST gaps and overlaps cannot arise on this direction of the conversion.
14
+ * - A time zone, when given, must be a time zone identifier: an IANA name or a UTC offset to the
15
+ * minute. `undefined` is the same as omitting it (UTC), as TC39 treats an undefined argument as
16
+ * absent.
17
+ * - Rejects values outside the range `Temporal.Instant` can represent
18
+ * (±8_640_000_000_000_000_000_000n, i.e. ±10^8 days from the epoch).
19
+ * - **Storage round-trip:** most engines cannot hold nanoseconds — PostgreSQL `timestamptz`
20
+ * stores microseconds — so writing this value and reading it back breaks equality unless
21
+ * the caller applies `truncateNanoseconds` to the target precision first.
22
+ * - Returns "" on invalid input.
23
+ * - An offset with seconds (`-00:44:30`) returns `""`. A written zone cannot carry seconds (RFC
24
+ * 9557 §4.1), so the result could not name it. Pass the IANA name, or call
25
+ * `fromOffsetInstant({ instant, offset })` for the local time with its full offset and no
26
+ * bracket.
27
+ *
28
+ * @param nanoseconds nanoseconds since the Unix epoch (bigint)
29
+ * @param timeZone optional IANA name or a UTC offset to the minute (what `isValidTimeZone`
30
+ * accepts); omitted or `undefined` is UTC
31
+ * @returns ISO 8601 instant string (UTC), zoned ISO 8601 string when a timeZone is given, or "" on invalid input
32
+ *
33
+ * @example fromNanoseconds(0n) // "1970-01-01T00:00:00Z"
34
+ * @example fromNanoseconds(1710072000123456789n) // "2024-03-10T12:00:00.123456789Z"
35
+ * @example fromNanoseconds(1710072000123456789n, "Asia/Tokyo") // "2024-03-10T21:00:00.123456789+09:00[Asia/Tokyo]"
36
+ * @example fromNanoseconds(-1000000000n) // "1969-12-31T23:59:59Z"
37
+ * @example fromNanoseconds(0n, "Not/AZone") // ""
38
+ * @example fromNanoseconds(0n, undefined) // "1970-01-01T00:00:00Z" — undefined is the same as omitted
39
+ * @example fromNanoseconds(1710072000123456789) // "" — number, not bigint
40
+ */
41
+ function fromNanoseconds(nanoseconds, timeZone) {
42
+ if (timeZone === void 0) return instantStringFromEpochNanoseconds(nanoseconds);
43
+ if (!isValidEpochNanoseconds(nanoseconds) || typeof timeZone !== "string" || !isValidTimeZone(timeZone)) return "";
44
+ try {
45
+ return Temporal.Instant.fromEpochNanoseconds(nanoseconds).toZonedDateTimeISO(timeZone).toString();
46
+ } catch {
47
+ return "";
48
+ }
56
49
  }
50
+
51
+ export { fromNanoseconds };
@@ -40,4 +40,4 @@
40
40
  * @example fromNtpTimestamp(0n, undefined) // "1900-01-01T00:00:00Z" — undefined is era 0, as omitted
41
41
  * @example fromNtpTimestamp(0n, 1.5) // "" — an era must be a safe integer
42
42
  */
43
- export declare function fromNtpTimestamp(value: bigint, eraArg?: number): string;
43
+ export declare function fromNtpTimestamp(value: bigint, eraArg?: number): string;
@@ -1,57 +1,57 @@
1
- import { floorDivide, NANOSECONDS_PER_SECOND, NTP_EPOCH_OFFSET_NANOSECONDS, NTP_ERA_UNITS, NTP_UNITS_PER_SECOND, } 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";
2
3
  import { fromNanoseconds } from "./fromNanoseconds.js";
4
+
5
+ // src/precision/convert/fromNtpTimestamp.ts
3
6
  /**
4
- * Convert a 64-bit NTP timestamp (RFC 5905) back to an ISO 8601 instant string.
5
- *
6
- * - `value` is unsigned: the whole 64-bit timestamp, seconds since 1900-01-01 in the high
7
- * 32 bits and 2^-32 s units in the low 32. Values outside `0n`–`2^64 − 1` are rejected.
8
- * - **`era` is required information the value does not carry.** The seconds field wraps
9
- * every 2^32 seconds (~136.19 years), so one timestamp names one instant per era: era 0
10
- * is 1900-01-01 to 2036-02-07T06:28:15Z, era 1 starts at 2036-02-07T06:28:16Z, era -1
11
- * starts at 1763-11-24T17:31:44Z. It defaults to 0; `undefined` is the same as
12
- * omitting it, as TC39 treats an undefined argument as absent.
13
- * - Rounds to the nearest nanosecond. One NTP unit is ~233 ps, finer than an ISO string can
14
- * express, so rounding — not truncation — is what makes `fromNtpTimestamp(toNtpTimestamp(iso))`
15
- * return `iso` exactly rather than one nanosecond early.
16
- * - **The top two values of an era round onto the next era's first instant.** `2^64 − 1` and
17
- * `2^64 − 2` in era 0 both render as `"2036-02-07T06:28:16Z"`, which is where era 1 starts:
18
- * the last 0.47 ns of an era has no nanosecond of its own, and the nearest one is the era
19
- * boundary. `toNtpTimestamp` cannot produce either value from a nanosecond-precision
20
- * instant — its largest era-0 output is `18446744073709551611n` — so this does not affect
21
- * the round trip.
22
- * - **`0n` is two things on the wire.** RFC 5905 §6 defines the prime epoch as the instant
23
- * "when all bits are zero", and also says "a value of zero is a special case representing
24
- * unknown or unsynchronized time" — for example a reference timestamp sent before the first
25
- * sync. This function decodes `0n` as the era's first instant; a caller reading packet
26
- * fields should test for `0n` first when "unsynchronized" must not become a 1900 date.
27
- * - Returns "" when the resulting instant is outside the range `Temporal.Instant` can
28
- * represent, which a large `era` will reach.
29
- * - Returns "" on invalid input.
30
- *
31
- * @param value 64-bit NTP timestamp (bigint, 0n to 2^64 − 1)
32
- * @param eraArg optional 136-year era selector; omitted or `undefined` is era 0
33
- * @returns ISO 8601 instant string (UTC), or "" on invalid input
34
- *
35
- * @example fromNtpTimestamp(0n) // "1900-01-01T00:00:00Z" — the NTP epoch, and also RFC 5905's unknown or unsynchronized marker
36
- * @example fromNtpTimestamp(9487534653230284800n) // "1970-01-01T00:00:00Z"
37
- * @example fromNtpTimestamp(16832246972675778412n) // "2024-03-10T12:34:56.789Z"
38
- * @example fromNtpTimestamp(18446744069414584320n) // "2036-02-07T06:28:15Z" — the last second of era 0
39
- * @example fromNtpTimestamp(0n, 1) // "2036-02-07T06:28:16Z" — the same value, one era on
40
- * @example fromNtpTimestamp(0n, -1) // "1763-11-24T17:31:44Z"
41
- * @example fromNtpTimestamp(-1n) // "" — the timestamp is unsigned
42
- * @example fromNtpTimestamp(0n, undefined) // "1900-01-01T00:00:00Z" — undefined is era 0, as omitted
43
- * @example fromNtpTimestamp(0n, 1.5) // "" — an era must be a safe integer
44
- */
45
- export function fromNtpTimestamp(value, eraArg) {
46
- if (typeof value !== "bigint" || value < 0n || value >= NTP_ERA_UNITS) {
47
- return "";
48
- }
49
- // An explicit `undefined` is the same as omitting the argument (TC39 optional parameters).
50
- const era = eraArg === undefined ? 0 : eraArg;
51
- if (typeof era !== "number" || !Number.isSafeInteger(era)) {
52
- return "";
53
- }
54
- const units = value + BigInt(era) * NTP_ERA_UNITS;
55
- const nanoseconds = floorDivide(units * NANOSECONDS_PER_SECOND + NTP_UNITS_PER_SECOND / 2n, NTP_UNITS_PER_SECOND) - NTP_EPOCH_OFFSET_NANOSECONDS;
56
- return fromNanoseconds(nanoseconds);
7
+ * Convert a 64-bit NTP timestamp (RFC 5905) back to an ISO 8601 instant string.
8
+ *
9
+ * - `value` is unsigned: the whole 64-bit timestamp, seconds since 1900-01-01 in the high
10
+ * 32 bits and 2^-32 s units in the low 32. Values outside `0n`–`2^64 − 1` are rejected.
11
+ * - **`era` is required information the value does not carry.** The seconds field wraps
12
+ * every 2^32 seconds (~136.19 years), so one timestamp names one instant per era: era 0
13
+ * is 1900-01-01 to 2036-02-07T06:28:15Z, era 1 starts at 2036-02-07T06:28:16Z, era -1
14
+ * starts at 1763-11-24T17:31:44Z. It defaults to 0; `undefined` is the same as
15
+ * omitting it, as TC39 treats an undefined argument as absent.
16
+ * - Rounds to the nearest nanosecond. One NTP unit is ~233 ps, finer than an ISO string can
17
+ * express, so rounding — not truncation — is what makes `fromNtpTimestamp(toNtpTimestamp(iso))`
18
+ * return `iso` exactly rather than one nanosecond early.
19
+ * - **The top two values of an era round onto the next era's first instant.** `2^64 − 1` and
20
+ * `2^64 − 2` in era 0 both render as `"2036-02-07T06:28:16Z"`, which is where era 1 starts:
21
+ * the last 0.47 ns of an era has no nanosecond of its own, and the nearest one is the era
22
+ * boundary. `toNtpTimestamp` cannot produce either value from a nanosecond-precision
23
+ * instant — its largest era-0 output is `18446744073709551611n` — so this does not affect
24
+ * the round trip.
25
+ * - **`0n` is two things on the wire.** RFC 5905 §6 defines the prime epoch as the instant
26
+ * "when all bits are zero", and also says "a value of zero is a special case representing
27
+ * unknown or unsynchronized time" — for example a reference timestamp sent before the first
28
+ * sync. This function decodes `0n` as the era's first instant; a caller reading packet
29
+ * fields should test for `0n` first when "unsynchronized" must not become a 1900 date.
30
+ * - Returns "" when the resulting instant is outside the range `Temporal.Instant` can
31
+ * represent, which a large `era` will reach.
32
+ * - Returns "" on invalid input.
33
+ *
34
+ * @param value 64-bit NTP timestamp (bigint, 0n to 2^64 − 1)
35
+ * @param eraArg optional 136-year era selector; omitted or `undefined` is era 0
36
+ * @returns ISO 8601 instant string (UTC), or "" on invalid input
37
+ *
38
+ * @example fromNtpTimestamp(0n) // "1900-01-01T00:00:00Z" — the NTP epoch, and also RFC 5905's unknown or unsynchronized marker
39
+ * @example fromNtpTimestamp(9487534653230284800n) // "1970-01-01T00:00:00Z"
40
+ * @example fromNtpTimestamp(16832246972675778412n) // "2024-03-10T12:34:56.789Z"
41
+ * @example fromNtpTimestamp(18446744069414584320n) // "2036-02-07T06:28:15Z" — the last second of era 0
42
+ * @example fromNtpTimestamp(0n, 1) // "2036-02-07T06:28:16Z" — the same value, one era on
43
+ * @example fromNtpTimestamp(0n, -1) // "1763-11-24T17:31:44Z"
44
+ * @example fromNtpTimestamp(-1n) // "" — the timestamp is unsigned
45
+ * @example fromNtpTimestamp(0n, undefined) // "1900-01-01T00:00:00Z" — undefined is era 0, as omitted
46
+ * @example fromNtpTimestamp(0n, 1.5) // "" — an era must be a safe integer
47
+ */
48
+ function fromNtpTimestamp(value, eraArg) {
49
+ if (typeof value !== "bigint" || value < 0n || value >= 18446744073709551616n) return "";
50
+ const era = eraArg === void 0 ? 0 : eraArg;
51
+ if (typeof era !== "number" || !Number.isSafeInteger(era)) return "";
52
+ const units = value + BigInt(era) * NTP_ERA_UNITS;
53
+ const nanoseconds = floorDivide(units * NANOSECONDS_PER_SECOND + NTP_UNITS_PER_SECOND / 2n, NTP_UNITS_PER_SECOND) - NTP_EPOCH_OFFSET_NANOSECONDS;
54
+ return fromNanoseconds(nanoseconds);
57
55
  }
56
+
57
+ export { fromNtpTimestamp };
@@ -0,0 +1,34 @@
1
+ import { ParquetInt96 } from "./toParquetInt96.js";
2
+ /**
3
+ * Convert a Parquet `INT96` timestamp back to an ISO 8601 instant string.
4
+ *
5
+ * - **Deprecated format.** Read old files with this; write new ones with the `TIMESTAMP`
6
+ * logical type on `INT64` (`fromNanoseconds` and `toNanoseconds` cover that).
7
+ * - Accepts the 12 stored bytes (a `Uint8Array` or Node `Buffer`: `nanosOfDay` as a
8
+ * little-endian `int64`, then `julianDay` as a little-endian `int32`) or the
9
+ * `{ julianDay, nanosOfDay }` record most readers expose. Any other length of bytes is invalid.
10
+ * - `julianDay` is the Julian Day Number of the UTC date (2440588 is 1970-01-01) and must be an
11
+ * integer inside the instant range (far inside a signed 32-bit integer). `nanosOfDay` counts from that date's midnight, not noon, and must be
12
+ * a `bigint` in `[0n, 86_400_000_000_000n)`. parquet-format states no range; GMT rejects
13
+ * a full day or more so one instant has one spelling.
14
+ * - **No zone is recorded.** The value is always read as a UTC instant, as the Arrow and Spark
15
+ * readers do. Impala, the legacy writer, stored local wall-clock time instead, and nothing
16
+ * in the file says which writer made it: a value Impala wrote comes back as that wall time
17
+ * wrongly marked `Z`.
18
+ * - Returns "" on invalid input, including a result outside the instant range.
19
+ *
20
+ * @param value The 12 stored bytes, or a `{ julianDay, nanosOfDay }` record
21
+ * @returns ISO 8601 instant string (UTC), or "" on invalid input
22
+ *
23
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 0n }) // "1970-01-01T00:00:00Z"
24
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 1n }) // "1970-01-01T00:00:00.000000001Z"
25
+ * @example fromParquetInt96({ julianDay: 2440587, nanosOfDay: 86399999999999n }) // "1969-12-31T23:59:59.999999999Z"
26
+ * @example fromParquetInt96({ julianDay: 2460380, nanosOfDay: 45296789000000n }) // "2024-03-10T12:34:56.789Z"
27
+ * @example fromParquetInt96({ julianDay: 0, nanosOfDay: 0n }) // "-004713-11-24T00:00:00Z" — Julian Day 0
28
+ * @example fromParquetInt96(new Uint8Array([0, 0, 0, 0, 0, 0, 0, 0, 0x8c, 0x3d, 0x25, 0x00])) // "1970-01-01T00:00:00Z"
29
+ * @example fromParquetInt96({ julianDay: 102440588, nanosOfDay: 1n }) // "" — past the instant range
30
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 86400000000000n }) // "" — a full day of nanoseconds
31
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 0 }) // "" — number, not bigint
32
+ * @example fromParquetInt96(new Uint8Array(11)) // "" — not 12 bytes
33
+ */
34
+ export declare function fromParquetInt96(value: ParquetInt96 | Uint8Array): string;
@@ -0,0 +1,55 @@
1
+ import { JULIAN_DAY_OF_UNIX_EPOCH, NANOSECONDS_PER_DAY } from "../../internal/foreignEpochs.js";
2
+ import { instantStringFromEpochNanoseconds } from "../../internal/instantStringFromEpochNanoseconds.js";
3
+
4
+ // src/precision/convert/fromParquetInt96.ts
5
+ const BYTE_LENGTH = 12;
6
+ /**
7
+ * Convert a Parquet `INT96` timestamp back to an ISO 8601 instant string.
8
+ *
9
+ * - **Deprecated format.** Read old files with this; write new ones with the `TIMESTAMP`
10
+ * logical type on `INT64` (`fromNanoseconds` and `toNanoseconds` cover that).
11
+ * - Accepts the 12 stored bytes (a `Uint8Array` or Node `Buffer`: `nanosOfDay` as a
12
+ * little-endian `int64`, then `julianDay` as a little-endian `int32`) or the
13
+ * `{ julianDay, nanosOfDay }` record most readers expose. Any other length of bytes is invalid.
14
+ * - `julianDay` is the Julian Day Number of the UTC date (2440588 is 1970-01-01) and must be an
15
+ * integer inside the instant range (far inside a signed 32-bit integer). `nanosOfDay` counts from that date's midnight, not noon, and must be
16
+ * a `bigint` in `[0n, 86_400_000_000_000n)`. parquet-format states no range; GMT rejects
17
+ * a full day or more so one instant has one spelling.
18
+ * - **No zone is recorded.** The value is always read as a UTC instant, as the Arrow and Spark
19
+ * readers do. Impala, the legacy writer, stored local wall-clock time instead, and nothing
20
+ * in the file says which writer made it: a value Impala wrote comes back as that wall time
21
+ * wrongly marked `Z`.
22
+ * - Returns "" on invalid input, including a result outside the instant range.
23
+ *
24
+ * @param value The 12 stored bytes, or a `{ julianDay, nanosOfDay }` record
25
+ * @returns ISO 8601 instant string (UTC), or "" on invalid input
26
+ *
27
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 0n }) // "1970-01-01T00:00:00Z"
28
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 1n }) // "1970-01-01T00:00:00.000000001Z"
29
+ * @example fromParquetInt96({ julianDay: 2440587, nanosOfDay: 86399999999999n }) // "1969-12-31T23:59:59.999999999Z"
30
+ * @example fromParquetInt96({ julianDay: 2460380, nanosOfDay: 45296789000000n }) // "2024-03-10T12:34:56.789Z"
31
+ * @example fromParquetInt96({ julianDay: 0, nanosOfDay: 0n }) // "-004713-11-24T00:00:00Z" — Julian Day 0
32
+ * @example fromParquetInt96(new Uint8Array([0, 0, 0, 0, 0, 0, 0, 0, 0x8c, 0x3d, 0x25, 0x00])) // "1970-01-01T00:00:00Z"
33
+ * @example fromParquetInt96({ julianDay: 102440588, nanosOfDay: 1n }) // "" — past the instant range
34
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 86400000000000n }) // "" — a full day of nanoseconds
35
+ * @example fromParquetInt96({ julianDay: 2440588, nanosOfDay: 0 }) // "" — number, not bigint
36
+ * @example fromParquetInt96(new Uint8Array(11)) // "" — not 12 bytes
37
+ */
38
+ function fromParquetInt96(value) {
39
+ let nanosOfDay;
40
+ let julianDay;
41
+ try {
42
+ if (value instanceof Uint8Array) {
43
+ if (value.length !== BYTE_LENGTH) return "";
44
+ const view = new DataView(value.buffer, value.byteOffset, BYTE_LENGTH);
45
+ nanosOfDay = view.getBigInt64(0, true);
46
+ julianDay = view.getInt32(8, true);
47
+ } else ({nanosOfDay, julianDay} = value);
48
+ } catch {
49
+ return "";
50
+ }
51
+ if (!Number.isInteger(julianDay) || typeof nanosOfDay !== "bigint" || nanosOfDay < 0n || nanosOfDay >= 86400000000000n) return "";
52
+ return instantStringFromEpochNanoseconds(BigInt(julianDay - JULIAN_DAY_OF_UNIX_EPOCH) * NANOSECONDS_PER_DAY + nanosOfDay);
53
+ }
54
+
55
+ export { fromParquetInt96 };
@@ -23,4 +23,4 @@
23
23
  * @example fromPgMicroseconds(9223372036854775807n) // "" — int64 maximum, still past Temporal's range
24
24
  * @example fromPgMicroseconds(763387200123456) // "" — number, not bigint
25
25
  */
26
- export declare function fromPgMicroseconds(value: bigint): string;
26
+ export declare function fromPgMicroseconds(value: bigint): string;