@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
@@ -0,0 +1,41 @@
1
+ /**
2
+ * A protobuf `google.protobuf.Duration` as protobuf libraries expose it.
3
+ */
4
+ export interface ProtoDuration {
5
+ /**
6
+ * Whole seconds (an `int64`), in `[-315576000000n, 315576000000n]` (about ±10,000 years).
7
+ */
8
+ seconds: bigint;
9
+ /**
10
+ * Nanoseconds, an integer in `[-999999999, 999999999]`. When `seconds` is not zero, `nanos` is
11
+ * zero or has the same sign as `seconds`.
12
+ */
13
+ nanos: number;
14
+ }
15
+ /**
16
+ * Convert an ISO 8601 duration string to a protobuf `google.protobuf.Duration` record.
17
+ *
18
+ * - **Same sign.** Unlike `Timestamp`, a negative `Duration` has a negative `nanos` too:
19
+ * `-PT1.5S` is `{ seconds: -1n, nanos: -500000000 }`, not `{ seconds: -2n, nanos: 500000000 }`.
20
+ * - A day is exactly 24 hours, as TC39 Temporal reads a day without a `relativeTo`; protobuf has
21
+ * no day unit. `P1D` is 86400 seconds.
22
+ * - Years, months and weeks have no fixed length and return `null`.
23
+ * - Exact: nothing is rounded. `seconds` is a `bigint` (`int64`); `seconds` beyond ±315576000000,
24
+ * the range `duration.proto` states, returns `null`. `seconds` and `nanos` are bounded separately.
25
+ * - Returns `null` on invalid input.
26
+ *
27
+ * @param isoDuration ISO 8601 duration string (e.g. "PT1H30M1.5S")
28
+ * @returns `{ seconds, nanos }`, or `null` on invalid input
29
+ *
30
+ * @example toProtoDuration("PT1H30M1.5S") // { seconds: 5401n, nanos: 500000000 }
31
+ * @example toProtoDuration("-PT1.5S") // { seconds: -1n, nanos: -500000000 } — nanos take seconds' sign
32
+ * @example toProtoDuration("-PT0.5S") // { seconds: 0n, nanos: -500000000 }
33
+ * @example toProtoDuration("P1D") // { seconds: 86400n, nanos: 0 } — a day is 24 hours
34
+ * @example toProtoDuration("PT0S") // { seconds: 0n, nanos: 0 }
35
+ * @example toProtoDuration("PT315576000000S") // { seconds: 315576000000n, nanos: 0 }
36
+ * @example toProtoDuration("PT315576000000.000000001S") // { seconds: 315576000000n, nanos: 1 } — seconds and nanos are bounded separately
37
+ * @example toProtoDuration("PT315576000001S") // null — seconds past the protobuf range
38
+ * @example toProtoDuration("P1M") // null — a month has no fixed length
39
+ * @example toProtoDuration("invalid") // null
40
+ */
41
+ export declare function toProtoDuration(isoDuration: string): ProtoDuration | null;
@@ -0,0 +1,42 @@
1
+ import { NANOSECONDS_PER_SECOND, PROTO_DURATION_MAX_SECONDS } from "../../internal/foreignEpochs.js";
2
+ import { exactDurationNanoseconds } from "../../internal/exactDuration.js";
3
+
4
+ // src/precision/convert/toProtoDuration.ts
5
+ /**
6
+ * Convert an ISO 8601 duration string to a protobuf `google.protobuf.Duration` record.
7
+ *
8
+ * - **Same sign.** Unlike `Timestamp`, a negative `Duration` has a negative `nanos` too:
9
+ * `-PT1.5S` is `{ seconds: -1n, nanos: -500000000 }`, not `{ seconds: -2n, nanos: 500000000 }`.
10
+ * - A day is exactly 24 hours, as TC39 Temporal reads a day without a `relativeTo`; protobuf has
11
+ * no day unit. `P1D` is 86400 seconds.
12
+ * - Years, months and weeks have no fixed length and return `null`.
13
+ * - Exact: nothing is rounded. `seconds` is a `bigint` (`int64`); `seconds` beyond ±315576000000,
14
+ * the range `duration.proto` states, returns `null`. `seconds` and `nanos` are bounded separately.
15
+ * - Returns `null` on invalid input.
16
+ *
17
+ * @param isoDuration ISO 8601 duration string (e.g. "PT1H30M1.5S")
18
+ * @returns `{ seconds, nanos }`, or `null` on invalid input
19
+ *
20
+ * @example toProtoDuration("PT1H30M1.5S") // { seconds: 5401n, nanos: 500000000 }
21
+ * @example toProtoDuration("-PT1.5S") // { seconds: -1n, nanos: -500000000 } — nanos take seconds' sign
22
+ * @example toProtoDuration("-PT0.5S") // { seconds: 0n, nanos: -500000000 }
23
+ * @example toProtoDuration("P1D") // { seconds: 86400n, nanos: 0 } — a day is 24 hours
24
+ * @example toProtoDuration("PT0S") // { seconds: 0n, nanos: 0 }
25
+ * @example toProtoDuration("PT315576000000S") // { seconds: 315576000000n, nanos: 0 }
26
+ * @example toProtoDuration("PT315576000000.000000001S") // { seconds: 315576000000n, nanos: 1 } — seconds and nanos are bounded separately
27
+ * @example toProtoDuration("PT315576000001S") // null — seconds past the protobuf range
28
+ * @example toProtoDuration("P1M") // null — a month has no fixed length
29
+ * @example toProtoDuration("invalid") // null
30
+ */
31
+ function toProtoDuration(isoDuration) {
32
+ const nanoseconds = exactDurationNanoseconds(isoDuration);
33
+ if (nanoseconds === null) return null;
34
+ const seconds = nanoseconds / NANOSECONDS_PER_SECOND;
35
+ if (seconds < -315576000000n || seconds > 315576000000n) return null;
36
+ return {
37
+ seconds,
38
+ nanos: Number(nanoseconds % NANOSECONDS_PER_SECOND)
39
+ };
40
+ }
41
+
42
+ export { toProtoDuration };
@@ -0,0 +1,41 @@
1
+ /**
2
+ * A protobuf `google.protobuf.Timestamp` as protobuf libraries expose it.
3
+ */
4
+ export interface ProtoTimestamp {
5
+ /**
6
+ * Whole seconds since 1970-01-01T00:00:00Z (an `int64`), in
7
+ * `[-62135596800n, 253402300799n]`: 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z.
8
+ */
9
+ seconds: bigint;
10
+ /**
11
+ * Nanoseconds of the second, an integer in `[0, 999999999]`. It counts forward in time even
12
+ * when `seconds` is negative.
13
+ */
14
+ nanos: number;
15
+ }
16
+ /**
17
+ * Convert an ISO 8601 instant string to a protobuf `google.protobuf.Timestamp` record.
18
+ *
19
+ * - `nanos` always counts **forward** from `seconds`, also for instants before the epoch: half a
20
+ * second before 1970 is `{ seconds: -1n, nanos: 500000000 }`, never `{ seconds: 0n, nanos: -500000000 }`.
21
+ * - Exact: nothing is rounded. An offset or zone in the input is applied first.
22
+ * - `seconds` is a `bigint` (`int64`). The range is the one `timestamp.proto` states,
23
+ * 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z; an instant outside it returns `null`.
24
+ * - A leap second (`23:59:60`) is invalid: protobuf smears leap seconds, so it has no value here.
25
+ * - Returns `null` on invalid input.
26
+ *
27
+ * @param isoString ISO 8601 instant string (e.g. "2024-03-10T12:34:56.789Z")
28
+ * @returns `{ seconds, nanos }`, or `null` on invalid input
29
+ *
30
+ * @example toProtoTimestamp("1970-01-01T00:00:00Z") // { seconds: 0n, nanos: 0 }
31
+ * @example toProtoTimestamp("1969-12-31T23:59:59.5Z") // { seconds: -1n, nanos: 500000000 } — nanos count forward
32
+ * @example toProtoTimestamp("2024-03-10T12:34:56.789Z") // { seconds: 1710074096n, nanos: 789000000 }
33
+ * @example toProtoTimestamp("2024-03-10T13:34:56.789+01:00[Europe/Paris]") // { seconds: 1710074096n, nanos: 789000000 }
34
+ * @example toProtoTimestamp("0001-01-01T00:00:00Z") // { seconds: -62135596800n, nanos: 0 }
35
+ * @example toProtoTimestamp("9999-12-31T23:59:59.999999999Z") // { seconds: 253402300799n, nanos: 999999999 }
36
+ * @example toProtoTimestamp("+010000-01-01T00:00:00Z") // null — past the protobuf range
37
+ * @example toProtoTimestamp("2016-12-31T23:59:60Z") // null — leap second
38
+ * @example toProtoTimestamp("2024-03-10T12:34:56") // null — no offset designator
39
+ * @example toProtoTimestamp("invalid") // null
40
+ */
41
+ export declare function toProtoTimestamp(isoString: string): ProtoTimestamp | null;
@@ -0,0 +1,42 @@
1
+ import { floorDivide } from "../../internal/floorDivide.js";
2
+ import { NANOSECONDS_PER_SECOND, PROTO_TIMESTAMP_MAX_SECONDS, PROTO_TIMESTAMP_MIN_SECONDS } from "../../internal/foreignEpochs.js";
3
+ import { parseInstantNanoseconds } from "../../internal/instantNanoseconds.js";
4
+
5
+ // src/precision/convert/toProtoTimestamp.ts
6
+ /**
7
+ * Convert an ISO 8601 instant string to a protobuf `google.protobuf.Timestamp` record.
8
+ *
9
+ * - `nanos` always counts **forward** from `seconds`, also for instants before the epoch: half a
10
+ * second before 1970 is `{ seconds: -1n, nanos: 500000000 }`, never `{ seconds: 0n, nanos: -500000000 }`.
11
+ * - Exact: nothing is rounded. An offset or zone in the input is applied first.
12
+ * - `seconds` is a `bigint` (`int64`). The range is the one `timestamp.proto` states,
13
+ * 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z; an instant outside it returns `null`.
14
+ * - A leap second (`23:59:60`) is invalid: protobuf smears leap seconds, so it has no value here.
15
+ * - Returns `null` on invalid input.
16
+ *
17
+ * @param isoString ISO 8601 instant string (e.g. "2024-03-10T12:34:56.789Z")
18
+ * @returns `{ seconds, nanos }`, or `null` on invalid input
19
+ *
20
+ * @example toProtoTimestamp("1970-01-01T00:00:00Z") // { seconds: 0n, nanos: 0 }
21
+ * @example toProtoTimestamp("1969-12-31T23:59:59.5Z") // { seconds: -1n, nanos: 500000000 } — nanos count forward
22
+ * @example toProtoTimestamp("2024-03-10T12:34:56.789Z") // { seconds: 1710074096n, nanos: 789000000 }
23
+ * @example toProtoTimestamp("2024-03-10T13:34:56.789+01:00[Europe/Paris]") // { seconds: 1710074096n, nanos: 789000000 }
24
+ * @example toProtoTimestamp("0001-01-01T00:00:00Z") // { seconds: -62135596800n, nanos: 0 }
25
+ * @example toProtoTimestamp("9999-12-31T23:59:59.999999999Z") // { seconds: 253402300799n, nanos: 999999999 }
26
+ * @example toProtoTimestamp("+010000-01-01T00:00:00Z") // null — past the protobuf range
27
+ * @example toProtoTimestamp("2016-12-31T23:59:60Z") // null — leap second
28
+ * @example toProtoTimestamp("2024-03-10T12:34:56") // null — no offset designator
29
+ * @example toProtoTimestamp("invalid") // null
30
+ */
31
+ function toProtoTimestamp(isoString) {
32
+ const nanoseconds = parseInstantNanoseconds(isoString);
33
+ if (nanoseconds === null) return null;
34
+ const seconds = floorDivide(nanoseconds, NANOSECONDS_PER_SECOND);
35
+ if (seconds < -62135596800n || seconds > 253402300799n) return null;
36
+ return {
37
+ seconds,
38
+ nanos: Number(nanoseconds - seconds * NANOSECONDS_PER_SECOND)
39
+ };
40
+ }
41
+
42
+ export { toProtoTimestamp };
@@ -23,4 +23,4 @@
23
23
  * @example formatNanoseconds(1710072000123456789) // "" — number, not bigint
