@northguild/gmt 1.20.0 → 1.21.0

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