@northguild/gmt 1.19.0 → 1.21.0

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