24
24
  * @example formatNanoseconds(8640000000000000000001n) // "" — outside the instant range
25
25
  */
26
- export declare function formatNanoseconds(nanoseconds: bigint): string;
26
+ export declare function formatNanoseconds(nanoseconds: bigint): string;
@@ -1,32 +1,34 @@
1
- import { isValidEpochNanoseconds } from "../../internal/index.js";
1
+ import { isValidEpochNanoseconds } from "../../internal/epochNanoseconds.js";
2
+
3
+ // src/precision/format/formatNanoseconds.ts
2
4
  /**
3
- * Format nanoseconds since the Unix epoch as a decimal string, for JSON and other
4
- * text transports.
5
- *
6
- * - `JSON.stringify` throws a `TypeError` on a `bigint`, so a nanosecond timestamp cannot
7
- * go into a JSON payload as-is. This is the bridge every consumer needs; do not hand-roll it.
8
- * - The output is a canonical decimal integer: an optional `-`, then digits, no leading zeros,
9
- * no exponent, no separators. `parseNanoseconds` is its exact inverse.
10
- * - **Put the result in JSON as a string, not a number.** It is itself only the value —
11
- * `{ observedAt: formatNanoseconds(n) }` serialises to `{"observedAt":"1710072000123456789"}`.
12
- * Emitted unquoted it is a JSON number, and `JSON.parse` rounds it back through a double
13
- * to `1710072000123456800` — the exact loss this namespace exists to prevent.
14
- * - Rejects values outside the range `Temporal.Instant` can represent
15
- * (±8_640_000_000_000_000_000_000n), so anything formatted here can be read back and rendered.
16
- * - Returns "" on invalid input.
17
- *
18
- * @param nanoseconds nanoseconds since the Unix epoch (bigint)
19
- * @returns decimal string form of the value, or "" on invalid input
20
- *
21
- * @example formatNanoseconds(1710072000123456789n) // "1710072000123456789"
22
- * @example formatNanoseconds(0n) // "0"
23
- * @example formatNanoseconds(-1000000000n) // "-1000000000"
24
- * @example formatNanoseconds(1710072000123456789) // "" — number, not bigint
25
- * @example formatNanoseconds(8640000000000000000001n) // "" — outside the instant range
26
- */
27
- export function formatNanoseconds(nanoseconds) {
28
- if (!isValidEpochNanoseconds(nanoseconds)) {
29
- return "";
30
- }
31
- return nanoseconds.toString();
5
+ * Format nanoseconds since the Unix epoch as a decimal string, for JSON and other
6
+ * text transports.
7
+ *
8
+ * - `JSON.stringify` throws a `TypeError` on a `bigint`, so a nanosecond timestamp cannot
9
+ * go into a JSON payload as-is. This is the bridge every consumer needs; do not hand-roll it.
10
+ * - The output is a canonical decimal integer: an optional `-`, then digits, no leading zeros,
11
+ * no exponent, no separators. `parseNanoseconds` is its exact inverse.
12
+ * - **Put the result in JSON as a string, not a number.** It is itself only the value —
13
+ * `{ observedAt: formatNanoseconds(n) }` serialises to `{"observedAt":"1710072000123456789"}`.
14
+ * Emitted unquoted it is a JSON number, and `JSON.parse` rounds it back through a double
15
+ * to `1710072000123456800` — the exact loss this namespace exists to prevent.
16
+ * - Rejects values outside the range `Temporal.Instant` can represent
17
+ * (±8_640_000_000_000_000_000_000n), so anything formatted here can be read back and rendered.
18
+ * - Returns "" on invalid input.
19
+ *
20
+ * @param nanoseconds nanoseconds since the Unix epoch (bigint)
21
+ * @returns decimal string form of the value, or "" on invalid input
22
+ *
23
+ * @example formatNanoseconds(1710072000123456789n) // "1710072000123456789"
24
+ * @example formatNanoseconds(0n) // "0"
25
+ * @example formatNanoseconds(-1000000000n) // "-1000000000"
26
+ * @example formatNanoseconds(1710072000123456789) // "" — number, not bigint
27
+ * @example formatNanoseconds(8640000000000000000001n) // "" — outside the instant range
28
+ */
29
+ function formatNanoseconds(nanoseconds) {
30
+ if (!isValidEpochNanoseconds(nanoseconds)) return "";
31
+ return nanoseconds.toString();
32
32
  }
33
+
34
+ export { formatNanoseconds };
@@ -1 +1,2 @@
1
- export * from "./formatNanoseconds.js";
1
+ import { formatNanoseconds } from "./formatNanoseconds.js";
2
+ export { formatNanoseconds };
@@ -1 +1,3 @@
1
- export * from "./formatNanoseconds.js";
1
+ import { formatNanoseconds } from "./formatNanoseconds.js";
2
+
3
+ export { formatNanoseconds };
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Read the instant a KSUID carries (segmentio/ksuid, `ksuid.go` and `base62.go`).
3
+ *
4
+ * - 27 base62 characters (`0-9A-Za-z`) encode 20 bytes: a 4-byte big-endian unsigned count
5
+ * of seconds, then 16 bytes of payload. The payload is validated, never read.
6
+ * - The count starts at the KSUID epoch, 2014-05-13T16:53:20Z (Unix 1 400 000 000), not 1970.
7
+ * The all-zero KSUID is that instant, and no KSUID can name an earlier second.
8
+ * - Case-sensitive, unlike UUID and ULID: `a` and `A` are different digits, so lower-casing or
9
+ * upper-casing a KSUID changes the instant it reads (or makes it invalid).
10
+ * - 27 digits hold more than 20 bytes. Anything above `aWgEPTl1tmebfsQzFP4bxwgy80V` is
11
+ * rejected, as `Parse` rejects it.
12
+ * - Second precision: the result never has a fraction.
13
+ * - Returns "" on invalid input and never throws.
14
+ *
15
+ * @param ksuid 27-character KSUID text
16
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
17
+ *
18
+ * @example fromKsuid("0ujtsYcgvSTl8PAuAdqWYSMnLOv") // "2017-10-10T04:00:47Z" — the README inspect example
19
+ * @example fromKsuid("0ujzPyRiIAffKhBux4PvQdDqMHY") // "2017-10-10T04:46:20Z"
20
+ * @example fromKsuid("000000000000000000000000000") // "2014-05-13T16:53:20Z" — the KSUID epoch, not 1970
21
+ * @example fromKsuid("aWgEPTl1tmebfsQzFP4bxwgy80V") // "2150-06-19T23:21:35Z" — the largest valid KSUID
22
+ * @example fromKsuid("0UJTSYCGVSTL8PAUADQWYSMNLOV") // "2016-03-09T02:31:53Z" — upper case is a different KSUID
23
+ * @example fromKsuid("0ujtsycgvstl8pauadqwysmnlov") // "2017-10-10T04:00:51Z" — lower case is another one
24
+ * @example fromKsuid("aWgEPTl1tmebfsQzFP4bxwgy80W") // "" — one above the maximum
25
+ * @example fromKsuid("0ujtsYcgvSTl8PAuAdqWYSMnLO") // "" — 26 characters
26
+ * @example fromKsuid("0ujtsYcgvSTl8PAuAdqWYSMnLO-") // "" — not base62
27
+ */
28
+ export declare function fromKsuid(ksuid: string): string;
@@ -0,0 +1,41 @@
1
+ import { KSUID_EPOCH_SECONDS, NANOSECONDS_PER_SECOND } from "../../internal/foreignEpochs.js";
2
+ import { instantStringFromEpochNanoseconds } from "../../internal/instantStringFromEpochNanoseconds.js";
3
+ import { BASE62_ALPHABET, digitsValue, ksuidText } from "../../internal/identifierText.js";
4
+
5
+ // src/precision/identifiers/fromKsuid.ts
6
+ /**
7
+ * Read the instant a KSUID carries (segmentio/ksuid, `ksuid.go` and `base62.go`).
8
+ *
9
+ * - 27 base62 characters (`0-9A-Za-z`) encode 20 bytes: a 4-byte big-endian unsigned count
10
+ * of seconds, then 16 bytes of payload. The payload is validated, never read.
11
+ * - The count starts at the KSUID epoch, 2014-05-13T16:53:20Z (Unix 1 400 000 000), not 1970.
12
+ * The all-zero KSUID is that instant, and no KSUID can name an earlier second.
13
+ * - Case-sensitive, unlike UUID and ULID: `a` and `A` are different digits, so lower-casing or
14
+ * upper-casing a KSUID changes the instant it reads (or makes it invalid).
15
+ * - 27 digits hold more than 20 bytes. Anything above `aWgEPTl1tmebfsQzFP4bxwgy80V` is
16
+ * rejected, as `Parse` rejects it.
17
+ * - Second precision: the result never has a fraction.
18
+ * - Returns "" on invalid input and never throws.
19
+ *
20
+ * @param ksuid 27-character KSUID text
21
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
22
+ *
23
+ * @example fromKsuid("0ujtsYcgvSTl8PAuAdqWYSMnLOv") // "2017-10-10T04:00:47Z" — the README inspect example
24
+ * @example fromKsuid("0ujzPyRiIAffKhBux4PvQdDqMHY") // "2017-10-10T04:46:20Z"
25
+ * @example fromKsuid("000000000000000000000000000") // "2014-05-13T16:53:20Z" — the KSUID epoch, not 1970
26
+ * @example fromKsuid("aWgEPTl1tmebfsQzFP4bxwgy80V") // "2150-06-19T23:21:35Z" — the largest valid KSUID
27
+ * @example fromKsuid("0UJTSYCGVSTL8PAUADQWYSMNLOV") // "2016-03-09T02:31:53Z" — upper case is a different KSUID
28
+ * @example fromKsuid("0ujtsycgvstl8pauadqwysmnlov") // "2017-10-10T04:00:51Z" — lower case is another one
29
+ * @example fromKsuid("aWgEPTl1tmebfsQzFP4bxwgy80W") // "" — one above the maximum
30
+ * @example fromKsuid("0ujtsYcgvSTl8PAuAdqWYSMnLO") // "" — 26 characters
31
+ * @example fromKsuid("0ujtsYcgvSTl8PAuAdqWYSMnLO-") // "" — not base62
32
+ */
33
+ function fromKsuid(ksuid) {
34
+ if (typeof ksuid !== "string" || !ksuidText.test(ksuid)) return "";
35
+ const value = digitsValue(ksuid, BASE62_ALPHABET);
36
+ if (BigInt.asUintN(160, value) !== value) return "";
37
+ const seconds = (value >> 128n) + KSUID_EPOCH_SECONDS;
38
+ return instantStringFromEpochNanoseconds(seconds * NANOSECONDS_PER_SECOND);
39
+ }
40
+
41
+ export { fromKsuid };
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Read the creation second a MongoDB ObjectId carries (mongodb/specifications
3
+ * `bson-objectid/objectid.md`, § Specification and § Timestamp Field).
4
+ *
5
+ * - The first 4 of the 12 bytes (8 of the 24 hex digits) are a big-endian count of seconds
6
+ * since the Unix epoch. The spec says drivers "MUST interpret this value as an unsigned
7
+ * 32-bit integer", so the range is 1970-01-01T00:00:00Z to 2106-02-07T06:28:15Z and `8…`
8
+ * is 2038, never 1901.
9
+ * - The other 8 bytes are a per-process random value and a counter (§ Random Value,
10
+ * § Counter). They are validated, never read: they carry no time.
11
+ * - The time is the clock of whichever process made the id (usually the driver, sometimes the
12
+ * server when it fills in a missing `_id`), which may differ from the insert time.
13
+ * - Some older drivers read the field as signed, which puts every id after
14
+ * 2038-01-19T03:14:07Z before 1970. This function follows the spec's unsigned rule.
15
+ * - Either hex case is read. Only the 24-digit string is accepted: not the 12 raw bytes and
16
+ * not the shell form `ObjectId("…")`.
17
+ * - Second precision: the result never has a fraction.
18
+ * - Returns "" on invalid input and never throws.
19
+ *
20
+ * @param objectId 24-character hex ObjectId text
21
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
22
+ *
23
+ * @example fromObjectId("65a0f4d0c3b1a2e4f5d6c7b8") // "2024-01-12T08:14:08Z"
24
+ * @example fromObjectId("000000000000000000000000") // "1970-01-01T00:00:00Z"
25
+ * @example fromObjectId("7fffffff0000000000000000") // "2038-01-19T03:14:07Z"
26
+ * @example fromObjectId("800000000000000000000000") // "2038-01-19T03:14:08Z" — unsigned, not 1901
27
+ * @example fromObjectId("FFFFFFFF0000000000000000") // "2106-02-07T06:28:15Z" — upper case
28
+ * @example fromObjectId("65a0f4d0c3b1a2e4f5d6c7b") // "" — 23 characters
29
+ * @example fromObjectId("65a0f4d0c3b1a2e4f5d6c7bg") // "" — not hex
30
+ * @example fromObjectId('ObjectId("65a0f4d0c3b1a2e4f5d6c7b8")') // "" — shell form
31
+ */
32
+ export declare function fromObjectId(objectId: string): string;
@@ -0,0 +1,43 @@
1
+ import { NANOSECONDS_PER_SECOND } from "../../internal/foreignEpochs.js";
2
+ import { instantStringFromEpochNanoseconds } from "../../internal/instantStringFromEpochNanoseconds.js";
3
+ import { hexValue, objectIdText } from "../../internal/identifierText.js";
4
+
5
+ // src/precision/identifiers/fromObjectId.ts
6
+ /**
7
+ * Read the creation second a MongoDB ObjectId carries (mongodb/specifications
8
+ * `bson-objectid/objectid.md`, § Specification and § Timestamp Field).
9
+ *
10
+ * - The first 4 of the 12 bytes (8 of the 24 hex digits) are a big-endian count of seconds
11
+ * since the Unix epoch. The spec says drivers "MUST interpret this value as an unsigned
12
+ * 32-bit integer", so the range is 1970-01-01T00:00:00Z to 2106-02-07T06:28:15Z and `8…`
13
+ * is 2038, never 1901.
14
+ * - The other 8 bytes are a per-process random value and a counter (§ Random Value,
15
+ * § Counter). They are validated, never read: they carry no time.
16
+ * - The time is the clock of whichever process made the id (usually the driver, sometimes the
17
+ * server when it fills in a missing `_id`), which may differ from the insert time.
18
+ * - Some older drivers read the field as signed, which puts every id after
19
+ * 2038-01-19T03:14:07Z before 1970. This function follows the spec's unsigned rule.
20
+ * - Either hex case is read. Only the 24-digit string is accepted: not the 12 raw bytes and
21
+ * not the shell form `ObjectId("…")`.
22
+ * - Second precision: the result never has a fraction.
23
+ * - Returns "" on invalid input and never throws.
24
+ *
25
+ * @param objectId 24-character hex ObjectId text
26
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
27
+ *
28
+ * @example fromObjectId("65a0f4d0c3b1a2e4f5d6c7b8") // "2024-01-12T08:14:08Z"
29
+ * @example fromObjectId("000000000000000000000000") // "1970-01-01T00:00:00Z"
30
+ * @example fromObjectId("7fffffff0000000000000000") // "2038-01-19T03:14:07Z"
31
+ * @example fromObjectId("800000000000000000000000") // "2038-01-19T03:14:08Z" — unsigned, not 1901
32
+ * @example fromObjectId("FFFFFFFF0000000000000000") // "2106-02-07T06:28:15Z" — upper case
33
+ * @example fromObjectId("65a0f4d0c3b1a2e4f5d6c7b") // "" — 23 characters
34
+ * @example fromObjectId("65a0f4d0c3b1a2e4f5d6c7bg") // "" — not hex
35
+ * @example fromObjectId('ObjectId("65a0f4d0c3b1a2e4f5d6c7b8")') // "" — shell form
36
+ */
37
+ function fromObjectId(objectId) {
38
+ if (typeof objectId !== "string" || !objectIdText.test(objectId)) return "";
39
+ const seconds = hexValue(objectId.slice(0, 8));
40
+ return instantStringFromEpochNanoseconds(seconds * NANOSECONDS_PER_SECOND);
41
+ }
42
+
43
+ export { fromObjectId };
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Where the timestamp sits in a Snowflake id. A Snowflake is a layout, not a standard: each
3
+ * service picks its own epoch and bit split, so the caller passes the layout and GMT bundles
4
+ * no vendor presets.
5
+ */
6
+ export interface SnowflakeLayout {
7
+ /** Unix milliseconds of the layout's epoch. A safe integer; negative is allowed. */
8
+ epochMs: number;
9
+ /** Number of bits below the timestamp field (22 for Twitter and Discord). An integer in `[0, 63]`. Required. */
10
+ shift: number;
11
+ /**
12
+ * Width of the timestamp field in bits. An integer in `[1, 64 - shift]`.
13
+ *
14
+ * @defaultValue `64 - shift`, every bit above the shift
15
+ */
16
+ timestampBits?: number;
17
+ }
18
+ /**
19
+ * Read the instant a Snowflake id carries, using a layout the caller supplies.
20
+ *
21
+ * - The timestamp field is `(id >> shift)` masked to `timestampBits`, counted in milliseconds
22
+ * from `epochMs`. The instant is the generator's clock, to the millisecond.
23
+ * - **Say which layout the id came from.** A wrong epoch gives a plausible wrong date, not an
24
+ * error: the same id under Twitter's and Discord's epochs differs by over four years.
25
+ * - Pass ids as a `bigint` or a decimal `string`, never a `number`. Ids above 2^53 lose digits
26
+ * as numbers (which is why Discord sends them as strings), so a `number` is refused rather
27
+ * than decoded wrongly. A `bigint` must be in `[0, 2^64 - 1]`; a `string` must be 1 to 20
28
+ * ASCII digits with no sign or space, and no larger than 2^64 - 1.
29
+ * - Another tick size (Sonyflake counts 10 ms) is not supported.
30
+ * - Returns "" on invalid input, including a result outside the instant range. Never throws,
31
+ * even if reading `layout` does.
32
+ *
33
+ * @param id The Snowflake as a `bigint` or a decimal string
34
+ * @param layout `{ epochMs, shift, timestampBits? }` for the service that issued the id
35
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
36
+ *
37
+ * @example fromSnowflake("175928847299117063", { epochMs: 1420070400000, shift: 22 }) // "2016-04-30T11:18:25.796Z" — Discord layout
38
+ * @example fromSnowflake("1050118621198921728", { epochMs: 1288834974657, shift: 22, timestampBits: 41 }) // "2018-10-10T20:19:24.211Z" — Twitter layout
39
+ * @example fromSnowflake("1050118621198921728", { epochMs: 1420070400000, shift: 22 }) // "2022-12-07T18:36:29.554Z" — same id, other epoch: a different instant
40
+ * @example fromSnowflake(1704067200000n, { epochMs: 0, shift: 0 }) // "2024-01-01T00:00:00Z"
41
+ * @example fromSnowflake(175928847299117063, { epochMs: 1420070400000, shift: 22 }) // "" — number, not bigint or string
42
+ * @example fromSnowflake("1", { epochMs: 1420070400000 }) // "" — shift missing
43
+ */
44
+ export declare function fromSnowflake(id: bigint | string, layout: SnowflakeLayout): string;
@@ -0,0 +1,48 @@
1
+ import { NANOSECONDS_PER_MILLISECOND } from "../../internal/foreignEpochs.js";
2
+ import { instantStringFromEpochNanoseconds } from "../../internal/instantStringFromEpochNanoseconds.js";
3
+ import { unsignedDecimalText } from "../../internal/identifierText.js";
4
+
5
+ // src/precision/identifiers/fromSnowflake.ts
6
+ /**
7
+ * Read the instant a Snowflake id carries, using a layout the caller supplies.
8
+ *
9
+ * - The timestamp field is `(id >> shift)` masked to `timestampBits`, counted in milliseconds
10
+ * from `epochMs`. The instant is the generator's clock, to the millisecond.
11
+ * - **Say which layout the id came from.** A wrong epoch gives a plausible wrong date, not an
12
+ * error: the same id under Twitter's and Discord's epochs differs by over four years.
13
+ * - Pass ids as a `bigint` or a decimal `string`, never a `number`. Ids above 2^53 lose digits
14
+ * as numbers (which is why Discord sends them as strings), so a `number` is refused rather
15
+ * than decoded wrongly. A `bigint` must be in `[0, 2^64 - 1]`; a `string` must be 1 to 20
16
+ * ASCII digits with no sign or space, and no larger than 2^64 - 1.
17
+ * - Another tick size (Sonyflake counts 10 ms) is not supported.
18
+ * - Returns "" on invalid input, including a result outside the instant range. Never throws,
19
+ * even if reading `layout` does.
20
+ *
21
+ * @param id The Snowflake as a `bigint` or a decimal string
22
+ * @param layout `{ epochMs, shift, timestampBits? }` for the service that issued the id
23
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
24
+ *
25
+ * @example fromSnowflake("175928847299117063", { epochMs: 1420070400000, shift: 22 }) // "2016-04-30T11:18:25.796Z" — Discord layout
26
+ * @example fromSnowflake("1050118621198921728", { epochMs: 1288834974657, shift: 22, timestampBits: 41 }) // "2018-10-10T20:19:24.211Z" — Twitter layout
27
+ * @example fromSnowflake("1050118621198921728", { epochMs: 1420070400000, shift: 22 }) // "2022-12-07T18:36:29.554Z" — same id, other epoch: a different instant
28
+ * @example fromSnowflake(1704067200000n, { epochMs: 0, shift: 0 }) // "2024-01-01T00:00:00Z"
29
+ * @example fromSnowflake(175928847299117063, { epochMs: 1420070400000, shift: 22 }) // "" — number, not bigint or string
30
+ * @example fromSnowflake("1", { epochMs: 1420070400000 }) // "" — shift missing
31
+ */
32
+ function fromSnowflake(id, layout) {
33
+ const value = typeof id === "bigint" ? id : typeof id === "string" && unsignedDecimalText.test(id) ? BigInt(id) : -1n;
34
+ if (BigInt.asUintN(64, value) !== value) return "";
35
+ let epochMs;
36
+ let shift = 0;
37
+ let timestampBits;
38
+ try {
39
+ ({epochMs, shift, timestampBits = 64 - shift} = layout);
40
+ if (!Number.isSafeInteger(epochMs) || (shift & 63) !== shift || !Number.isInteger(timestampBits) || timestampBits < 1 || timestampBits > 64 - shift) return "";
41
+ } catch {
42
+ return "";
43
+ }
44
+ const ticks = value >> BigInt(shift) & (1n << BigInt(timestampBits)) - 1n;
45
+ return instantStringFromEpochNanoseconds((ticks + BigInt(epochMs)) * NANOSECONDS_PER_MILLISECOND);
46
+ }
47
+
48
+ export { fromSnowflake };
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Read the instant a ULID carries (ulid/spec README, § Components and § Canonical String
3
+ * Representation).
4
+ *
5
+ * - The first 10 of the 26 characters are a 48-bit Unix millisecond count in Crockford base32,
6
+ * most significant first. The other 16 are randomness: validated, never read.
7
+ * - Either case is read (the spec's "Case insensitive").
8
+ * - The first character must be `0`-`7`: `7ZZZZZZZZZZZZZZZZZZZZZZZZZ` is the largest valid ULID
9
+ * and anything larger "should be rejected" (§ Overflow Errors when Parsing Base32 Strings).
10
+ * - Strict alphabet: `I`, `L`, `O` and `U` are rejected, not read as `1`, `1` and `0` the way
11
+ * Crockford's own decoder folds them. ULID spec README § Encoding: the alphabet "excludes the
12
+ * letters I, L, O, and U to avoid confusion and abuse". A ULID never contains them, so
13
+ * reading them as `1`, `1` and `0` would turn a mistyped ID into a different instant.
14
+ * - Millisecond precision: the result never has more than three fraction digits.
15
+ * - The time is the generator's clock; ULIDs from different machines order only as well as
16
+ * their clocks agree.
17
+ * - Returns "" on invalid input.
18
+ *
19
+ * @param ulid 26-character ULID text
20
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
21
+ *
22
+ * @example fromUlid("01ARZ3NDEKTSV4RRFFQ69G5FAV") // "2016-07-30T23:54:10.259Z" — the spec README example
23
+ * @example fromUlid("01HK153X000000000000000000") // "2024-01-01T00:00:00Z"
24
+ * @example fromUlid("01hk153x000000000000000000") // "2024-01-01T00:00:00Z" — lower case
25
+ * @example fromUlid("01FWHE4YDG0000000000000000") // "2022-02-22T19:22:22Z" — same millisecond as RFC 9562 A.6
26
+ * @example fromUlid("00000000000000000000000000") // "1970-01-01T00:00:00Z"
27
+ * @example fromUlid("7ZZZZZZZZZZZZZZZZZZZZZZZZZ") // "+010889-08-02T05:31:50.655Z" — the largest valid ULID
28
+ * @example fromUlid("80000000000000000000000000") // "" — overflow
29
+ * @example fromUlid("01HK153X00000000000000000I") // "" — I is not in the alphabet
30
+ * @example fromUlid("01HK153X00000000000000000") // "" — 25 characters
31
+ * @example fromUlid(" 01HK153X000000000000000000") // "" — no trimming
32
+ */
33
+ export declare function fromUlid(ulid: string): string;
@@ -0,0 +1,44 @@
1
+ import { NANOSECONDS_PER_MILLISECOND } from "../../internal/foreignEpochs.js";
2
+ import { instantStringFromEpochNanoseconds } from "../../internal/instantStringFromEpochNanoseconds.js";
3
+ import { CROCKFORD_ALPHABET, digitsValue, ulidText } from "../../internal/identifierText.js";
4
+
5
+ // src/precision/identifiers/fromUlid.ts
6
+ /**
7
+ * Read the instant a ULID carries (ulid/spec README, § Components and § Canonical String
8
+ * Representation).
9
+ *
10
+ * - The first 10 of the 26 characters are a 48-bit Unix millisecond count in Crockford base32,
11
+ * most significant first. The other 16 are randomness: validated, never read.
12
+ * - Either case is read (the spec's "Case insensitive").
13
+ * - The first character must be `0`-`7`: `7ZZZZZZZZZZZZZZZZZZZZZZZZZ` is the largest valid ULID
14
+ * and anything larger "should be rejected" (§ Overflow Errors when Parsing Base32 Strings).
15
+ * - Strict alphabet: `I`, `L`, `O` and `U` are rejected, not read as `1`, `1` and `0` the way
16
+ * Crockford's own decoder folds them. ULID spec README § Encoding: the alphabet "excludes the
17
+ * letters I, L, O, and U to avoid confusion and abuse". A ULID never contains them, so
18
+ * reading them as `1`, `1` and `0` would turn a mistyped ID into a different instant.
19
+ * - Millisecond precision: the result never has more than three fraction digits.
20
+ * - The time is the generator's clock; ULIDs from different machines order only as well as
21
+ * their clocks agree.
22
+ * - Returns "" on invalid input.
23
+ *
24
+ * @param ulid 26-character ULID text
25
+ * @returns ISO 8601 instant string in UTC, or "" on invalid input
26
+ *
27
+ * @example fromUlid("01ARZ3NDEKTSV4RRFFQ69G5FAV") // "2016-07-30T23:54:10.259Z" — the spec README example
28
+ * @example fromUlid("01HK153X000000000000000000") // "2024-01-01T00:00:00Z"
29
+ * @example fromUlid("01hk153x000000000000000000") // "2024-01-01T00:00:00Z" — lower case
30
+ * @example fromUlid("01FWHE4YDG0000000000000000") // "2022-02-22T19:22:22Z" — same millisecond as RFC 9562 A.6
31
+ * @example fromUlid("00000000000000000000000000") // "1970-01-01T00:00:00Z"
32
+ * @example fromUlid("7ZZZZZZZZZZZZZZZZZZZZZZZZZ") // "+010889-08-02T05:31:50.655Z" — the largest valid ULID
33
+ * @example fromUlid("80000000000000000000000000") // "" — overflow
34
+ * @example fromUlid("01HK153X00000000000000000I") // "" — I is not in the alphabet
35
+ * @example fromUlid("01HK153X00000000000000000") // "" — 25 characters
36
+ * @example fromUlid(" 01HK153X000000000000000000") // "" — no trimming
37
+ */
38
+ function fromUlid(ulid) {
39
+ if (typeof ulid !== "string" || !ulidText.test(ulid)) return "";
40
+ const milliseconds = digitsValue(ulid.slice(0, 10).toUpperCase(), CROCKFORD_ALPHABET);
41
+ return instantStringFromEpochNanoseconds(milliseconds * NANOSECONDS_PER_MILLISECOND);
42
+ }
43
+
44
+ export { fromUlid };
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Read the instant a version 1, 6 or 7 UUID carries (RFC 9562 §5.1, §5.6, §5.7).
3
+ *
4
+ * - Input must be the hyphenated 8-4-4-4-12 form, in either case (RFC 9562 §4). Strip
5
+ * `urn:uuid:`, braces and whitespace first; unhyphenated hex is not read.
6
+ * - Only the RFC 9562 variant (`8`, `9`, `a`, `b` at the start of the fourth group) is read. The
7
+ * NCS, Microsoft and reserved variants have other layouts.
8
+ * - v1 and v6 count 100-nanosecond ticks from 1582-10-15 and resolve to 100 ns. A v1 and the v6
9
+ * made from it give the same instant (§5.6). The v1 timestamp fields are reassembled in
10
+ * their correct order (erratum 7955).
11
+ * - v7 counts Unix milliseconds in its first 48 bits and resolves to the millisecond. `rand_a`
12
+ * is never read: §5.7 makes a sub-millisecond fraction optional and nothing in the UUID says
13
+ * whether it is used.
14
+ * - A v1 or v6 timestamp is UTC unless its generator had no UTC clock: §5.1 (which §5.6 applies
15
+ * to v6) lets such a system use local time "as long as they do so consistently". The function
16
+ * cannot tell which.
17
+ * - v2 (DCE security), v3, v4, v5, v8, the Nil and the Max UUID carry no timestamp: `""`.
18
+ * - Returns "" on invalid input.
19
+ *
20
+ * @param uuid UUID text in the hyphenated form
21
+ * @returns the ISO 8601 instant string in UTC (100 ns for v1 and v6, milliseconds for v7), or "" when the input has no timestamp or is invalid
22
+ *
23
+ * @example fromUuidTimestamp("C232AB00-9414-11EC-B3C8-9F6BDECED846") // "2022-02-22T19:22:22Z" — RFC 9562 A.1
24
+ * @example fromUuidTimestamp("1EC9414C-232A-6B00-B3C8-9F6BDECED846") // "2022-02-22T19:22:22Z" — A.5, the same instant
25
+ * @example fromUuidTimestamp("017F22E2-79B0-7CC3-98C4-DC0C0C07398F") // "2022-02-22T19:22:22Z" — A.6
26
+ * @example fromUuidTimestamp("f81d4fae-7dec-11d0-a765-00a0c91e6bf6") // "1997-02-03T17:43:12.216875Z" — 100 ns kept
27
+ * @example fromUuidTimestamp("c232ab00-9414-11ec-b3c8-9f6bdeced846") // "2022-02-22T19:22:22Z" — lower case
28
+ * @example fromUuidTimestamp("00000000-0000-1000-8000-000000000000") // "1582-10-15T00:00:00Z" — the v1 epoch
29
+ * @example fromUuidTimestamp("ffffffff-ffff-7fff-bfff-ffffffffffff") // "+010889-08-02T05:31:50.655Z" — 48-bit maximum
30
+ * @example fromUuidTimestamp("919108f7-52d1-4320-9bac-f847db4148a8") // "" — v4 carries no timestamp
31
+ * @example fromUuidTimestamp("urn:uuid:c232ab00-9414-11ec-b3c8-9f6bdeced846") // "" — strip the prefix first
32
+ * @example fromUuidTimestamp("017f22e2-79b0-7cc3-c8c4-dc0c0c07398f") // "" — Microsoft variant
33
+ */
34
+ export declare function fromUuidTimestamp(uuid: string): string;