@northguild/gmt 1.21.0 → 1.22.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 (1102) hide show
  1. package/README.md +3 -3
  2. package/dist/aviation/format/formatSsimDate.d.ts +35 -0
  3. package/dist/aviation/format/formatSsimDate.js +55 -0
  4. package/dist/aviation/format/index.d.ts +2 -0
  5. package/dist/aviation/format/index.js +3 -0
  6. package/dist/aviation/index.d.ts +9 -0
  7. package/dist/aviation/index.js +10 -0
  8. package/dist/aviation/parse/index.d.ts +4 -0
  9. package/dist/aviation/parse/index.js +5 -0
  10. package/dist/aviation/parse/parseMetarTime.d.ts +33 -0
  11. package/dist/aviation/parse/parseMetarTime.js +40 -0
  12. package/dist/aviation/parse/parseNotamValidity.d.ts +39 -0
  13. package/dist/aviation/parse/parseNotamValidity.js +44 -0
  14. package/dist/aviation/parse/parseSsimDate.d.ts +35 -0
  15. package/dist/aviation/parse/parseSsimDate.js +41 -0
  16. package/dist/aviation/validate/index.d.ts +4 -0
  17. package/dist/aviation/validate/index.js +5 -0
  18. package/dist/aviation/validate/isValidMetarTime.d.ts +21 -0
  19. package/dist/aviation/validate/isValidMetarTime.js +28 -0
  20. package/dist/aviation/validate/isValidNotamValidity.d.ts +26 -0
  21. package/dist/aviation/validate/isValidNotamValidity.js +32 -0
  22. package/dist/aviation/validate/isValidSsimDate.d.ts +23 -0
  23. package/dist/aviation/validate/isValidSsimDate.js +29 -0
  24. package/dist/calendar/business/businessDaysBetween.js +7 -5
  25. package/dist/calendar/calculate/bucketRange.js +10 -7
  26. package/dist/calendar/calculate/floorToZone.d.ts +2 -5
  27. package/dist/calendar/calculate/floorToZone.js +8 -11
  28. package/dist/calendar/calculate/getFiscalPeriod.js +3 -3
  29. package/dist/calendar/calculate/getQuarter.js +3 -3
  30. package/dist/calendar/index.js +8 -8
  31. package/dist/calendar/validate/index.js +1 -1
  32. package/dist/calendar/validate/isValidFiscalCalendar.js +2 -12
  33. package/dist/calendar/validate/isValidFiscalExtraWeek.js +3 -2
  34. package/dist/calendar/validate/isValidFiscalPattern.js +3 -2
  35. package/dist/calendar/validate/isValidFiscalYearLabel.js +3 -2
  36. package/dist/calendar/validate/isValidZoneBucketUnit.js +2 -4
  37. package/dist/duration/calculate/absDuration.js +4 -4
  38. package/dist/duration/calculate/addDuration.js +6 -4
  39. package/dist/duration/calculate/durationFromUnits.js +2 -2
  40. package/dist/duration/calculate/getDurationSign.js +4 -4
  41. package/dist/duration/calculate/getDurationUnit.js +5 -5
  42. package/dist/duration/calculate/negateDuration.js +4 -4
  43. package/dist/duration/calculate/subtractDuration.js +6 -4
  44. package/dist/duration/calculate/totalDuration.d.ts +10 -11
  45. package/dist/duration/calculate/totalDuration.js +15 -16
  46. package/dist/duration/calculate/totalUnits.js +2 -2
  47. package/dist/duration/calculate/totalUnitsFromNow.js +3 -3
  48. package/dist/duration/calculate/ttlFromNow.js +2 -2
  49. package/dist/duration/compare/compareDurations.d.ts +10 -11
  50. package/dist/duration/compare/compareDurations.js +16 -14
  51. package/dist/duration/format/formatDuration.js +6 -6
  52. package/dist/duration/format/formatHumanDuration.js +2 -2
  53. package/dist/duration/index.js +1 -1
  54. package/dist/duration/normalize/normalizeDuration.d.ts +10 -11
  55. package/dist/duration/normalize/normalizeDuration.js +15 -18
  56. package/dist/duration/parse/parseDuration.js +6 -5
  57. package/dist/duration/validate/isValidDuration.js +2 -2
  58. package/dist/finance/format/formatFixUtcTimestamp.d.ts +43 -0
  59. package/dist/finance/format/formatFixUtcTimestamp.js +60 -0
  60. package/dist/finance/format/formatSwiftDate.d.ts +30 -0
  61. package/dist/finance/format/formatSwiftDate.js +46 -0
  62. package/dist/finance/format/index.d.ts +3 -0
  63. package/dist/finance/format/index.js +4 -0
  64. package/dist/finance/index.d.ts +8 -0
  65. package/dist/finance/index.js +9 -0
  66. package/dist/finance/parse/index.d.ts +3 -0
  67. package/dist/finance/parse/index.js +4 -0
  68. package/dist/finance/parse/parseFixUtcTimestamp.d.ts +50 -0
  69. package/dist/finance/parse/parseFixUtcTimestamp.js +56 -0
  70. package/dist/finance/parse/parseSwiftDate.d.ts +34 -0
  71. package/dist/finance/parse/parseSwiftDate.js +41 -0
  72. package/dist/finance/validate/index.d.ts +3 -0
  73. package/dist/finance/validate/index.js +4 -0
  74. package/dist/finance/validate/isValidFixUtcTimestamp.d.ts +26 -0
  75. package/dist/finance/validate/isValidFixUtcTimestamp.js +8 -0
  76. package/dist/finance/validate/isValidSwiftDate.d.ts +21 -0
  77. package/dist/finance/validate/isValidSwiftDate.js +28 -0
  78. package/dist/gnss/convert/gnssToUtc.d.ts +2 -2
  79. package/dist/gnss/convert/gnssToUtc.js +2 -2
  80. package/dist/gnss/convert/gnssWeekToUtc.d.ts +3 -2
  81. package/dist/gnss/convert/gnssWeekToUtc.js +3 -2
  82. package/dist/healthcare/format/formatFHIR.d.ts +54 -0
  83. package/dist/healthcare/format/formatFHIR.js +152 -0
  84. package/dist/healthcare/format/formatHL7.d.ts +62 -0
  85. package/dist/healthcare/format/formatHL7.js +187 -0
  86. package/dist/healthcare/format/index.d.ts +3 -0
  87. package/dist/healthcare/format/index.js +4 -0
  88. package/dist/healthcare/index.d.ts +11 -0
  89. package/dist/healthcare/index.js +9 -0
  90. package/dist/healthcare/parse/index.d.ts +3 -0
  91. package/dist/healthcare/parse/index.js +4 -0
  92. package/dist/healthcare/parse/parseFHIR.d.ts +37 -0
  93. package/dist/healthcare/parse/parseFHIR.js +46 -0
  94. package/dist/healthcare/parse/parseHL7.d.ts +58 -0
  95. package/dist/healthcare/parse/parseHL7.js +63 -0
  96. package/dist/healthcare/validate/index.d.ts +3 -0
  97. package/dist/healthcare/validate/index.js +4 -0
  98. package/dist/healthcare/validate/isValidFHIR.d.ts +36 -0
  99. package/dist/healthcare/validate/isValidFHIR.js +13 -0
  100. package/dist/healthcare/validate/isValidHL7.d.ts +35 -0
  101. package/dist/healthcare/validate/isValidHL7.js +42 -0
  102. package/dist/index.d.ts +61 -3
  103. package/dist/index.js +165 -119
  104. package/dist/instant/convert/classifyLocal.d.ts +2 -3
  105. package/dist/instant/convert/classifyLocal.js +7 -9
  106. package/dist/instant/convert/fromOffsetInstant.js +2 -27
  107. package/dist/instant/convert/index.js +1 -1
  108. package/dist/instant/convert/resolveLocal.d.ts +4 -4
  109. package/dist/instant/convert/resolveLocal.js +7 -24
  110. package/dist/instant/convert/toOffsetInstant.d.ts +5 -6
  111. package/dist/instant/convert/toOffsetInstant.js +7 -55
  112. package/dist/instant/index.d.ts +1 -1
  113. package/dist/instant/index.js +1 -1
  114. package/dist/intermodal/calculate/billingTimeline.js +11 -10
  115. package/dist/intermodal/calculate/chargeableDays.js +8 -6
  116. package/dist/intermodal/calculate/demurrageClock.d.ts +2 -2
  117. package/dist/intermodal/calculate/demurrageClock.js +18 -9
  118. package/dist/intermodal/calculate/freeTimeExpiry.js +5 -5
  119. package/dist/intermodal/calculate/multimodalETA.d.ts +3 -0
  120. package/dist/intermodal/calculate/multimodalETA.js +5 -2
  121. package/dist/intermodal/format/bolTimestamp.d.ts +4 -6
  122. package/dist/intermodal/format/bolTimestamp.js +8 -10
  123. package/dist/intermodal/format/formatEdifactOffsetDateTime.d.ts +3 -2
  124. package/dist/intermodal/format/formatEdifactOffsetDateTime.js +3 -2
  125. package/dist/intermodal/format/formatEpcisEvent.js +1 -1
  126. package/dist/intermodal/index.js +3 -3
  127. package/dist/intermodal/parse/classifyX12TimeCode.js +2 -11
  128. package/dist/intermodal/parse/index.js +2 -2
  129. package/dist/intermodal/parse/parseEdifactDate.js +2 -6
  130. package/dist/intermodal/parse/parseEdifactDatePeriod.js +2 -6
  131. package/dist/intermodal/parse/parseEdifactDateTime.js +2 -6
  132. package/dist/intermodal/parse/parseEdifactDateTimePeriod.js +2 -6
  133. package/dist/intermodal/parse/parseEdifactOffsetDateTime.d.ts +3 -1
  134. package/dist/intermodal/parse/parseEdifactOffsetDateTime.js +5 -7
  135. package/dist/intermodal/parse/parseEdifactTime.js +2 -6
  136. package/dist/intermodal/parse/parseX12Date.js +2 -6
  137. package/dist/intermodal/parse/parseX12DateAndTime.d.ts +3 -1
  138. package/dist/intermodal/parse/parseX12DateAndTime.js +5 -7
  139. package/dist/intermodal/parse/parseX12DateRange.js +2 -6
  140. package/dist/intermodal/parse/parseX12DateTime.js +2 -6
  141. package/dist/intermodal/parse/parseX12DateTimeRange.js +2 -6
  142. package/dist/intermodal/parse/parseX12Time.js +2 -6
  143. package/dist/intermodal/parse/x12TimeCodeOffset.js +3 -43
  144. package/dist/intermodal/parse/x12TimeCodeZone.js +3 -114
  145. package/dist/intermodal/validate/index.js +1 -1
  146. package/dist/intermodal/validate/isValidEdifactDate.d.ts +1 -1
  147. package/dist/intermodal/validate/isValidEdifactDate.js +3 -3
  148. package/dist/intermodal/validate/isValidEdifactDatePeriod.d.ts +1 -1
  149. package/dist/intermodal/validate/isValidEdifactDatePeriod.js +3 -3
  150. package/dist/intermodal/validate/isValidEdifactDateTime.d.ts +1 -1
  151. package/dist/intermodal/validate/isValidEdifactDateTime.js +3 -3
  152. package/dist/intermodal/validate/isValidEdifactDateTimePeriod.d.ts +1 -1
  153. package/dist/intermodal/validate/isValidEdifactDateTimePeriod.js +3 -3
  154. package/dist/intermodal/validate/isValidEdifactOffsetDateTime.d.ts +1 -1
  155. package/dist/intermodal/validate/isValidEdifactOffsetDateTime.js +3 -3
  156. package/dist/intermodal/validate/isValidEdifactTime.d.ts +1 -1
  157. package/dist/intermodal/validate/isValidEdifactTime.js +3 -3
  158. package/dist/intermodal/validate/isValidEpcisEvent.js +2 -3
  159. package/dist/intermodal/validate/isValidEpcisEventTime.js +2 -9
  160. package/dist/intermodal/validate/isValidEpcisTimeZoneOffset.js +2 -3
  161. package/dist/intermodal/validate/isValidX12Date.d.ts +1 -1
  162. package/dist/intermodal/validate/isValidX12Date.js +3 -3
  163. package/dist/intermodal/validate/isValidX12DateAndTime.d.ts +1 -1
  164. package/dist/intermodal/validate/isValidX12DateAndTime.js +3 -3
  165. package/dist/intermodal/validate/isValidX12DateRange.d.ts +1 -1
  166. package/dist/intermodal/validate/isValidX12DateRange.js +3 -3
  167. package/dist/intermodal/validate/isValidX12DateTime.d.ts +1 -1
  168. package/dist/intermodal/validate/isValidX12DateTime.js +3 -3
  169. package/dist/intermodal/validate/isValidX12DateTimeRange.d.ts +1 -1
  170. package/dist/intermodal/validate/isValidX12DateTimeRange.js +3 -3
  171. package/dist/intermodal/validate/isValidX12Time.d.ts +1 -1
  172. package/dist/intermodal/validate/isValidX12Time.js +3 -3
  173. package/dist/internal/adjustZonedBusinessDays.d.ts +2 -1
  174. package/dist/internal/adjustZonedBusinessDays.js +2 -4
  175. package/dist/internal/businessCalendar.d.ts +1 -1
  176. package/dist/internal/businessCalendar.js +5 -5
  177. package/dist/internal/businessDayValues.js +8 -8
  178. package/dist/internal/calendarDatePairPolicy.d.ts +1 -1
  179. package/dist/internal/calendarDateString.d.ts +25 -14
  180. package/dist/internal/calendarDateString.js +34 -19
  181. package/dist/internal/calendarZonedPairPolicy.d.ts +1 -1
  182. package/dist/internal/calendarZonedString.d.ts +23 -14
  183. package/dist/internal/calendarZonedString.js +35 -18
  184. package/dist/internal/ccsdsAsciiTime.d.ts +91 -0
  185. package/dist/internal/ccsdsAsciiTime.js +145 -0
  186. package/dist/internal/compareToToday.d.ts +10 -0
  187. package/dist/internal/compareToToday.js +23 -0
  188. package/dist/internal/copticEra.d.ts +12 -0
  189. package/dist/internal/copticEra.js +189 -0
  190. package/dist/internal/cutoffAtResolved.js +1 -1
  191. package/dist/internal/daylightTime.d.ts +3 -1
  192. package/dist/internal/daylightTime.js +3 -1
  193. package/dist/internal/deliverySchedule.d.ts +24 -0
  194. package/dist/internal/deliverySchedule.js +249 -0
  195. package/dist/internal/durationFrom.d.ts +19 -0
  196. package/dist/internal/durationFrom.js +26 -0
  197. package/dist/internal/durationUntilString.js +5 -8
  198. package/dist/internal/dutyLog.js +1 -1
  199. package/dist/internal/dutyPeriods.d.ts +1 -1
  200. package/dist/internal/dutyPeriods.js +4 -5
  201. package/dist/internal/dutyRules.js +3 -3
  202. package/dist/internal/ediDateTimeFields.d.ts +75 -2
  203. package/dist/internal/ediDateTimeFields.js +149 -6
  204. package/dist/internal/ediDateTimeWriter.d.ts +3 -3
  205. package/dist/internal/ediDateTimeWriter.js +30 -23
  206. package/dist/internal/epcisTime.d.ts +22 -0
  207. package/dist/internal/epcisTime.js +39 -0
  208. package/dist/internal/exactDuration.js +2 -2
  209. package/dist/internal/exactMoment.d.ts +25 -3
  210. package/dist/internal/exactMoment.js +46 -25
  211. package/dist/internal/fhirDateTime.d.ts +22 -0
  212. package/dist/internal/fhirDateTime.js +97 -0
  213. package/dist/internal/fixUtcTimestamp.d.ts +95 -0
  214. package/dist/internal/fixUtcTimestamp.js +180 -0
  215. package/dist/internal/formatDateInCalendar.d.ts +1 -1
  216. package/dist/internal/formatRelativeDuration.js +3 -3
  217. package/dist/internal/formatterCache.d.ts +12 -0
  218. package/dist/internal/formatterCache.js +74 -26
  219. package/dist/internal/freeTimeLedger.d.ts +2 -1
  220. package/dist/internal/freeTimeLedger.js +7 -6
  221. package/dist/internal/gnssTimeScales.d.ts +1 -1
  222. package/dist/internal/gnssWeek.js +2 -2
  223. package/dist/internal/gtfsServiceDate.d.ts +9 -0
  224. package/dist/internal/gtfsServiceDate.js +26 -0
  225. package/dist/internal/gtfsTime.d.ts +34 -0
  226. package/dist/internal/gtfsTime.js +63 -0
  227. package/dist/internal/halfOpenIntervals.d.ts +1 -1
  228. package/dist/internal/hl7DateTime.d.ts +137 -0
  229. package/dist/internal/hl7DateTime.js +293 -0
  230. package/dist/internal/holidayRules.js +2 -2
  231. package/dist/internal/httpDateFields.d.ts +13 -1
  232. package/dist/internal/httpDateFields.js +45 -1
  233. package/dist/internal/identifierText.d.ts +1 -1
  234. package/dist/internal/identifierText.js +1 -1
  235. package/dist/internal/index.d.ts +21 -5
  236. package/dist/internal/index.js +26 -10
  237. package/dist/internal/inputChecks.d.ts +87 -16
  238. package/dist/internal/inputChecks.js +134 -45
  239. package/dist/internal/instantFormatOptions.js +2 -2
  240. package/dist/internal/instantNanoseconds.d.ts +36 -57
  241. package/dist/internal/instantNanoseconds.js +47 -142
  242. package/dist/internal/instantStringFromEpochNanoseconds.d.ts +21 -1
  243. package/dist/internal/instantStringFromEpochNanoseconds.js +39 -1
  244. package/dist/internal/intervalChecks.d.ts +69 -0
  245. package/dist/internal/intervalChecks.js +128 -0
  246. package/dist/internal/intervalNanoseconds.d.ts +66 -1
  247. package/dist/internal/intervalNanoseconds.js +139 -2
  248. package/dist/internal/isObject.d.ts +16 -1
  249. package/dist/internal/isObject.js +21 -2
  250. package/dist/internal/islamicEpochEra.d.ts +24 -0
  251. package/dist/internal/islamicEpochEra.js +199 -0
  252. package/dist/internal/isoStringBody.d.ts +84 -21
  253. package/dist/internal/isoStringBody.js +146 -45
  254. package/dist/internal/japaneseNumerals.d.ts +17 -0
  255. package/dist/internal/japaneseNumerals.js +51 -0
  256. package/dist/internal/julianDate.d.ts +147 -0
  257. package/dist/internal/julianDate.js +280 -0
  258. package/dist/internal/leapSeconds.d.ts +13 -1
  259. package/dist/internal/leapSeconds.js +18 -2
  260. package/dist/internal/localResolution.js +2 -2
  261. package/dist/internal/localeMonthNames.js +2 -2
  262. package/dist/internal/localeNames.d.ts +5 -0
  263. package/dist/internal/localeNames.js +90 -0
  264. package/dist/internal/metarTime.d.ts +16 -0
  265. package/dist/internal/metarTime.js +85 -0
  266. package/dist/internal/normalizeTimeZone.d.ts +1 -1
  267. package/dist/internal/normalizeTimeZone.js +5 -5
  268. package/dist/internal/notamDateTime.d.ts +25 -0
  269. package/dist/internal/notamDateTime.js +59 -0
  270. package/dist/internal/offsetInstant.d.ts +58 -0
  271. package/dist/internal/offsetInstant.js +168 -0
  272. package/dist/internal/operatingSchedule.js +15 -14
  273. package/dist/internal/patternKey.d.ts +11 -0
  274. package/dist/internal/patternKey.js +38 -0
  275. package/dist/internal/patternToken.d.ts +7 -5
  276. package/dist/internal/patternToken.js +21 -18
  277. package/dist/internal/plainDateAdd.js +2 -2
  278. package/dist/internal/plainDateSteps.d.ts +64 -0
  279. package/dist/internal/plainDateSteps.js +134 -0
  280. package/dist/internal/plainDateUntil.js +2 -3
  281. package/dist/internal/plainFormatOptions.d.ts +2 -1
  282. package/dist/internal/plainFormatOptions.js +2 -1
  283. package/dist/internal/plainOptionEntries.d.ts +16 -0
  284. package/dist/internal/plainOptionEntries.js +33 -0
  285. package/dist/internal/protoRecord.d.ts +21 -0
  286. package/dist/internal/protoRecord.js +40 -14
  287. package/dist/internal/ptpTimestamp.d.ts +33 -0
  288. package/dist/internal/ptpTimestamp.js +48 -0
  289. package/dist/internal/rangeDetector.d.ts +31 -0
  290. package/dist/internal/rangeDetector.js +512 -0
  291. package/dist/internal/rangeFallback.d.ts +34 -0
  292. package/dist/internal/rangeFallback.js +111 -0
  293. package/dist/internal/rangeFieldValues.d.ts +39 -0
  294. package/dist/internal/rangeFieldValues.js +167 -0
  295. package/dist/internal/rangeFields.d.ts +34 -0
  296. package/dist/internal/rangeFields.js +130 -0
  297. package/dist/internal/rangeHooks.d.ts +53 -0
  298. package/dist/internal/rangeHooks.js +26 -0
  299. package/dist/internal/rangeRepairs.d.ts +4 -0
  300. package/dist/internal/rangeRepairs.js +16 -0
  301. package/dist/internal/readDateTimeFormatOptions.d.ts +7 -9
  302. package/dist/internal/readDateTimeFormatOptions.js +19 -24
  303. package/dist/internal/readSetFields.d.ts +47 -0
  304. package/dist/internal/readSetFields.js +58 -1
  305. package/dist/internal/repairRangeText.d.ts +26 -0
  306. package/dist/internal/repairRangeText.js +69 -0
  307. package/dist/internal/resolveDateTimeUnit.js +3 -3
  308. package/dist/internal/resolveDurationRelativeTo.d.ts +20 -11
  309. package/dist/internal/resolveDurationRelativeTo.js +21 -20
  310. package/dist/internal/resolveDurationUnit.d.ts +35 -1
  311. package/dist/internal/resolveDurationUnit.js +49 -4
  312. package/dist/internal/resolveLocalInstant.d.ts +14 -0
  313. package/dist/internal/resolveLocalInstant.js +40 -0
  314. package/dist/internal/resolveLocale.d.ts +26 -1
  315. package/dist/internal/resolveLocale.js +44 -3
  316. package/dist/internal/resolveOverflow.d.ts +1 -0
  317. package/dist/internal/resolveOverflow.js +2 -0
  318. package/dist/internal/resolveUnixIntervalPair.js +2 -2
  319. package/dist/internal/rfc3339DateTime.d.ts +11 -0
  320. package/dist/internal/rfc3339DateTime.js +29 -0
  321. package/dist/internal/rfc5322DateTime.d.ts +12 -1
  322. package/dist/internal/rfc5322DateTime.js +31 -1
  323. package/dist/internal/setZonedFields.d.ts +24 -0
  324. package/dist/internal/setZonedFields.js +26 -0
  325. package/dist/internal/ssimDate.d.ts +25 -0
  326. package/dist/internal/ssimDate.js +70 -0
  327. package/dist/internal/startOrEndOfUnix.js +1 -1
  328. package/dist/internal/startOrEndOfUtc.js +7 -6
  329. package/dist/internal/startOrEndOfZoned.js +7 -7
  330. package/dist/internal/swiftDate.d.ts +28 -0
  331. package/dist/internal/swiftDate.js +60 -0
  332. package/dist/internal/tai64Label.d.ts +28 -0
  333. package/dist/internal/tai64Label.js +63 -0
  334. package/dist/internal/temporalCompat/capabilities.d.ts +90 -10
  335. package/dist/internal/temporalCompat/capabilities.js +202 -12
  336. package/dist/internal/temporalCompat/fieldSearch.js +1 -1
  337. package/dist/internal/temporalCompat/index.d.ts +2 -3
  338. package/dist/internal/temporalCompat/index.js +3 -4
  339. package/dist/internal/temporalCompat/islamicEra.js +13 -6
  340. package/dist/internal/temporalCompat/probeRepros.d.ts +1 -2
  341. package/dist/internal/temporalCompat/probeRepros.js +115 -117
  342. package/dist/internal/temporalCompat/rangeFieldRepros.d.ts +50 -0
  343. package/dist/internal/temporalCompat/rangeFieldRepros.js +427 -0
  344. package/dist/internal/temporalCompat/repros.d.ts +18 -2
  345. package/dist/internal/temporalCompat/repros.js +325 -1
  346. package/dist/internal/terrestrialTime.d.ts +54 -0
  347. package/dist/internal/terrestrialTime.js +67 -0
  348. package/dist/internal/timeScaleString.d.ts +4 -4
  349. package/dist/internal/timeScaleString.js +2 -2
  350. package/dist/internal/timestampEvents.d.ts +3 -4
  351. package/dist/internal/timestampEvents.js +4 -5
  352. package/dist/internal/todayDate.d.ts +9 -0
  353. package/dist/internal/todayDate.js +22 -0
  354. package/dist/internal/typedOptions.d.ts +160 -0
  355. package/dist/internal/typedOptions.js +231 -0
  356. package/dist/internal/unitNames.d.ts +159 -0
  357. package/dist/internal/unitNames.js +227 -0
  358. package/dist/internal/unixFormatReference.js +2 -8
  359. package/dist/internal/unixWallClock.d.ts +18 -1
  360. package/dist/internal/unixWallClock.js +44 -1
  361. package/dist/internal/utcInstant.d.ts +16 -0
  362. package/dist/internal/utcInstant.js +30 -0
  363. package/dist/internal/utcReading.d.ts +2 -0
  364. package/dist/internal/utcReading.js +7 -6
  365. package/dist/internal/utcWallClock.js +4 -4
  366. package/dist/internal/weekNumber.d.ts +20 -0
  367. package/dist/internal/weekNumber.js +33 -0
  368. package/dist/internal/weekYearGuard.d.ts +15 -0
  369. package/dist/internal/weekYearGuard.js +201 -0
  370. package/dist/internal/weekYearRange.d.ts +47 -0
  371. package/dist/internal/weekYearRange.js +901 -0
  372. package/dist/internal/weekYearSynth.d.ts +13 -0
  373. package/dist/internal/weekYearSynth.js +352 -0
  374. package/dist/internal/weekYearText.d.ts +120 -0
  375. package/dist/internal/weekYearText.js +293 -0
  376. package/dist/internal/x12TimeCodes.d.ts +31 -0
  377. package/dist/internal/x12TimeCodes.js +198 -0
  378. package/dist/internal/yearPrinting.d.ts +29 -0
  379. package/dist/internal/yearPrinting.js +239 -0
  380. package/dist/internal/yearPrintingRange.d.ts +13 -0
  381. package/dist/internal/yearPrintingRange.js +198 -0
  382. package/dist/internal/yearWindowStart.d.ts +29 -1
  383. package/dist/internal/yearWindowStart.js +33 -2
  384. package/dist/internal/zoneFrame.js +5 -5
  385. package/dist/internal/zonedBucket.js +1 -1
  386. package/dist/internal/zonedDifference/calendarArithmetic.d.ts +3 -4
  387. package/dist/internal/zonedDifference/calendarArithmetic.js +3 -2
  388. package/dist/internal/zonedDifference/nudgeWindow.d.ts +2 -3
  389. package/dist/internal/zonedDifference/nudgeWindow.js +1 -1
  390. package/dist/internal/zonedDifference/operations.d.ts +2 -3
  391. package/dist/internal/zonedFormatReference.js +3 -3
  392. package/dist/internal/zonedWallClock.d.ts +26 -0
  393. package/dist/internal/zonedWallClock.js +50 -6
  394. package/dist/internal/zonedWallClockDifference.d.ts +3 -4
  395. package/dist/internal/zonedWallClockDifference.js +3 -4
  396. package/dist/internal/zonedWallClockOperations.js +7 -6
  397. package/dist/internal/zonelessCalendarDate.d.ts +1 -1
  398. package/dist/internal/zonelessCalendarDate.js +3 -3
  399. package/dist/interval/calculate/clampInterval.js +2 -2
  400. package/dist/interval/calculate/index.js +1 -1
  401. package/dist/interval/calculate/intersectIntervals.js +2 -13
  402. package/dist/interval/calculate/mergeIntervals.js +2 -11
  403. package/dist/interval/calculate/subtractIntervals.js +2 -26
  404. package/dist/interval/compare/intervalContains.d.ts +3 -4
  405. package/dist/interval/compare/intervalContains.js +5 -14
  406. package/dist/interval/compare/intervalsOverlap.js +2 -9
  407. package/dist/interval/index.js +1 -1
  408. package/dist/interval/validate/isValidInterval.d.ts +4 -8
  409. package/dist/interval/validate/isValidInterval.js +4 -8
  410. package/dist/iot/convert/index.d.ts +3 -0
  411. package/dist/iot/convert/index.js +4 -0
  412. package/dist/iot/convert/ptpToUtc.d.ts +42 -0
  413. package/dist/iot/convert/ptpToUtc.js +51 -0
  414. package/dist/iot/convert/utcToPtp.d.ts +31 -0
  415. package/dist/iot/convert/utcToPtp.js +47 -0
  416. package/dist/iot/index.d.ts +5 -0
  417. package/dist/iot/index.js +6 -0
  418. package/dist/iot/validate/index.d.ts +2 -0
  419. package/dist/iot/validate/index.js +3 -0
  420. package/dist/iot/validate/isValidPtpTimestamp.d.ts +33 -0
  421. package/dist/iot/validate/isValidPtpTimestamp.js +36 -0
  422. package/dist/plain/calculate/addDate.js +6 -8
  423. package/dist/plain/calculate/addDateTime.js +6 -7
  424. package/dist/plain/calculate/addTime.js +6 -7
  425. package/dist/plain/calculate/clampDate.js +5 -5
  426. package/dist/plain/calculate/closestDateTo.js +12 -8
  427. package/dist/plain/calculate/cycleDate.js +10 -9
  428. package/dist/plain/calculate/cycleDateTime.js +11 -11
  429. package/dist/plain/calculate/cycleTime.js +9 -9
  430. package/dist/plain/calculate/diffDate.js +7 -8
  431. package/dist/plain/calculate/diffDateAsDuration.js +5 -5
  432. package/dist/plain/calculate/diffDateTime.js +10 -14
  433. package/dist/plain/calculate/diffDateTimeAsDuration.js +6 -8
  434. package/dist/plain/calculate/diffTime.js +10 -13
  435. package/dist/plain/calculate/endOfDate.js +3 -4
  436. package/dist/plain/calculate/endOfDateTime.js +5 -5
  437. package/dist/plain/calculate/endOfQuarterForDate.js +3 -4
  438. package/dist/plain/calculate/endOfQuarterForDateTime.js +3 -4
  439. package/dist/plain/calculate/endOfTime.js +5 -5
  440. package/dist/plain/calculate/getDayOfYear.js +4 -4
  441. package/dist/plain/calculate/getDaysInMonth.js +4 -4
  442. package/dist/plain/calculate/getDaysInYear.js +4 -4
  443. package/dist/plain/calculate/getLargestDateDurationUnit.js +2 -16
  444. package/dist/plain/calculate/getLargestDateTimeDurationUnit.js +2 -22
  445. package/dist/plain/calculate/getLargestTimeDurationUnit.js +2 -18
  446. package/dist/plain/calculate/getLocaleDayOfWeek.js +4 -4
  447. package/dist/plain/calculate/getLocaleEndOfWeek.js +3 -4
  448. package/dist/plain/calculate/getLocaleStartOfWeek.js +5 -6
  449. package/dist/plain/calculate/getLocaleWeekYear.js +3 -4
  450. package/dist/plain/calculate/getQuarterForDate.js +3 -4
  451. package/dist/plain/calculate/getQuarterForDateTime.js +3 -4
  452. package/dist/plain/calculate/getWeekNumber.js +5 -13
  453. package/dist/plain/calculate/getWeekOfMonth.js +3 -4
  454. package/dist/plain/calculate/getWeekYear.js +4 -4
  455. package/dist/plain/calculate/getWeeksInLocaleWeekYear.js +3 -4
  456. package/dist/plain/calculate/getWeeksInMonth.js +3 -4
  457. package/dist/plain/calculate/getWeeksInYear.js +4 -4
  458. package/dist/plain/calculate/index.js +6 -6
  459. package/dist/plain/calculate/maxDate.js +8 -5
  460. package/dist/plain/calculate/maxDateTime.js +8 -5
  461. package/dist/plain/calculate/maxTime.js +8 -5
  462. package/dist/plain/calculate/minDate.js +8 -5
  463. package/dist/plain/calculate/minDateTime.js +8 -5
  464. package/dist/plain/calculate/minTime.js +8 -5
  465. package/dist/plain/calculate/nextWeekday.js +6 -6
  466. package/dist/plain/calculate/previousWeekday.js +6 -6
  467. package/dist/plain/calculate/roundDate.js +8 -8
  468. package/dist/plain/calculate/roundDateTime.js +8 -8
  469. package/dist/plain/calculate/roundTime.js +9 -8
  470. package/dist/plain/calculate/setDate.js +5 -9
  471. package/dist/plain/calculate/setDateTime.js +5 -9
  472. package/dist/plain/calculate/setTime.js +5 -9
  473. package/dist/plain/calculate/sortDateTimes.js +7 -3
  474. package/dist/plain/calculate/sortDates.js +7 -3
  475. package/dist/plain/calculate/sortTimes.js +7 -3
  476. package/dist/plain/calculate/startOfDate.js +6 -26
  477. package/dist/plain/calculate/startOfDateTime.js +9 -63
  478. package/dist/plain/calculate/startOfQuarterForDate.js +3 -4
  479. package/dist/plain/calculate/startOfQuarterForDateTime.js +3 -4
  480. package/dist/plain/calculate/startOfTime.js +5 -4
  481. package/dist/plain/calculate/subtractDate.js +6 -8
  482. package/dist/plain/calculate/subtractDateTime.js +6 -7
  483. package/dist/plain/calculate/subtractTime.js +6 -7
  484. package/dist/plain/calculate/weekOfYearForDate.js +4 -4
  485. package/dist/plain/calculate/weekOfYearForDateTime.js +3 -3
  486. package/dist/plain/chop/chopDate.js +4 -4
  487. package/dist/plain/chop/chopMilliseconds.js +5 -5
  488. package/dist/plain/chop/chopSeconds.js +5 -5
  489. package/dist/plain/chop/chopTime.js +4 -4
  490. package/dist/plain/compare/areDateTimesEqual.js +4 -5
  491. package/dist/plain/compare/areDateTimesEqualBy.js +7 -8
  492. package/dist/plain/compare/areDatesEqual.js +2 -10
  493. package/dist/plain/compare/areDatesEqualBy.js +7 -8
  494. package/dist/plain/compare/areTimesEqual.js +4 -5
  495. package/dist/plain/compare/isAfterDate.js +5 -3
  496. package/dist/plain/compare/isAfterDateTime.js +5 -3
  497. package/dist/plain/compare/isAfterTime.js +5 -3
  498. package/dist/plain/compare/isBeforeDate.js +5 -3
  499. package/dist/plain/compare/isBeforeDateTime.js +5 -3
  500. package/dist/plain/compare/isBeforeTime.js +5 -3
  501. package/dist/plain/compare/isBetweenDate.js +8 -8
  502. package/dist/plain/compare/isBetweenDateTime.js +8 -8
  503. package/dist/plain/compare/isBetweenTime.js +8 -8
  504. package/dist/plain/compare/isBusinessDay.js +4 -4
  505. package/dist/plain/compare/isFuture.d.ts +1 -1
  506. package/dist/plain/compare/isFuture.js +3 -8
  507. package/dist/plain/compare/isPast.d.ts +1 -1
  508. package/dist/plain/compare/isPast.js +3 -8
  509. package/dist/plain/compare/isRelativeDay.d.ts +1 -1
  510. package/dist/plain/compare/isRelativeDay.js +12 -11
  511. package/dist/plain/compare/isThisUnit.d.ts +1 -1
  512. package/dist/plain/compare/isThisUnit.js +14 -12
  513. package/dist/plain/compare/isWeekend.js +3 -4
  514. package/dist/plain/convert/convertDateToCalendar.js +4 -4
  515. package/dist/plain/format/formatCalendar.js +10 -10
  516. package/dist/plain/format/formatDate.js +4 -4
  517. package/dist/plain/format/formatDateRange.js +7 -5
  518. package/dist/plain/format/formatDateTime.js +4 -4
  519. package/dist/plain/format/formatDateTimeRange.js +8 -5
  520. package/dist/plain/format/formatDateTimeToParts.js +4 -4
  521. package/dist/plain/format/formatDateToParts.js +4 -4
  522. package/dist/plain/format/formatRelativeDate.js +8 -8
  523. package/dist/plain/format/formatRelativeDateTime.js +8 -8
  524. package/dist/plain/format/formatRelativeTime.js +8 -8
  525. package/dist/plain/format/formatSqlDateTime.js +3 -4
  526. package/dist/plain/format/formatTime.js +4 -3
  527. package/dist/plain/get/getDateAgo.js +4 -4
  528. package/dist/plain/get/getDateIn.js +4 -4
  529. package/dist/plain/get/getDateTimeAgo.js +4 -4
  530. package/dist/plain/get/getDateTimeIn.js +4 -4
  531. package/dist/plain/get/getDay.js +2 -2
  532. package/dist/plain/get/getDayOfWeek.js +2 -2
  533. package/dist/plain/get/getHour.js +2 -2
  534. package/dist/plain/get/getMicrosecond.js +2 -2
  535. package/dist/plain/get/getMillisecond.js +2 -2
  536. package/dist/plain/get/getMinute.js +2 -2
  537. package/dist/plain/get/getMonth.js +2 -2
  538. package/dist/plain/get/getNanosecond.js +2 -2
  539. package/dist/plain/get/getNow.js +2 -2
  540. package/dist/plain/get/getNowUnit.js +6 -6
  541. package/dist/plain/get/getSecond.js +2 -2
  542. package/dist/plain/get/getTimeAgo.js +4 -4
  543. package/dist/plain/get/getTimeIn.js +4 -4
  544. package/dist/plain/get/getToday.js +2 -9
  545. package/dist/plain/get/getWeekOfYear.js +2 -2
  546. package/dist/plain/get/getYear.js +2 -2
  547. package/dist/plain/get/index.js +1 -1
  548. package/dist/plain/index.js +73 -73
  549. package/dist/plain/interval/index.js +3 -3
  550. package/dist/plain/interval/intervalAbutsDate.js +6 -7
  551. package/dist/plain/interval/intervalAbutsDateTime.js +6 -6
  552. package/dist/plain/interval/intervalAbutsTime.js +6 -6
  553. package/dist/plain/interval/intervalContainsDate.js +7 -8
  554. package/dist/plain/interval/intervalContainsDateTime.js +7 -7
  555. package/dist/plain/interval/intervalContainsTime.js +7 -7
  556. package/dist/plain/interval/intervalCountDate.js +5 -5
  557. package/dist/plain/interval/intervalCountDateTime.js +8 -9
  558. package/dist/plain/interval/intervalCountTime.js +6 -6
  559. package/dist/plain/interval/intervalDifferenceDate.js +6 -7
  560. package/dist/plain/interval/intervalDifferenceDateTime.js +6 -6
  561. package/dist/plain/interval/intervalDifferenceTime.js +6 -6
  562. package/dist/plain/interval/intervalDivideEquallyDate.js +4 -5
  563. package/dist/plain/interval/intervalDivideEquallyDateTime.js +4 -5
  564. package/dist/plain/interval/intervalDivideEquallyTime.js +4 -5
  565. package/dist/plain/interval/intervalEngulfsDate.js +6 -7
  566. package/dist/plain/interval/intervalEngulfsDateTime.js +6 -6
  567. package/dist/plain/interval/intervalEngulfsTime.js +6 -6
  568. package/dist/plain/interval/intervalFromDurationDate.js +7 -8
  569. package/dist/plain/interval/intervalFromDurationDateTime.js +5 -6
  570. package/dist/plain/interval/intervalFromDurationTime.js +5 -7
  571. package/dist/plain/interval/intervalIntersectionDate.js +6 -7
  572. package/dist/plain/interval/intervalIntersectionDateTime.js +6 -6
  573. package/dist/plain/interval/intervalIntersectionTime.js +6 -6
  574. package/dist/plain/interval/intervalLengthDate.js +5 -5
  575. package/dist/plain/interval/intervalLengthDateTime.js +6 -7
  576. package/dist/plain/interval/intervalLengthTime.js +6 -7
  577. package/dist/plain/interval/intervalOverlappingDaysDate.js +6 -7
  578. package/dist/plain/interval/intervalOverlappingDaysDateTime.js +6 -6
  579. package/dist/plain/interval/intervalSplitAtDate.js +14 -8
  580. package/dist/plain/interval/intervalSplitAtDateTime.js +14 -7
  581. package/dist/plain/interval/intervalSplitAtTime.js +14 -7
  582. package/dist/plain/interval/intervalUnionDate.js +6 -7
  583. package/dist/plain/interval/intervalUnionDateTime.js +6 -6
  584. package/dist/plain/interval/intervalUnionTime.js +6 -6
  585. package/dist/plain/interval/intervalXorAllDate.js +13 -8
  586. package/dist/plain/interval/intervalXorAllDateTime.js +12 -6
  587. package/dist/plain/interval/intervalXorAllTime.js +12 -6
  588. package/dist/plain/interval/intervalXorDate.js +6 -7
  589. package/dist/plain/interval/intervalXorDateTime.js +6 -6
  590. package/dist/plain/interval/intervalXorTime.js +6 -6
  591. package/dist/plain/interval/intervalsOverlapDate.js +6 -7
  592. package/dist/plain/interval/intervalsOverlapDateTime.js +6 -6
  593. package/dist/plain/interval/intervalsOverlapTime.js +6 -6
  594. package/dist/plain/interval/mergeIntervalsDate.js +11 -8
  595. package/dist/plain/interval/mergeIntervalsDateTime.js +10 -6
  596. package/dist/plain/interval/mergeIntervalsTime.js +10 -6
  597. package/dist/plain/interval/splitIntervalByUnitDate.js +4 -4
  598. package/dist/plain/interval/splitIntervalByUnitDateTime.js +6 -6
  599. package/dist/plain/interval/splitIntervalByUnitTime.js +6 -6
  600. package/dist/plain/interval/validate/isValidDateInterval.js +2 -10
  601. package/dist/plain/interval/validate/isValidDateTimeInterval.d.ts +4 -5
  602. package/dist/plain/interval/validate/isValidDateTimeInterval.js +6 -14
  603. package/dist/plain/interval/validate/isValidTimeInterval.d.ts +4 -5
  604. package/dist/plain/interval/validate/isValidTimeInterval.js +6 -14
  605. package/dist/plain/locale/getLocaleEraNames.js +2 -35
  606. package/dist/plain/locale/getLocaleMeridiems.js +2 -18
  607. package/dist/plain/locale/getLocaleMonthNames.js +2 -24
  608. package/dist/plain/locale/getLocaleWeekdayNames.js +2 -26
  609. package/dist/plain/map/mapDatesInRange.js +4 -4
  610. package/dist/plain/parse/parseDayFromDate.js +4 -4
  611. package/dist/plain/parse/parseDayFromDateTime.js +4 -4
  612. package/dist/plain/parse/parseDayOfWeekFromDate.js +4 -4
  613. package/dist/plain/parse/parseDayOfWeekFromDateTime.js +4 -4
  614. package/dist/plain/parse/parseHourFromDateTime.js +4 -4
  615. package/dist/plain/parse/parseHourFromTime.js +4 -4
  616. package/dist/plain/parse/parseMicrosecondFromDateTime.js +4 -4
  617. package/dist/plain/parse/parseMicrosecondFromTime.js +4 -4
  618. package/dist/plain/parse/parseMillisecondFromDateTime.js +4 -4
  619. package/dist/plain/parse/parseMillisecondFromTime.js +4 -4
  620. package/dist/plain/parse/parseMinuteFromDateTime.js +4 -4
  621. package/dist/plain/parse/parseMinuteFromTime.js +4 -4
  622. package/dist/plain/parse/parseMonthDay.d.ts +2 -3
  623. package/dist/plain/parse/parseMonthDay.js +2 -3
  624. package/dist/plain/parse/parseMonthDayFromDate.js +4 -4
  625. package/dist/plain/parse/parseMonthDayFromDateTime.d.ts +3 -3
  626. package/dist/plain/parse/parseMonthDayFromDateTime.js +3 -3
  627. package/dist/plain/parse/parseMonthFromDate.js +4 -4
  628. package/dist/plain/parse/parseMonthFromDateTime.js +4 -4
  629. package/dist/plain/parse/parseNanosecondFromDateTime.js +4 -4
  630. package/dist/plain/parse/parseNanosecondFromTime.js +4 -4
  631. package/dist/plain/parse/parseSecondFromDateTime.js +4 -4
  632. package/dist/plain/parse/parseSecondFromTime.js +4 -4
  633. package/dist/plain/parse/parseUnitFromDate.js +5 -6
  634. package/dist/plain/parse/parseUnitFromDateTime.js +5 -6
  635. package/dist/plain/parse/parseUnitFromTime.js +3 -4
  636. package/dist/plain/parse/parseWeekFromDate.js +5 -4
  637. package/dist/plain/parse/parseWeekFromDateTime.js +5 -5
  638. package/dist/plain/parse/parseYearFromDate.js +3 -4
  639. package/dist/plain/parse/parseYearFromDateTime.js +3 -4
  640. package/dist/plain/parse/parseYearMonth.d.ts +2 -3
  641. package/dist/plain/parse/parseYearMonth.js +2 -3
  642. package/dist/plain/parse/parseYearMonthFromDate.js +4 -4
  643. package/dist/plain/parse/parseYearMonthFromDateTime.d.ts +3 -2
  644. package/dist/plain/parse/parseYearMonthFromDateTime.js +3 -2
  645. package/dist/plain/validate/hasSecond60.d.ts +29 -24
  646. package/dist/plain/validate/hasSecond60.js +41 -27
  647. package/dist/plain/validate/index.js +5 -5
  648. package/dist/plain/validate/isLeapYear.js +4 -4
  649. package/dist/plain/validate/isValidCalendarDate.d.ts +5 -7
  650. package/dist/plain/validate/isValidCalendarDate.js +2 -8
  651. package/dist/plain/validate/isValidDate.d.ts +6 -7
  652. package/dist/plain/validate/isValidDate.js +2 -2
  653. package/dist/plain/validate/isValidDateCycleField.js +3 -2
  654. package/dist/plain/validate/isValidDateDurationUnit.js +3 -1
  655. package/dist/plain/validate/isValidDateRange.d.ts +2 -2
  656. package/dist/plain/validate/isValidDateRange.js +8 -8
  657. package/dist/plain/validate/isValidDateTime.d.ts +6 -7
  658. package/dist/plain/validate/isValidDateTime.js +1 -1
  659. package/dist/plain/validate/isValidDateTimeCycleField.js +2 -3
  660. package/dist/plain/validate/isValidDateTimeDurationUnit.js +3 -1
  661. package/dist/plain/validate/isValidDateTimeRange.js +6 -5
  662. package/dist/plain/validate/isValidDateTimeUnit.js +3 -2
  663. package/dist/plain/validate/isValidDateUnit.js +3 -2
  664. package/dist/plain/validate/isValidIsoDateLike.d.ts +5 -6
  665. package/dist/plain/validate/isValidIsoDateLike.js +2 -19
  666. package/dist/plain/validate/isValidMonthDay.d.ts +5 -8
  667. package/dist/plain/validate/isValidTime.d.ts +5 -6
  668. package/dist/plain/validate/isValidTime.js +2 -2
  669. package/dist/plain/validate/isValidTimeCycleField.js +3 -2
  670. package/dist/plain/validate/isValidTimeDurationUnit.js +3 -1
  671. package/dist/plain/validate/isValidTimeRange.js +6 -5
  672. package/dist/plain/validate/isValidTimeUnit.js +3 -2
  673. package/dist/plain/validate/isValidYearMonth.d.ts +5 -8
  674. package/dist/precision/calculate/truncateNanoseconds.js +2 -9
  675. package/dist/precision/convert/fromDotNetTicks.js +2 -2
  676. package/dist/precision/convert/fromExcelSerial.js +4 -4
  677. package/dist/precision/convert/fromFileTime.js +2 -2
  678. package/dist/precision/convert/fromNanoseconds.js +2 -11
  679. package/dist/precision/convert/fromNtpTimestamp.js +2 -2
  680. package/dist/precision/convert/fromPgMicroseconds.js +2 -2
  681. package/dist/precision/convert/index.js +1 -1
  682. package/dist/precision/convert/toArrowLocalTimestamp.d.ts +2 -3
  683. package/dist/precision/convert/toArrowLocalTimestamp.js +2 -3
  684. package/dist/precision/convert/toArrowTimestamp.d.ts +5 -4
  685. package/dist/precision/convert/toArrowTimestamp.js +5 -4
  686. package/dist/precision/convert/toExcelSerial.js +2 -2
  687. package/dist/precision/convert/toNanoseconds.d.ts +8 -14
  688. package/dist/precision/convert/toNanoseconds.js +8 -14
  689. package/dist/precision/convert/toParquetInt96.d.ts +1 -1
  690. package/dist/precision/convert/toParquetInt96.js +1 -1
  691. package/dist/precision/convert/toPgMicroseconds.js +2 -2
  692. package/dist/precision/convert/toProtoTimestamp.d.ts +1 -1
  693. package/dist/precision/convert/toProtoTimestamp.js +1 -1
  694. package/dist/precision/identifiers/ulidTimestampPrefix.d.ts +4 -3
  695. package/dist/precision/identifiers/ulidTimestampPrefix.js +4 -3
  696. package/dist/precision/identifiers/uuidV7TimestampPrefix.d.ts +4 -3
  697. package/dist/precision/identifiers/uuidV7TimestampPrefix.js +4 -3
  698. package/dist/precision/index.js +6 -6
  699. package/dist/precision/parse/parseNanoseconds.js +2 -2
  700. package/dist/precision/validate/isValidInstant.d.ts +9 -20
  701. package/dist/precision/validate/isValidInstant.js +2 -2
  702. package/dist/precision/validate/isValidInt64NanosecondDateTime.d.ts +1 -1
  703. package/dist/precision/validate/isValidNanoPattern.js +2 -5
  704. package/dist/rail/convert/gtfsToInstant.d.ts +46 -0
  705. package/dist/rail/convert/gtfsToInstant.js +69 -0
  706. package/dist/rail/convert/index.d.ts +2 -0
  707. package/dist/rail/convert/index.js +3 -0
  708. package/dist/rail/format/formatGtfsTime.d.ts +25 -0
  709. package/dist/rail/format/formatGtfsTime.js +37 -0
  710. package/dist/rail/format/index.d.ts +2 -0
  711. package/dist/rail/format/index.js +3 -0
  712. package/dist/rail/index.d.ts +8 -0
  713. package/dist/rail/index.js +7 -0
  714. package/dist/rail/parse/index.d.ts +2 -0
  715. package/dist/rail/parse/index.js +3 -0
  716. package/dist/rail/parse/parseGtfsTime.d.ts +27 -0
  717. package/dist/rail/parse/parseGtfsTime.js +32 -0
  718. package/dist/rail/validate/index.d.ts +2 -0
  719. package/dist/rail/validate/index.js +3 -0
  720. package/dist/rail/validate/isValidGtfsTime.d.ts +21 -0
  721. package/dist/rail/validate/isValidGtfsTime.js +28 -0
  722. package/dist/recurrence/calculate/cronRuns.js +1 -1
  723. package/dist/recurrence/calculate/expandRecurrence.js +3 -3
  724. package/dist/recurrence/parse/parseRecurrenceRule.d.ts +1 -1
  725. package/dist/recurrence/parse/parseRecurrenceRule.js +1 -1
  726. package/dist/regex/calendar-date.d.ts +2 -2
  727. package/dist/regex/calendar-date.js +2 -2
  728. package/dist/regex/calendar-zoned-date-time.d.ts +2 -3
  729. package/dist/regex/calendar-zoned-date-time.js +2 -3
  730. package/dist/regex/date-time.d.ts +3 -3
  731. package/dist/regex/date-time.js +3 -3
  732. package/dist/regex/date.d.ts +3 -3
  733. package/dist/regex/date.js +3 -3
  734. package/dist/regex/fhir.d.ts +74 -0
  735. package/dist/regex/fhir.js +77 -0
  736. package/dist/regex/index.d.ts +2 -1
  737. package/dist/regex/index.js +4 -3
  738. package/dist/regex/leap-second.d.ts +3 -2
  739. package/dist/regex/leap-second.js +3 -2
  740. package/dist/regex/month-day.d.ts +3 -2
  741. package/dist/regex/month-day.js +3 -2
  742. package/dist/regex/time.d.ts +3 -3
  743. package/dist/regex/time.js +3 -3
  744. package/dist/regex/utc-date-time.d.ts +3 -3
  745. package/dist/regex/utc-date-time.js +3 -3
  746. package/dist/regex/year-month.d.ts +3 -2
  747. package/dist/regex/year-month.js +3 -2
  748. package/dist/span/calculate/index.js +1 -1
  749. package/dist/span/calculate/spanMs.d.ts +8 -17
  750. package/dist/span/calculate/spanMs.js +10 -19
  751. package/dist/span/calculate/spanNs.d.ts +8 -17
  752. package/dist/span/calculate/spanNs.js +10 -22
  753. package/dist/span/calculate/spanSeconds.d.ts +2 -2
  754. package/dist/span/calculate/spanSeconds.js +4 -4
  755. package/dist/span/calculate/spanWallClock.js +4 -2
  756. package/dist/span/index.js +1 -1
  757. package/dist/span/validate/isValidSpan.d.ts +4 -13
  758. package/dist/span/validate/isValidSpan.js +4 -13
  759. package/dist/timescale/calculate/index.d.ts +2 -1
  760. package/dist/timescale/calculate/index.js +2 -1
  761. package/dist/timescale/calculate/leapSecondsBetween.js +1 -1
  762. package/dist/timescale/calculate/nextLeapSecond.js +1 -1
  763. package/dist/timescale/calculate/taiMinusUtc.js +1 -1
  764. package/dist/timescale/calculate/tcgMinusTt.d.ts +21 -0
  765. package/dist/timescale/calculate/tcgMinusTt.js +38 -0
  766. package/dist/timescale/convert/fromJ2000Seconds.d.ts +29 -0
  767. package/dist/timescale/convert/fromJ2000Seconds.js +46 -0
  768. package/dist/timescale/convert/fromJulianDate.d.ts +28 -0
  769. package/dist/timescale/convert/fromJulianDate.js +45 -0
  770. package/dist/timescale/convert/fromJulianDateParts.d.ts +35 -0
  771. package/dist/timescale/convert/fromJulianDateParts.js +61 -0
  772. package/dist/timescale/convert/fromModifiedJulianDate.d.ts +30 -0
  773. package/dist/timescale/convert/fromModifiedJulianDate.js +47 -0
  774. package/dist/timescale/convert/fromTAI.d.ts +3 -2
  775. package/dist/timescale/convert/fromTAI.js +5 -4
  776. package/dist/timescale/convert/fromTCG.d.ts +26 -0
  777. package/dist/timescale/convert/fromTCG.js +43 -0
  778. package/dist/timescale/convert/fromTT.d.ts +24 -0
  779. package/dist/timescale/convert/fromTT.js +41 -0
  780. package/dist/timescale/convert/fromTai64n.d.ts +36 -0
  781. package/dist/timescale/convert/fromTai64n.js +52 -0
  782. package/dist/timescale/convert/index.d.ts +15 -1
  783. package/dist/timescale/convert/index.js +15 -1
  784. package/dist/timescale/convert/toJ2000Seconds.d.ts +37 -0
  785. package/dist/timescale/convert/toJ2000Seconds.js +58 -0
  786. package/dist/timescale/convert/toJulianDate.d.ts +31 -0
  787. package/dist/timescale/convert/toJulianDate.js +50 -0
  788. package/dist/timescale/convert/toJulianDateParts.d.ts +32 -0
  789. package/dist/timescale/convert/toJulianDateParts.js +49 -0
  790. package/dist/timescale/convert/toModifiedJulianDate.d.ts +36 -0
  791. package/dist/timescale/convert/toModifiedJulianDate.js +55 -0
  792. package/dist/timescale/convert/toTAI.d.ts +1 -1
  793. package/dist/timescale/convert/toTAI.js +2 -2
  794. package/dist/timescale/convert/toTCG.d.ts +27 -0
  795. package/dist/timescale/convert/toTCG.js +48 -0
  796. package/dist/timescale/convert/toTT.d.ts +25 -0
  797. package/dist/timescale/convert/toTT.js +46 -0
  798. package/dist/timescale/convert/toTai64n.d.ts +30 -0
  799. package/dist/timescale/convert/toTai64n.js +46 -0
  800. package/dist/timescale/format/formatCcsdsAsciiA.d.ts +26 -0
  801. package/dist/timescale/format/formatCcsdsAsciiA.js +40 -0
  802. package/dist/timescale/format/formatCcsdsAsciiB.d.ts +27 -0
  803. package/dist/timescale/format/formatCcsdsAsciiB.js +41 -0
  804. package/dist/timescale/format/index.d.ts +3 -0
  805. package/dist/timescale/format/index.js +4 -0
  806. package/dist/timescale/index.d.ts +21 -1
  807. package/dist/timescale/index.js +20 -1
  808. package/dist/timescale/parse/index.d.ts +3 -0
  809. package/dist/timescale/parse/index.js +4 -0
  810. package/dist/timescale/parse/parseCcsdsAsciiA.d.ts +24 -0
  811. package/dist/timescale/parse/parseCcsdsAsciiA.js +43 -0
  812. package/dist/timescale/parse/parseCcsdsAsciiB.d.ts +26 -0
  813. package/dist/timescale/parse/parseCcsdsAsciiB.js +46 -0
  814. package/dist/timescale/validate/isLeapSecond.js +1 -1
  815. package/dist/transport/calculate/bestAvailable.d.ts +3 -5
  816. package/dist/transport/calculate/bestAvailable.js +3 -5
  817. package/dist/transport/calculate/crossingTime.d.ts +6 -11
  818. package/dist/transport/calculate/crossingTime.js +12 -17
  819. package/dist/transport/calculate/cutoffAt.d.ts +6 -7
  820. package/dist/transport/calculate/cutoffAt.js +9 -10
  821. package/dist/transport/calculate/cutoffSchedule.d.ts +1 -1
  822. package/dist/transport/calculate/cutoffSchedule.js +4 -4
  823. package/dist/transport/calculate/dwellTime.d.ts +8 -10
  824. package/dist/transport/calculate/dwellTime.js +19 -27
  825. package/dist/transport/calculate/estimateDrift.d.ts +4 -5
  826. package/dist/transport/calculate/estimateDrift.js +4 -5
  827. package/dist/transport/calculate/index.js +1 -1
  828. package/dist/transport/calculate/nextDeparture.d.ts +1 -1
  829. package/dist/transport/calculate/nextDeparture.js +3 -3
  830. package/dist/transport/calculate/punctualityRate.d.ts +2 -2
  831. package/dist/transport/calculate/punctualityRate.js +1 -1
  832. package/dist/transport/calculate/scheduleDelivery.js +2 -183
  833. package/dist/transport/calculate/transitTime.d.ts +4 -6
  834. package/dist/transport/calculate/transitTime.js +6 -22
  835. package/dist/transport/compare/classifyPunctuality.d.ts +5 -7
  836. package/dist/transport/compare/classifyPunctuality.js +5 -7
  837. package/dist/transport/compare/isPastCutoff.d.ts +12 -13
  838. package/dist/transport/compare/isPastCutoff.js +19 -17
  839. package/dist/transport/compare/scheduleDeviation.d.ts +6 -14
  840. package/dist/transport/compare/scheduleDeviation.js +12 -18
  841. package/dist/transport/compare/timeToCutoff.d.ts +9 -12
  842. package/dist/transport/compare/timeToCutoff.js +16 -16
  843. package/dist/transport/convert/etaAtZone.d.ts +3 -11
  844. package/dist/transport/convert/etaAtZone.js +5 -20
  845. package/dist/transport/index.js +2 -2
  846. package/dist/types/duration-relative-to.d.ts +5 -4
  847. package/dist/types/duty.d.ts +3 -0
  848. package/dist/types/fhir.d.ts +28 -0
  849. package/dist/types/fhir.js +0 -0
  850. package/dist/types/fix.d.ts +41 -0
  851. package/dist/types/fix.js +0 -0
  852. package/dist/types/gnss.d.ts +4 -1
  853. package/dist/types/gtfs.d.ts +17 -0
  854. package/dist/types/gtfs.js +0 -0
  855. package/dist/types/hl7.d.ts +110 -0
  856. package/dist/types/hl7.js +0 -0
  857. package/dist/types/index.d.ts +9 -2
  858. package/dist/types/interval.d.ts +3 -5
  859. package/dist/types/notam.d.ts +31 -0
  860. package/dist/types/notam.js +0 -0
  861. package/dist/types/ptp.d.ts +16 -0
  862. package/dist/types/ptp.js +0 -0
  863. package/dist/types/time-scale.d.ts +21 -0
  864. package/dist/types/time-scale.js +0 -0
  865. package/dist/types/transport-timestamps.d.ts +2 -2
  866. package/dist/unix/calculate/addUnix.js +3 -3
  867. package/dist/unix/calculate/diffUnix.js +7 -9
  868. package/dist/unix/calculate/diffUnixAsDuration.js +2 -2
  869. package/dist/unix/calculate/endOfUnix.js +2 -2
  870. package/dist/unix/calculate/isBetweenUnix.js +3 -3
  871. package/dist/unix/calculate/roundUnix.js +6 -5
  872. package/dist/unix/calculate/setUnix.js +4 -4
  873. package/dist/unix/calculate/startOfUnix.js +2 -2
  874. package/dist/unix/calculate/subtractUnix.js +3 -3
  875. package/dist/unix/compare/areUnixEqualBy.js +7 -3
  876. package/dist/unix/convert/convertUnixToZoned.js +2 -2
  877. package/dist/unix/format/formatCalendarUnix.js +4 -4
  878. package/dist/unix/format/formatRelativeUnix.js +2 -2
  879. package/dist/unix/format/formatUnix.js +2 -2
  880. package/dist/unix/get/getUnixAgo.js +2 -2
  881. package/dist/unix/get/getUnixIn.js +2 -2
  882. package/dist/unix/get/getUnixNowUnit.js +2 -2
  883. package/dist/unix/index.js +1 -1
  884. package/dist/unix/interval/intervalFromDurationUnix.js +4 -4
  885. package/dist/unix/parse/index.js +1 -1
  886. package/dist/unix/parse/parseDayFromUnix.js +2 -2
  887. package/dist/unix/parse/parseHourFromUnix.js +2 -2
  888. package/dist/unix/parse/parseMicrosecondFromUnix.js +2 -2
  889. package/dist/unix/parse/parseMillisecondFromUnix.js +2 -2
  890. package/dist/unix/parse/parseMinuteFromUnix.js +2 -2
  891. package/dist/unix/parse/parseMonthFromUnix.js +2 -2
  892. package/dist/unix/parse/parseNanosecondFromUnix.js +2 -2
  893. package/dist/unix/parse/parseSecondFromUnix.js +2 -2
  894. package/dist/unix/parse/parseUnitFromUnix.js +2 -26
  895. package/dist/unix/parse/parseWeekFromUnix.js +2 -2
  896. package/dist/unix/parse/parseYearFromUnix.js +2 -2
  897. package/dist/unix/validate/isValidUnixRange.js +2 -1
  898. package/dist/utc/calculate/addUtc.js +6 -7
  899. package/dist/utc/calculate/diffUtc.js +12 -16
  900. package/dist/utc/calculate/diffUtcAsDuration.js +6 -9
  901. package/dist/utc/calculate/endOfQuarterForUtc.js +4 -4
  902. package/dist/utc/calculate/isBetweenUtc.js +10 -15
  903. package/dist/utc/calculate/maxUtc.js +4 -5
  904. package/dist/utc/calculate/minUtc.js +4 -5
  905. package/dist/utc/calculate/roundUtc.js +10 -8
  906. package/dist/utc/calculate/secondsUntilHttpDate.js +4 -5
  907. package/dist/utc/calculate/secondsUntilRetryAfter.js +4 -5
  908. package/dist/utc/calculate/setUtc.js +4 -4
  909. package/dist/utc/calculate/sortUtc.js +3 -4
  910. package/dist/utc/calculate/startOfQuarterForUtc.js +4 -4
  911. package/dist/utc/calculate/subtractUtc.js +6 -7
  912. package/dist/utc/chop/chopUtc.d.ts +2 -2
  913. package/dist/utc/chop/chopUtc.js +5 -6
  914. package/dist/utc/compare/areUtcEqual.js +5 -4
  915. package/dist/utc/compare/areUtcEqualBy.js +6 -8
  916. package/dist/utc/compare/isAfterUtc.js +5 -4
  917. package/dist/utc/compare/isBeforeUtc.js +5 -4
  918. package/dist/utc/convert/convertUtcToPlainDate.js +3 -4
  919. package/dist/utc/convert/convertUtcToPlainDateTime.js +3 -4
  920. package/dist/utc/convert/convertUtcToPlainTime.js +3 -4
  921. package/dist/utc/convert/convertUtcToUnix.js +4 -4
  922. package/dist/utc/convert/convertUtcToZoned.js +5 -5
  923. package/dist/utc/format/formatCalendarUtc.js +16 -12
  924. package/dist/utc/format/formatHttpDate.js +4 -4
  925. package/dist/utc/format/formatHttpDateFromNow.js +2 -2
  926. package/dist/utc/format/formatRelativeUtc.js +14 -10
  927. package/dist/utc/format/formatUtc.js +5 -7
  928. package/dist/utc/get/getUtcAgo.js +2 -2
  929. package/dist/utc/get/getUtcIn.js +2 -2
  930. package/dist/utc/get/getUtcNowUnit.js +2 -2
  931. package/dist/utc/index.js +6 -6
  932. package/dist/utc/interval/index.js +1 -1
  933. package/dist/utc/interval/intervalAbutsUtc.js +9 -6
  934. package/dist/utc/interval/intervalContainsUtc.js +19 -16
  935. package/dist/utc/interval/intervalCountUtc.js +8 -6
  936. package/dist/utc/interval/intervalDifferenceUtc.js +7 -11
  937. package/dist/utc/interval/intervalDivideEquallyUtc.js +4 -4
  938. package/dist/utc/interval/intervalEngulfsUtc.js +9 -6
  939. package/dist/utc/interval/intervalFromDurationUtc.js +7 -6
  940. package/dist/utc/interval/intervalIntersectionUtc.js +7 -12
  941. package/dist/utc/interval/intervalLengthUtc.js +7 -7
  942. package/dist/utc/interval/intervalOverlappingDaysUtc.js +9 -6
  943. package/dist/utc/interval/intervalSplitAtUtc.js +13 -7
  944. package/dist/utc/interval/intervalUnionUtc.js +11 -12
  945. package/dist/utc/interval/intervalXorAllUtc.js +6 -5
  946. package/dist/utc/interval/intervalXorUtc.js +9 -6
  947. package/dist/utc/interval/intervalsOverlapUtc.js +7 -10
  948. package/dist/utc/interval/mergeIntervalsUtc.js +13 -5
  949. package/dist/utc/interval/splitIntervalByUnitUtc.js +6 -6
  950. package/dist/utc/interval/validate/isValidUtcInterval.d.ts +3 -4
  951. package/dist/utc/interval/validate/isValidUtcInterval.js +5 -15
  952. package/dist/utc/parse/index.js +1 -1
  953. package/dist/utc/parse/parseDayOfWeekFromUtc.js +4 -4
  954. package/dist/utc/parse/parseHttpDate.js +2 -35
  955. package/dist/utc/parse/parseTimeFromUtc.js +3 -4
  956. package/dist/utc/parse/parseUnitFromUtc.js +7 -7
  957. package/dist/utc/parse/parseWeekFromUtc.js +6 -7
  958. package/dist/utc/validate/index.js +1 -1
  959. package/dist/utc/validate/isValidHttpDate.js +2 -2
  960. package/dist/utc/validate/isValidUtc.d.ts +3 -5
  961. package/dist/utc/validate/isValidUtc.js +2 -14
  962. package/dist/utc/validate/isValidUtcRange.js +7 -5
  963. package/dist/utc/validate/isValidUtcTimestamp.js +2 -2
  964. package/dist/workforce/calculate/dutyDayFor.js +1 -1
  965. package/dist/zoned/calculate/addZoned.js +8 -10
  966. package/dist/zoned/calculate/addZonedBusinessDays.js +5 -4
  967. package/dist/zoned/calculate/clampZoned.js +5 -6
  968. package/dist/zoned/calculate/closestZonedTo.js +8 -13
  969. package/dist/zoned/calculate/cycleZoned.js +15 -11
  970. package/dist/zoned/calculate/diffZoned.js +9 -11
  971. package/dist/zoned/calculate/diffZonedAsDuration.js +5 -5
  972. package/dist/zoned/calculate/endOfQuarterForZoned.js +6 -6
  973. package/dist/zoned/calculate/getHoursInZonedDay.js +4 -4
  974. package/dist/zoned/calculate/getLocaleZonedDayOfWeek.js +4 -4
  975. package/dist/zoned/calculate/getLocaleZonedEndOfWeek.js +6 -6
  976. package/dist/zoned/calculate/getLocaleZonedStartOfWeek.js +6 -6
  977. package/dist/zoned/calculate/getQuarterForZoned.js +3 -4
  978. package/dist/zoned/calculate/index.js +1 -1
  979. package/dist/zoned/calculate/maxZoned.js +3 -7
  980. package/dist/zoned/calculate/minZoned.js +3 -7
  981. package/dist/zoned/calculate/roundZoned.js +7 -7
  982. package/dist/zoned/calculate/setZoned.js +9 -14
  983. package/dist/zoned/calculate/sortZoned.js +3 -5
  984. package/dist/zoned/calculate/startOfQuarterForZoned.js +6 -6
  985. package/dist/zoned/calculate/subtractZoned.js +8 -10
  986. package/dist/zoned/calculate/subtractZonedBusinessDays.js +5 -4
  987. package/dist/zoned/chop/chopZonedDate.js +4 -4
  988. package/dist/zoned/chop/chopZonedDateTime.js +4 -4
  989. package/dist/zoned/chop/chopZonedMilliseconds.js +4 -4
  990. package/dist/zoned/chop/chopZonedSeconds.js +4 -4
  991. package/dist/zoned/chop/chopZonedTime.js +4 -4
  992. package/dist/zoned/chop/chopZonedTimezone.js +4 -4
  993. package/dist/zoned/classify/classifyStoredZoned.js +3 -3
  994. package/dist/zoned/compare/areZonedEqual.js +4 -11
  995. package/dist/zoned/compare/areZonedEqualBy.js +6 -7
  996. package/dist/zoned/compare/isAfterZoned.js +4 -11
  997. package/dist/zoned/compare/isBeforeZoned.js +4 -11
  998. package/dist/zoned/compare/isBetweenZoned.js +8 -16
  999. package/dist/zoned/compare/isInDaylightSaving.js +4 -4
  1000. package/dist/zoned/compare/isZonedBusinessDay.js +3 -4
  1001. package/dist/zoned/compare/isZonedFuture.js +4 -4
  1002. package/dist/zoned/compare/isZonedPast.js +4 -4
  1003. package/dist/zoned/compare/isZonedRelativeDay.js +3 -4
  1004. package/dist/zoned/compare/isZonedThisUnit.js +13 -14
  1005. package/dist/zoned/compare/isZonedWeekend.js +3 -4
  1006. package/dist/zoned/convert/convertPlainDateTimeToZoned.js +7 -9
  1007. package/dist/zoned/convert/convertZonedToCalendar.js +4 -4
  1008. package/dist/zoned/convert/convertZonedToPlainDateTime.js +4 -4
  1009. package/dist/zoned/convert/convertZonedToUnix.js +4 -4
  1010. package/dist/zoned/convert/convertZonedToUtc.js +4 -4
  1011. package/dist/zoned/convert/convertZonedToZoned.js +5 -5
  1012. package/dist/zoned/format/formatCalendarZoned.js +12 -11
  1013. package/dist/zoned/format/formatRelativeZoned.js +10 -8
  1014. package/dist/zoned/format/formatRfc2822.js +3 -4
  1015. package/dist/zoned/format/formatRfc3339.js +3 -4
  1016. package/dist/zoned/format/formatTimeZoneName.js +6 -6
  1017. package/dist/zoned/format/formatZonedDateTime.js +3 -4
  1018. package/dist/zoned/format/formatZonedRange.js +103 -20
  1019. package/dist/zoned/format/formatZonedToParts.js +3 -4
  1020. package/dist/zoned/get/getSystemTimeZone.js +2 -7
  1021. package/dist/zoned/get/getTimeZoneOffset.d.ts +4 -6
  1022. package/dist/zoned/get/getTimeZoneOffset.js +4 -6
  1023. package/dist/zoned/get/getZonedAgo.js +4 -4
  1024. package/dist/zoned/get/getZonedIn.js +4 -4
  1025. package/dist/zoned/get/getZonedNow.js +4 -4
  1026. package/dist/zoned/get/getZonedNowUnit.js +2 -2
  1027. package/dist/zoned/get/getZonedYear.js +1 -1
  1028. package/dist/zoned/get/index.js +1 -1
  1029. package/dist/zoned/index.js +13 -13
  1030. package/dist/zoned/interval/index.js +2 -2
  1031. package/dist/zoned/interval/intervalAbutsZoned.js +6 -7
  1032. package/dist/zoned/interval/intervalContainsZoned.js +8 -8
  1033. package/dist/zoned/interval/intervalCountZoned.js +4 -4
  1034. package/dist/zoned/interval/intervalDifferenceZoned.js +6 -7
  1035. package/dist/zoned/interval/intervalDivideEquallyZoned.js +5 -5
  1036. package/dist/zoned/interval/intervalEngulfsZoned.js +6 -7
  1037. package/dist/zoned/interval/intervalFromDurationZoned.js +9 -10
  1038. package/dist/zoned/interval/intervalIntersectionZoned.js +6 -7
  1039. package/dist/zoned/interval/intervalLengthZoned.js +4 -4
  1040. package/dist/zoned/interval/intervalOverlappingDaysZoned.js +9 -7
  1041. package/dist/zoned/interval/intervalSplitAtZoned.js +16 -14
  1042. package/dist/zoned/interval/intervalUnionZoned.js +6 -7
  1043. package/dist/zoned/interval/intervalXorAllZoned.js +14 -8
  1044. package/dist/zoned/interval/intervalXorZoned.js +6 -7
  1045. package/dist/zoned/interval/intervalsOverlapZoned.js +6 -7
  1046. package/dist/zoned/interval/mergeIntervalsZoned.js +13 -8
  1047. package/dist/zoned/interval/splitIntervalByUnitZoned.js +4 -5
  1048. package/dist/zoned/interval/validate/isValidCalendarZonedInterval.js +2 -10
  1049. package/dist/zoned/interval/validate/isValidZonedInterval.d.ts +5 -5
  1050. package/dist/zoned/interval/validate/isValidZonedInterval.js +11 -10
  1051. package/dist/zoned/map/mapZonedDatesInRange.js +4 -11
  1052. package/dist/zoned/map/mapZonedHoursInDay.js +4 -4
  1053. package/dist/zoned/parse/getZonedOffset.js +4 -4
  1054. package/dist/zoned/parse/getZonedOffsetAs.js +4 -4
  1055. package/dist/zoned/parse/index.js +2 -2
  1056. package/dist/zoned/parse/parseDateFromZoned.js +4 -4
  1057. package/dist/zoned/parse/parseDateTimeFromZoned.js +5 -5
  1058. package/dist/zoned/parse/parseDayFromZoned.js +4 -4
  1059. package/dist/zoned/parse/parseDayOfWeekFromZoned.js +4 -4
  1060. package/dist/zoned/parse/parseHourFromZoned.js +4 -4
  1061. package/dist/zoned/parse/parseMicrosecondFromZoned.js +4 -4
  1062. package/dist/zoned/parse/parseMillisecondFromZoned.js +4 -4
  1063. package/dist/zoned/parse/parseMinuteFromZoned.js +4 -4
  1064. package/dist/zoned/parse/parseMonthFromZoned.js +4 -4
  1065. package/dist/zoned/parse/parseNanosecondFromZoned.js +4 -4
  1066. package/dist/zoned/parse/parseRfc2822.js +2 -19
  1067. package/dist/zoned/parse/parseRfc3339.js +2 -13
  1068. package/dist/zoned/parse/parseSecondFromZoned.js +4 -4
  1069. package/dist/zoned/parse/parseTimeFromZoned.js +4 -4
  1070. package/dist/zoned/parse/parseTimeZoneFromZoned.js +4 -4
  1071. package/dist/zoned/parse/parseUnitFromZoned.js +5 -6
  1072. package/dist/zoned/parse/parseWeekFromZoned.js +5 -6
  1073. package/dist/zoned/parse/parseYearFromZoned.js +3 -4
  1074. package/dist/zoned/validate/hasDaylightSaving.d.ts +3 -4
  1075. package/dist/zoned/validate/hasDaylightSaving.js +1 -1
  1076. package/dist/zoned/validate/index.js +2 -2
  1077. package/dist/zoned/validate/isValidCalendarZonedDateTime.d.ts +6 -8
  1078. package/dist/zoned/validate/isValidCalendarZonedDateTime.js +2 -7
  1079. package/dist/zoned/validate/isValidRfc2822DateTime.js +2 -2
  1080. package/dist/zoned/validate/isValidRfc3339DateTime.js +2 -2
  1081. package/dist/zoned/validate/isValidZonedDateTime.d.ts +6 -7
  1082. package/dist/zoned/validate/isValidZonedDateTime.js +2 -11
  1083. package/dist/zoned/validate/isValidZonedRange.d.ts +3 -3
  1084. package/dist/zoned/validate/isValidZonedRange.js +8 -7
  1085. package/package.json +155 -1
  1086. package/skills/gmt-arithmetic/SKILL.md +5 -4
  1087. package/skills/gmt-aviation/SKILL.md +124 -0
  1088. package/skills/gmt-basics/SKILL.md +8 -7
  1089. package/skills/gmt-finance/SKILL.md +121 -0
  1090. package/skills/gmt-gnss/SKILL.md +6 -5
  1091. package/skills/gmt-healthcare/SKILL.md +145 -0
  1092. package/skills/gmt-integration/SKILL.md +63 -14
  1093. package/skills/gmt-intermodal/SKILL.md +1 -1
  1094. package/skills/gmt-iot/SKILL.md +95 -0
  1095. package/skills/gmt-rail/SKILL.md +101 -0
  1096. package/skills/gmt-timezone/SKILL.md +17 -18
  1097. package/skills/gmt-transport/SKILL.md +6 -4
  1098. package/skills/gmt-workforce/SKILL.md +1 -1
  1099. package/dist/internal/temporalCompat/isoCalendarFrom.d.ts +0 -38
  1100. package/dist/internal/temporalCompat/isoCalendarFrom.js +0 -59
  1101. package/dist/internal/toInstantFromUtc.d.ts +0 -12
  1102. package/dist/internal/toInstantFromUtc.js +0 -30
@@ -0,0 +1,61 @@
1
+ import { isObject } from "../../internal/isObject.js";
2
+ import { LEAP_SECOND_STEPS } from "../../internal/leapSeconds.js";
3
+ import { formatUtcReading } from "../../internal/utcReading.js";
4
+ import { JD_OF_UNIX_EPOCH_MIDNIGHT_HALF_DAYS, dayPositionOfDays, exactDyadic, isTimeScale, readingOfDayPosition } from "../../internal/julianDate.js";
5
+
6
+ // src/timescale/convert/fromJulianDateParts.ts
7
+ /**
8
+ * Convert a two-part Julian Date on a time scale to a UTC instant string. The scale defaults to
9
+ * `"UTC"`.
10
+ *
11
+ * - The inverse of `toJulianDateParts`. The two doubles are read exactly and summed exactly
12
+ * (`jd1 + jd2 − 2440587.5` days since 1970-01-01), then rounded to the nearest nanosecond, a
13
+ * half rounding up (Temporal's `halfExpand`). On `"UTC"`, `"TAI"` and `"TT"` that rounds the
14
+ * instant. On `"TCG"` it rounds the TCG label, which `fromTCG` then maps to UTC (flooring to
15
+ * the TT nanosecond), so the result can be 1 ns later than the exact inverse of the date. The
16
+ * round trip with `toJulianDateParts` stays exact.
17
+ * - Any split works (ERFA `jd2cal.c` Note 2): `{2451545, 0}`, `{2400000.5, 51544.5}`, `{0, 2451545}`
18
+ * and `{2451545.5, -0.5}` give the same instant, though a split that puts everything into one
19
+ * part has already lost precision in that double.
20
+ * - JD days begin at noon: `{ jd1: 2451544, jd2: 0.5 }` is midnight UTC.
21
+ * - On `"UTC"` the count is ERFA's quasi-JD: a day with a leap second counts as one day, so a
22
+ * fraction past the end of an ordinary day reads as `…T23:59:60Z` on a leap-second day. On
23
+ * `"TAI"`, `"TT"` and `"TCG"` it is a true JD. TDB is not available.
24
+ * - Returns `"Z"` form with Temporal's shortest fraction, and `…:60` inside an inserted second.
25
+ * - Both members must be finite numbers; a bigint, a numeric string, `NaN` or a missing member
26
+ * gives "".
27
+ * - Domain: 1972-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z UTC; "" outside it.
28
+ *
29
+ * @param parts the two-part Julian Date
30
+ * @param scale the time scale the date is counted on, default `"UTC"`
31
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input, an unknown scale or a date outside the domain
32
+ *
33
+ * @example fromJulianDateParts({ jd1: 2451545, jd2: 0 }) // "2000-01-01T12:00:00Z"
34
+ * @example fromJulianDateParts({ jd1: 2451545, jd2: 0 }, "TT") // "2000-01-01T11:58:55.816Z"
35
+ * @example fromJulianDateParts({ jd1: 2400000.5, jd2: 51544.5 }) // "2000-01-01T12:00:00Z"
36
+ * @example fromJulianDateParts({ jd1: 2457754, jd2: 86399 / 172802 }) // "2016-12-31T23:59:60Z"
37
+ * @example fromJulianDateParts({ jd1: 2441317, jd2: 0.4999999 }) // "" — before 1972
38
+ * @example fromJulianDateParts({ jd1: NaN, jd2: 0 }) // ""
39
+ */
40
+ function fromJulianDateParts(parts, scale = "UTC") {
41
+ try {
42
+ if (!isTimeScale(scale) || !isObject(parts)) return "";
43
+ const { jd1, jd2 } = parts;
44
+ if (typeof jd1 !== "number" || typeof jd2 !== "number" || !Number.isFinite(jd1) || !Number.isFinite(jd2)) return "";
45
+ const one = exactDyadic(jd1);
46
+ const two = exactDyadic(jd2);
47
+ let exponent = 1n;
48
+ if (one.exponent > exponent) exponent = one.exponent;
49
+ if (two.exponent > exponent) exponent = two.exponent;
50
+ const denominator = 1n << exponent;
51
+ const numerator = one.numerator * (denominator >> one.exponent) + two.numerator * (denominator >> two.exponent) - JD_OF_UNIX_EPOCH_MIDNIGHT_HALF_DAYS * (denominator >> 1n);
52
+ const position = dayPositionOfDays(numerator, denominator, LEAP_SECOND_STEPS, scale);
53
+ if (position === null) return "";
54
+ const reading = readingOfDayPosition(LEAP_SECOND_STEPS, position.epochDay, position.nanosOfDay, scale);
55
+ return reading === null ? "" : formatUtcReading(reading);
56
+ } catch {
57
+ return "";
58
+ }
59
+ }
60
+
61
+ export { fromJulianDateParts };
@@ -0,0 +1,30 @@
1
+ import { TimeScale } from "../../types/time-scale.js";
2
+ /**
3
+ * Convert a Modified Julian Date on a time scale to a UTC instant string. The scale defaults to
4
+ * `"UTC"`.
5
+ *
6
+ * - The inverse of `toModifiedJulianDate`. The double is read exactly (`mjd − 40587` days since
7
+ * 1970-01-01), then rounded once to the nearest nanosecond, a half rounding up (Temporal's
8
+ * `halfExpand`).
9
+ * - MJD = JD − 2 400 000.5 and counts from midnight, not noon: `51544` is midnight, `51544.5` noon.
10
+ * - A double from `toModifiedJulianDate` is at most ½ ulp(MJD) days from the instant: 0.31 µs
11
+ * for 1972 to 2038-04-22, growing to 20.1 µs (2⁻³² day) by year 9999, as MJD stays below 2²².
12
+ * For nanoseconds use `fromJulianDateParts`.
13
+ * - On `"UTC"` the count is ERFA's quasi-MJD: a day with a leap second counts as one day, so on a
14
+ * leap-second day the fraction 86400/86401 of the day is where `…T23:59:60Z` begins. On
15
+ * `"TAI"`, `"TT"` and `"TCG"` it is a true count. TDB is not available.
16
+ * - Returns `"Z"` form with Temporal's shortest fraction, and `…:60` inside an inserted second.
17
+ * - `mjd` must be a finite number; a bigint, a numeric string, `NaN` or `Infinity` gives "".
18
+ * - Domain: 1972-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z UTC; "" outside it.
19
+ *
20
+ * @param mjd the Modified Julian Date
21
+ * @param scale the time scale the date is counted on, default `"UTC"`
22
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input, an unknown scale or a date outside the domain
23
+ *
24
+ * @example fromModifiedJulianDate(51544) // "2000-01-01T00:00:00Z"
25
+ * @example fromModifiedJulianDate(51544.5, "TT") // "2000-01-01T11:58:55.816Z"
26
+ * @example fromModifiedJulianDate(57753.5) // "2016-12-31T12:00:00.5Z"
27
+ * @example fromModifiedJulianDate(41316.99) // "" — before 1972
28
+ * @example fromModifiedJulianDate(NaN) // ""
29
+ */
30
+ export declare function fromModifiedJulianDate(mjd: number, scale?: TimeScale): string;
@@ -0,0 +1,47 @@
1
+ import { LEAP_SECOND_STEPS } from "../../internal/leapSeconds.js";
2
+ import { formatUtcReading } from "../../internal/utcReading.js";
3
+ import { dayPositionOfDays, epochDaysOfModifiedJulianDate, isTimeScale, readingOfDayPosition } from "../../internal/julianDate.js";
4
+
5
+ // src/timescale/convert/fromModifiedJulianDate.ts
6
+ /**
7
+ * Convert a Modified Julian Date on a time scale to a UTC instant string. The scale defaults to
8
+ * `"UTC"`.
9
+ *
10
+ * - The inverse of `toModifiedJulianDate`. The double is read exactly (`mjd − 40587` days since
11
+ * 1970-01-01), then rounded once to the nearest nanosecond, a half rounding up (Temporal's
12
+ * `halfExpand`).
13
+ * - MJD = JD − 2 400 000.5 and counts from midnight, not noon: `51544` is midnight, `51544.5` noon.
14
+ * - A double from `toModifiedJulianDate` is at most ½ ulp(MJD) days from the instant: 0.31 µs
15
+ * for 1972 to 2038-04-22, growing to 20.1 µs (2⁻³² day) by year 9999, as MJD stays below 2²².
16
+ * For nanoseconds use `fromJulianDateParts`.
17
+ * - On `"UTC"` the count is ERFA's quasi-MJD: a day with a leap second counts as one day, so on a
18
+ * leap-second day the fraction 86400/86401 of the day is where `…T23:59:60Z` begins. On
19
+ * `"TAI"`, `"TT"` and `"TCG"` it is a true count. TDB is not available.
20
+ * - Returns `"Z"` form with Temporal's shortest fraction, and `…:60` inside an inserted second.
21
+ * - `mjd` must be a finite number; a bigint, a numeric string, `NaN` or `Infinity` gives "".
22
+ * - Domain: 1972-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z UTC; "" outside it.
23
+ *
24
+ * @param mjd the Modified Julian Date
25
+ * @param scale the time scale the date is counted on, default `"UTC"`
26
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input, an unknown scale or a date outside the domain
27
+ *
28
+ * @example fromModifiedJulianDate(51544) // "2000-01-01T00:00:00Z"
29
+ * @example fromModifiedJulianDate(51544.5, "TT") // "2000-01-01T11:58:55.816Z"
30
+ * @example fromModifiedJulianDate(57753.5) // "2016-12-31T12:00:00.5Z"
31
+ * @example fromModifiedJulianDate(41316.99) // "" — before 1972
32
+ * @example fromModifiedJulianDate(NaN) // ""
33
+ */
34
+ function fromModifiedJulianDate(mjd, scale = "UTC") {
35
+ try {
36
+ if (!isTimeScale(scale) || typeof mjd !== "number" || !Number.isFinite(mjd)) return "";
37
+ const days = epochDaysOfModifiedJulianDate(mjd);
38
+ const position = dayPositionOfDays(days.numerator, days.denominator, LEAP_SECOND_STEPS, scale);
39
+ if (position === null) return "";
40
+ const reading = readingOfDayPosition(LEAP_SECOND_STEPS, position.epochDay, position.nanosOfDay, scale);
41
+ return reading === null ? "" : formatUtcReading(reading);
42
+ } catch {
43
+ return "";
44
+ }
45
+ }
46
+
47
+ export { fromModifiedJulianDate };
@@ -6,8 +6,9 @@
6
6
  * - UTC = TAI − (TAI − UTC), from the IERS leap-second table built into GMT (Leap_Second.dat
7
7
  * through Bulletin C 72, 6 July 2026). The table is closed: after the last insertion
8
8
  * (2016-12-31) TAI − UTC stays 37 s.
9
- * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only this
10
- * realm's functions read that string back; other GMT functions reject a second of 60.
9
+ * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
10
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
11
+ * reject a second of 60.
11
12
  * - "" before 1972-01-01T00:00:10 TAI and on invalid input.
12
13
  *
13
14
  * @param taiString TAI time-scale string
@@ -1,5 +1,5 @@
1
- import { formatUtcReading } from "../../internal/utcReading.js";
2
1
  import { LEAP_SECOND_STEPS, utcOfTai } from "../../internal/leapSeconds.js";
2
+ import { formatUtcReading } from "../../internal/utcReading.js";
3
3
  import { parseTimeScaleString } from "../../internal/timeScaleString.js";
4
4
 
5
5
  // src/timescale/convert/fromTAI.ts
@@ -11,8 +11,9 @@ import { parseTimeScaleString } from "../../internal/timeScaleString.js";
11
11
  * - UTC = TAI − (TAI − UTC), from the IERS leap-second table built into GMT (Leap_Second.dat
12
12
  * through Bulletin C 72, 6 July 2026). The table is closed: after the last insertion
13
13
  * (2016-12-31) TAI − UTC stays 37 s.
14
- * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only this
15
- * realm's functions read that string back; other GMT functions reject a second of 60.
14
+ * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
15
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
16
+ * reject a second of 60.
16
17
  * - "" before 1972-01-01T00:00:10 TAI and on invalid input.
17
18
  *
18
19
  * @param taiString TAI time-scale string
@@ -27,7 +28,7 @@ import { parseTimeScaleString } from "../../internal/timeScaleString.js";
27
28
  function fromTAI(taiString) {
28
29
  try {
29
30
  const label = parseTimeScaleString(taiString, "TAI");
30
- if (label === null || label.secondSixty) return "";
31
+ if (label === null) return "";
31
32
  const reading = utcOfTai(LEAP_SECOND_STEPS, label.labelNanoseconds);
32
33
  return reading === null ? "" : formatUtcReading(reading);
33
34
  } catch {
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Convert a Geocentric Coordinate Time string to a UTC instant string.
3
+ *
4
+ * - Reads `YYYY-MM-DDTHH:MM:SS[.fraction] TCG`: four-digit year, `T`, seconds required, 1 to 9
5
+ * fraction digits after `.`, one space, `TCG` (the FITS 4.0 time-scale token). TCG has no
6
+ * second 60.
7
+ * - TT = TCG − L_G × (TCG − T₀), the inverse of IERS TN 36 eq. 10.1 solved from
8
+ * dTT/dTCG = 1 − L_G (IAU 2000 B1.9) with T₀ from eq. 10.1; the floor is GMT's nanosecond rule.
9
+ * Then UTC from TT as `fromTT` does.
10
+ * - Exact inverse of `toTCG` to the nanosecond. About one TCG nanosecond in 1.4 × 10⁹ is never
11
+ * written by `toTCG`; it reads as the next nanosecond's UTC instant.
12
+ * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
13
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
14
+ * reject a second of 60.
15
+ * - "" before 1972-01-01T00:00:42.07398781 TCG and on invalid input.
16
+ *
17
+ * @param tcgString TCG time-scale string
18
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input or a date before 1972
19
+ *
20
+ * @example fromTCG("2026-01-01T00:01:10.261661917 TCG") // "2026-01-01T00:00:00Z"
21
+ * @example fromTCG("2017-01-01T00:01:09.063736307 TCG") // "2016-12-31T23:59:60Z"
22
+ * @example fromTCG("1977-01-01T00:00:32.184 TCG") // "1976-12-31T23:59:45Z"
23
+ * @example fromTCG("1972-01-01T00:00:42.073987809 TCG") // "" — before 1972
24
+ * @example fromTCG("2026-01-01T00:01:10.261661917 TT") // "" — wrong token
25
+ */
26
+ export declare function fromTCG(tcgString: string): string;
@@ -0,0 +1,43 @@
1
+ import { LEAP_SECOND_STEPS } from "../../internal/leapSeconds.js";
2
+ import { formatUtcReading } from "../../internal/utcReading.js";
3
+ import { parseTimeScaleString } from "../../internal/timeScaleString.js";
4
+ import { ttOfTcg, utcOfTt } from "../../internal/terrestrialTime.js";
5
+
6
+ // src/timescale/convert/fromTCG.ts
7
+ /**
8
+ * Convert a Geocentric Coordinate Time string to a UTC instant string.
9
+ *
10
+ * - Reads `YYYY-MM-DDTHH:MM:SS[.fraction] TCG`: four-digit year, `T`, seconds required, 1 to 9
11
+ * fraction digits after `.`, one space, `TCG` (the FITS 4.0 time-scale token). TCG has no
12
+ * second 60.
13
+ * - TT = TCG − L_G × (TCG − T₀), the inverse of IERS TN 36 eq. 10.1 solved from
14
+ * dTT/dTCG = 1 − L_G (IAU 2000 B1.9) with T₀ from eq. 10.1; the floor is GMT's nanosecond rule.
15
+ * Then UTC from TT as `fromTT` does.
16
+ * - Exact inverse of `toTCG` to the nanosecond. About one TCG nanosecond in 1.4 × 10⁹ is never
17
+ * written by `toTCG`; it reads as the next nanosecond's UTC instant.
18
+ * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
19
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
20
+ * reject a second of 60.
21
+ * - "" before 1972-01-01T00:00:42.07398781 TCG and on invalid input.
22
+ *
23
+ * @param tcgString TCG time-scale string
24
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input or a date before 1972
25
+ *
26
+ * @example fromTCG("2026-01-01T00:01:10.261661917 TCG") // "2026-01-01T00:00:00Z"
27
+ * @example fromTCG("2017-01-01T00:01:09.063736307 TCG") // "2016-12-31T23:59:60Z"
28
+ * @example fromTCG("1977-01-01T00:00:32.184 TCG") // "1976-12-31T23:59:45Z"
29
+ * @example fromTCG("1972-01-01T00:00:42.073987809 TCG") // "" — before 1972
30
+ * @example fromTCG("2026-01-01T00:01:10.261661917 TT") // "" — wrong token
31
+ */
32
+ function fromTCG(tcgString) {
33
+ try {
34
+ const label = parseTimeScaleString(tcgString, "TCG");
35
+ if (label === null) return "";
36
+ const reading = utcOfTt(LEAP_SECOND_STEPS, ttOfTcg(label.labelNanoseconds));
37
+ return reading === null ? "" : formatUtcReading(reading);
38
+ } catch {
39
+ return "";
40
+ }
41
+ }
42
+
43
+ export { fromTCG };
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Convert a Terrestrial Time string to a UTC instant string.
3
+ *
4
+ * - Reads `YYYY-MM-DDTHH:MM:SS[.fraction] TT`: four-digit year, `T`, seconds required, 1 to 9
5
+ * fraction digits after `.`, one space, `TT` (the FITS 4.0 time-scale token). FITS's deprecated
6
+ * `TDT` and `ET` are not read. TT has no second 60.
7
+ * - UTC = TT − 32.184 s − (TAI − UTC), from the IERS leap-second table built into GMT
8
+ * (Leap_Second.dat through Bulletin C 72, 6 July 2026). The table is closed: after the last
9
+ * insertion (2016-12-31) TAI − UTC stays 37 s.
10
+ * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
11
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
12
+ * reject a second of 60.
13
+ * - "" before 1972-01-01T00:00:42.184 TT and on invalid input.
14
+ *
15
+ * @param ttString TT time-scale string
16
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input or a date before 1972
17
+ *
18
+ * @example fromTT("2026-01-01T00:01:09.184 TT") // "2026-01-01T00:00:00Z"
19
+ * @example fromTT("2017-01-01T00:01:08.184 TT") // "2016-12-31T23:59:60Z"
20
+ * @example fromTT("2017-01-01T00:01:08.684 TT") // "2016-12-31T23:59:60.5Z"
21
+ * @example fromTT("2026-01-01T00:01:09.184 TAI") // "" — wrong token
22
+ * @example fromTT("2016-12-31T23:59:60 TT") // "" — TT has no second 60
23
+ */
24
+ export declare function fromTT(ttString: string): string;
@@ -0,0 +1,41 @@
1
+ import { LEAP_SECOND_STEPS } from "../../internal/leapSeconds.js";
2
+ import { formatUtcReading } from "../../internal/utcReading.js";
3
+ import { parseTimeScaleString } from "../../internal/timeScaleString.js";
4
+ import { utcOfTt } from "../../internal/terrestrialTime.js";
5
+
6
+ // src/timescale/convert/fromTT.ts
7
+ /**
8
+ * Convert a Terrestrial Time string to a UTC instant string.
9
+ *
10
+ * - Reads `YYYY-MM-DDTHH:MM:SS[.fraction] TT`: four-digit year, `T`, seconds required, 1 to 9
11
+ * fraction digits after `.`, one space, `TT` (the FITS 4.0 time-scale token). FITS's deprecated
12
+ * `TDT` and `ET` are not read. TT has no second 60.
13
+ * - UTC = TT − 32.184 s − (TAI − UTC), from the IERS leap-second table built into GMT
14
+ * (Leap_Second.dat through Bulletin C 72, 6 July 2026). The table is closed: after the last
15
+ * insertion (2016-12-31) TAI − UTC stays 37 s.
16
+ * - During an inserted leap second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
17
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
18
+ * reject a second of 60.
19
+ * - "" before 1972-01-01T00:00:42.184 TT and on invalid input.
20
+ *
21
+ * @param ttString TT time-scale string
22
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input or a date before 1972
23
+ *
24
+ * @example fromTT("2026-01-01T00:01:09.184 TT") // "2026-01-01T00:00:00Z"
25
+ * @example fromTT("2017-01-01T00:01:08.184 TT") // "2016-12-31T23:59:60Z"
26
+ * @example fromTT("2017-01-01T00:01:08.684 TT") // "2016-12-31T23:59:60.5Z"
27
+ * @example fromTT("2026-01-01T00:01:09.184 TAI") // "" — wrong token
28
+ * @example fromTT("2016-12-31T23:59:60 TT") // "" — TT has no second 60
29
+ */
30
+ function fromTT(ttString) {
31
+ try {
32
+ const label = parseTimeScaleString(ttString, "TT");
33
+ if (label === null) return "";
34
+ const reading = utcOfTt(LEAP_SECOND_STEPS, label.labelNanoseconds);
35
+ return reading === null ? "" : formatUtcReading(reading);
36
+ } catch {
37
+ return "";
38
+ }
39
+ }
40
+
41
+ export { fromTT };
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Convert a TAI64, TAI64N or TAI64NA label in hex text to a UTC instant string.
3
+ *
4
+ * - Reads 16 (TAI64), 24 (TAI64N) or 32 (TAI64NA) hex digits, with or without the leading `@`
5
+ * daemontools writes, either case. The whole string must be the label: no log text, no spaces.
6
+ * - The label is TAI: 2^62 + the TAI seconds since 1970-01-01T00:00:00 TAI (Bernstein, TAI64 §
7
+ * TAI64 labels), not Unix seconds. Reading it as Unix time is wrong by TAI − UTC: 26 s in
8
+ * 1992, 37 s today.
9
+ * - UTC = TAI − (TAI − UTC), from the IERS leap-second table built into GMT (Leap_Second.dat
10
+ * through Bulletin C 72, 6 July 2026). The table is closed: after the last insertion
11
+ * (2016-12-31) TAI − UTC stays 37 s.
12
+ * - During an inserted second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
13
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
14
+ * reject a second of 60.
15
+ * - Nanoseconds are kept exactly. TAI64NA attoseconds are checked (0 to 999999999) and dropped:
16
+ * truncated, never rounded.
17
+ * - daemontools `tai64n` assumes the system clock counts TAI seconds since 1970-01-01 00:00:10 TAI
18
+ * (https://cr.yp.to/daemontools/tai64n.html): on a POSIX UTC clock its label is
19
+ * (TAI − UTC) − 10 = 27 s below the true label from 2017 on, and `fromTai64n` reads it 27 s early.
20
+ * - "" for a label before 1972-01-01T00:00:10 TAI, a result past year 9999, a reserved label
21
+ * (2^63 and up), a counter above 999999999, and on invalid input.
22
+ *
23
+ * @param label TAI64, TAI64N or TAI64NA hex text
24
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input, a label before
25
+ * 1972-01-01T00:00:10 TAI, a result past year 9999, a reserved label (2^63 and up), or a counter
26
+ * above 999999999
27
+ *
28
+ * @example fromTai64n("@400000002a2b2c2d00000000") // "1992-06-02T08:06:43Z" — Bernstein's example
29
+ * @example fromTai64n("@4000000037c219bf2ef02e94") // "1999-08-24T04:03:43.7874925Z" — daemontools' example
30
+ * @example fromTai64n("400000002a2b2c2d") // "1992-06-02T08:06:43Z" — TAI64
31
+ * @example fromTai64n("@4000000037c219bf2ef02e943b9ac9ff") // "1999-08-24T04:03:43.7874925Z" — attoseconds dropped
32
+ * @example fromTai64n("@40000000586846a400000000") // "2016-12-31T23:59:60Z" — the inserted second
33
+ * @example fromTai64n("@4000000000000000") // "" — 1970 TAI, before 1972
34
+ * @example fromTai64n("@400000002a2b2c2d0000000") // "" — 23 hex digits
35
+ */
36
+ export declare function fromTai64n(label: string): string;
@@ -0,0 +1,52 @@
1
+ import { LEAP_SECOND_STEPS, utcOfTai } from "../../internal/leapSeconds.js";
2
+ import { formatUtcReading } from "../../internal/utcReading.js";
3
+ import { parseTai64Label } from "../../internal/tai64Label.js";
4
+
5
+ // src/timescale/convert/fromTai64n.ts
6
+ /**
7
+ * Convert a TAI64, TAI64N or TAI64NA label in hex text to a UTC instant string.
8
+ *
9
+ * - Reads 16 (TAI64), 24 (TAI64N) or 32 (TAI64NA) hex digits, with or without the leading `@`
10
+ * daemontools writes, either case. The whole string must be the label: no log text, no spaces.
11
+ * - The label is TAI: 2^62 + the TAI seconds since 1970-01-01T00:00:00 TAI (Bernstein, TAI64 §
12
+ * TAI64 labels), not Unix seconds. Reading it as Unix time is wrong by TAI − UTC: 26 s in
13
+ * 1992, 37 s today.
14
+ * - UTC = TAI − (TAI − UTC), from the IERS leap-second table built into GMT (Leap_Second.dat
15
+ * through Bulletin C 72, 6 July 2026). The table is closed: after the last insertion
16
+ * (2016-12-31) TAI − UTC stays 37 s.
17
+ * - During an inserted second the result is `…T23:59:60Z` (ITU-R TF.460-6 Annex 3). Only the
18
+ * `timescale/`, `gnss/` and `finance/` functions read that string back; other GMT functions
19
+ * reject a second of 60.
20
+ * - Nanoseconds are kept exactly. TAI64NA attoseconds are checked (0 to 999999999) and dropped:
21
+ * truncated, never rounded.
22
+ * - daemontools `tai64n` assumes the system clock counts TAI seconds since 1970-01-01 00:00:10 TAI
23
+ * (https://cr.yp.to/daemontools/tai64n.html): on a POSIX UTC clock its label is
24
+ * (TAI − UTC) − 10 = 27 s below the true label from 2017 on, and `fromTai64n` reads it 27 s early.
25
+ * - "" for a label before 1972-01-01T00:00:10 TAI, a result past year 9999, a reserved label
26
+ * (2^63 and up), a counter above 999999999, and on invalid input.
27
+ *
28
+ * @param label TAI64, TAI64N or TAI64NA hex text
29
+ * @returns ISO 8601 UTC instant string (`Z`), or "" on invalid input, a label before
30
+ * 1972-01-01T00:00:10 TAI, a result past year 9999, a reserved label (2^63 and up), or a counter
31
+ * above 999999999
32
+ *
33
+ * @example fromTai64n("@400000002a2b2c2d00000000") // "1992-06-02T08:06:43Z" — Bernstein's example
34
+ * @example fromTai64n("@4000000037c219bf2ef02e94") // "1999-08-24T04:03:43.7874925Z" — daemontools' example
35
+ * @example fromTai64n("400000002a2b2c2d") // "1992-06-02T08:06:43Z" — TAI64
36
+ * @example fromTai64n("@4000000037c219bf2ef02e943b9ac9ff") // "1999-08-24T04:03:43.7874925Z" — attoseconds dropped
37
+ * @example fromTai64n("@40000000586846a400000000") // "2016-12-31T23:59:60Z" — the inserted second
38
+ * @example fromTai64n("@4000000000000000") // "" — 1970 TAI, before 1972
39
+ * @example fromTai64n("@400000002a2b2c2d0000000") // "" — 23 hex digits
40
+ */
41
+ function fromTai64n(label) {
42
+ try {
43
+ const tai = parseTai64Label(label);
44
+ if (tai === null) return "";
45
+ const reading = utcOfTai(LEAP_SECOND_STEPS, tai);
46
+ return reading === null ? "" : formatUtcReading(reading);
47
+ } catch {
48
+ return "";
49
+ }
50
+ }
51
+
52
+ export { fromTai64n };
@@ -1,3 +1,17 @@
1
+ import { fromJ2000Seconds } from "./fromJ2000Seconds.js";
2
+ import { fromJulianDate } from "./fromJulianDate.js";
3
+ import { fromJulianDateParts } from "./fromJulianDateParts.js";
4
+ import { fromModifiedJulianDate } from "./fromModifiedJulianDate.js";
1
5
  import { fromTAI } from "./fromTAI.js";
6
+ import { fromTCG } from "./fromTCG.js";
7
+ import { fromTai64n } from "./fromTai64n.js";
8
+ import { fromTT } from "./fromTT.js";
9
+ import { toJ2000Seconds } from "./toJ2000Seconds.js";
10
+ import { toJulianDate } from "./toJulianDate.js";
11
+ import { toJulianDateParts } from "./toJulianDateParts.js";
12
+ import { toModifiedJulianDate } from "./toModifiedJulianDate.js";
2
13
  import { toTAI } from "./toTAI.js";
3
- export { fromTAI, toTAI };
14
+ import { toTCG } from "./toTCG.js";
15
+ import { toTai64n } from "./toTai64n.js";
16
+ import { toTT } from "./toTT.js";
17
+ export { fromJ2000Seconds, fromJulianDate, fromJulianDateParts, fromModifiedJulianDate, fromTAI, fromTCG, fromTT, fromTai64n, toJ2000Seconds, toJulianDate, toJulianDateParts, toModifiedJulianDate, toTAI, toTCG, toTT, toTai64n };
@@ -1,4 +1,18 @@
1
+ import { fromJ2000Seconds } from "./fromJ2000Seconds.js";
2
+ import { fromJulianDate } from "./fromJulianDate.js";
3
+ import { fromJulianDateParts } from "./fromJulianDateParts.js";
4
+ import { fromModifiedJulianDate } from "./fromModifiedJulianDate.js";
1
5
  import { fromTAI } from "./fromTAI.js";
6
+ import { fromTCG } from "./fromTCG.js";
7
+ import { fromTai64n } from "./fromTai64n.js";
8
+ import { fromTT } from "./fromTT.js";
9
+ import { toJ2000Seconds } from "./toJ2000Seconds.js";
10
+ import { toJulianDate } from "./toJulianDate.js";
11
+ import { toJulianDateParts } from "./toJulianDateParts.js";
12
+ import { toModifiedJulianDate } from "./toModifiedJulianDate.js";
2
13
  import { toTAI } from "./toTAI.js";
14
+ import { toTCG } from "./toTCG.js";
15
+ import { toTai64n } from "./toTai64n.js";
16
+ import { toTT } from "./toTT.js";
3
17
 
4
- export { fromTAI, toTAI };
18
+ export { fromJ2000Seconds, fromJulianDate, fromJulianDateParts, fromModifiedJulianDate, fromTAI, fromTCG, fromTT, fromTai64n, toJ2000Seconds, toJulianDate, toJulianDateParts, toModifiedJulianDate, toTAI, toTCG, toTT, toTai64n };
@@ -0,0 +1,37 @@
1
+ import { TimeScale } from "../../types/time-scale.js";
2
+ /**
3
+ * Convert a UTC instant to seconds since J2000.0 on a time scale. **The scale defaults to
4
+ * `"TT"`, unlike the Julian Date and MJD functions, which default to `"UTC"`**: J2000.0 is
5
+ * defined as 2000-01-01T12:00:00 TT (IAU 1994 Resolution C7).
6
+ *
7
+ * - The result is (JD on the scale − 2451545.0) × 86 400 (ERFA `ERFA_DJ00`, `ERFA_DAYSEC`).
8
+ * On `"TT"` it counts TT seconds from J2000.0 itself; on `"TAI"` and `"TCG"` it counts from
9
+ * the label `2000-01-01T12:00:00` on that scale.
10
+ * - On `"UTC"` it is the quasi-JD count (ERFA `dtf2d.c` Notes 4 and 7). On every day without a
11
+ * leap second it equals Unix seconds minus 946 728 000. On a day with one, the 86 401 s are
12
+ * scaled to fill 86 400, so, like Unix time, the difference between two UTC values is not an
13
+ * exact interval.
14
+ * - TDB is not available, so this is not the "ephemeris seconds past J2000", which count on TDB.
15
+ * - Precision: the result is the double nearest the exact count (rounded once, ties to even), so
16
+ * the error is at most half an ulp of the result. Seconds since J2000 in one double keep
17
+ * a spacing (ulp) of at most 2⁻²³ s (0.12 µs) for |seconds| < 2³⁰ (about 1966 to 2034), so a
18
+ * value is off by at most 0.06 µs (half an ulp), and a spacing of 30.5 µs at year 9999, a
19
+ * value off by at most 15 µs. Callers
20
+ * needing nanoseconds should use `toJulianDateParts`.
21
+ * - Accepts any offset or bracketed zone, and a listed leap second `…T23:59:60Z`.
22
+ * - Domain: 1972-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z UTC; `null` outside it. Within
23
+ * about 15 µs (half an ulp) of the end of 9999 (on UTC, TAI and TCG) it also returns `null`, because the
24
+ * nearest double lies past the domain and `fromJ2000Seconds` would reject it;
25
+ * `toJulianDateParts` covers the whole domain exactly.
26
+ *
27
+ * @param isoString ISO 8601 instant string
28
+ * @param scale the time scale to count on, default `"TT"`
29
+ * @returns seconds since J2000.0 (negative before it), or null on invalid input, an unknown scale or an instant outside the domain
30
+ *
31
+ * @example toJ2000Seconds("2000-01-01T11:58:55.816Z") // 0 — J2000.0 itself
32
+ * @example toJ2000Seconds("2000-01-01T12:00:00Z") // 64.184
33
+ * @example toJ2000Seconds("2000-01-01T12:00:00Z", "UTC") // 0
34
+ * @example toJ2000Seconds("2026-01-01T00:00:00Z", "TAI") // 820497637
35
+ * @example toJ2000Seconds("1971-12-31T23:59:59Z") // null — before 1972
36
+ */
37
+ export declare function toJ2000Seconds(isoString: string, scale?: TimeScale): number | null;
@@ -0,0 +1,58 @@
1
+ import { NANOSECONDS_PER_DAY, NANOSECONDS_PER_SECOND } from "../../internal/foreignEpochs.js";
2
+ import { LEAP_SECOND_STEPS } from "../../internal/leapSeconds.js";
3
+ import { parseUtcReading } from "../../internal/utcReading.js";
4
+ import { J2000_EPOCH_DAY, dayPositionOf, epochDaysOfJ2000Seconds, isTimeScale, nearestDouble, readsBackInDomain } from "../../internal/julianDate.js";
5
+
6
+ // src/timescale/convert/toJ2000Seconds.ts
7
+ /**
8
+ * Convert a UTC instant to seconds since J2000.0 on a time scale. **The scale defaults to
9
+ * `"TT"`, unlike the Julian Date and MJD functions, which default to `"UTC"`**: J2000.0 is
10
+ * defined as 2000-01-01T12:00:00 TT (IAU 1994 Resolution C7).
11
+ *
12
+ * - The result is (JD on the scale − 2451545.0) × 86 400 (ERFA `ERFA_DJ00`, `ERFA_DAYSEC`).
13
+ * On `"TT"` it counts TT seconds from J2000.0 itself; on `"TAI"` and `"TCG"` it counts from
14
+ * the label `2000-01-01T12:00:00` on that scale.
15
+ * - On `"UTC"` it is the quasi-JD count (ERFA `dtf2d.c` Notes 4 and 7). On every day without a
16
+ * leap second it equals Unix seconds minus 946 728 000. On a day with one, the 86 401 s are
17
+ * scaled to fill 86 400, so, like Unix time, the difference between two UTC values is not an
18
+ * exact interval.
19
+ * - TDB is not available, so this is not the "ephemeris seconds past J2000", which count on TDB.
20
+ * - Precision: the result is the double nearest the exact count (rounded once, ties to even), so
21
+ * the error is at most half an ulp of the result. Seconds since J2000 in one double keep
22
+ * a spacing (ulp) of at most 2⁻²³ s (0.12 µs) for |seconds| < 2³⁰ (about 1966 to 2034), so a
23
+ * value is off by at most 0.06 µs (half an ulp), and a spacing of 30.5 µs at year 9999, a
24
+ * value off by at most 15 µs. Callers
25
+ * needing nanoseconds should use `toJulianDateParts`.
26
+ * - Accepts any offset or bracketed zone, and a listed leap second `…T23:59:60Z`.
27
+ * - Domain: 1972-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z UTC; `null` outside it. Within
28
+ * about 15 µs (half an ulp) of the end of 9999 (on UTC, TAI and TCG) it also returns `null`, because the
29
+ * nearest double lies past the domain and `fromJ2000Seconds` would reject it;
30
+ * `toJulianDateParts` covers the whole domain exactly.
31
+ *
32
+ * @param isoString ISO 8601 instant string
33
+ * @param scale the time scale to count on, default `"TT"`
34
+ * @returns seconds since J2000.0 (negative before it), or null on invalid input, an unknown scale or an instant outside the domain
35
+ *
36
+ * @example toJ2000Seconds("2000-01-01T11:58:55.816Z") // 0 — J2000.0 itself
37
+ * @example toJ2000Seconds("2000-01-01T12:00:00Z") // 64.184
38
+ * @example toJ2000Seconds("2000-01-01T12:00:00Z", "UTC") // 0
39
+ * @example toJ2000Seconds("2026-01-01T00:00:00Z", "TAI") // 820497637
40
+ * @example toJ2000Seconds("1971-12-31T23:59:59Z") // null — before 1972
41
+ */
42
+ function toJ2000Seconds(isoString, scale = "TT") {
43
+ try {
44
+ if (!isTimeScale(scale)) return null;
45
+ const reading = parseUtcReading(isoString);
46
+ if (reading === null) return null;
47
+ const position = dayPositionOf(LEAP_SECOND_STEPS, reading, scale);
48
+ if (position === null) return null;
49
+ const { epochDay, nanosOfDay, dayLength } = position;
50
+ const start = (epochDay - J2000_EPOCH_DAY) * NANOSECONDS_PER_DAY - NANOSECONDS_PER_DAY / 2n;
51
+ const seconds = nearestDouble(start * dayLength + nanosOfDay * NANOSECONDS_PER_DAY, dayLength * NANOSECONDS_PER_SECOND);
52
+ return readsBackInDomain(epochDaysOfJ2000Seconds(seconds), LEAP_SECOND_STEPS, scale) ? seconds : null;
53
+ } catch {
54
+ return null;
55
+ }
56
+ }
57
+
58
+ export { toJ2000Seconds };
@@ -0,0 +1,31 @@
1
+ import { TimeScale } from "../../types/time-scale.js";
2
+ /**
3
+ * Convert a UTC instant to a single Julian Date on a time scale. The scale defaults to `"UTC"`.
4
+ *
5
+ * - A single double resolves a Julian Date only to about 40 µs (2⁻³¹ day) for dates from 1972 to
6
+ * 6771, so any one value can be up to 20 µs off; after 6771, 80 µs and 40 µs. Use
7
+ * `toJulianDateParts` for nanosecond precision, or `toModifiedJulianDate`, which keeps about 64
8
+ * times more digits for dates before 2038.
9
+ * - JD days begin at noon (IAU 1997 B1 App. 2): midnight UTC is `.5`. The result is the exact
10
+ * Julian Date rounded once to the nearest double, ties to even, so it can differ by one ulp
11
+ * from `jd1 + jd2` of the parts `toJulianDateParts` writes, which rounds twice.
12
+ * - On `"UTC"` the count is ERFA's quasi-JD, the same as `toJulianDateParts`: a leap-second day
13
+ * counts as one day. On `"TAI"`, `"TT"` and `"TCG"` it is a true JD. TDB is not available.
14
+ * - Accepts any offset or bracketed zone, and a listed leap second `…T23:59:60Z`.
15
+ * - Domain: 1972-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z UTC; `null` outside it. Within
16
+ * half a double's spacing of 1972-01-01 (on TAI and TT; at most about 20 µs, measured 6.1 µs on
17
+ * TAI and 19.8 µs on TT) or of the end of 9999 (on UTC, TAI and TT; at most about 40 µs) it also
18
+ * returns `null`, because the nearest double lies outside the domain and `fromJulianDate`
19
+ * would reject it; `toJulianDateParts` covers the whole domain exactly.
20
+ *
21
+ * @param isoString ISO 8601 instant string
22
+ * @param scale the time scale to count on, default `"UTC"`
23
+ * @returns the Julian Date, or null on invalid input, an unknown scale or an instant outside the domain
24
+ *
25
+ * @example toJulianDate("2000-01-01T12:00:00Z") // 2451545
26
+ * @example toJulianDate("2000-01-01T00:00:00Z") // 2451544.5
27
+ * @example toJulianDate("2000-01-01T11:58:55.816Z", "TT") // 2451545
28
+ * @example toJulianDate("2026-01-01T12:00:00.00002Z") // 2461042 — a double there is 40.2 µs wide, so 20 µs past noon rounds back to noon
29
+ * @example toJulianDate("1971-12-31T23:59:59Z") // null — before 1972
30
+ */
31
+ export declare function toJulianDate(isoString: string, scale?: TimeScale): number | null;
@@ -0,0 +1,50 @@
1
+ import { LEAP_SECOND_STEPS } from "../../internal/leapSeconds.js";
2
+ import { parseUtcReading } from "../../internal/utcReading.js";
3
+ import { JD_OF_UNIX_EPOCH_MIDNIGHT_HALF_DAYS, dayPositionOf, epochDaysOfJulianDate, isTimeScale, nearestDouble, readsBackInDomain } from "../../internal/julianDate.js";
4
+
5
+ // src/timescale/convert/toJulianDate.ts
6
+ /**
7
+ * Convert a UTC instant to a single Julian Date on a time scale. The scale defaults to `"UTC"`.
8
+ *
9
+ * - A single double resolves a Julian Date only to about 40 µs (2⁻³¹ day) for dates from 1972 to
10
+ * 6771, so any one value can be up to 20 µs off; after 6771, 80 µs and 40 µs. Use
11
+ * `toJulianDateParts` for nanosecond precision, or `toModifiedJulianDate`, which keeps about 64
12
+ * times more digits for dates before 2038.
13
+ * - JD days begin at noon (IAU 1997 B1 App. 2): midnight UTC is `.5`. The result is the exact
14
+ * Julian Date rounded once to the nearest double, ties to even, so it can differ by one ulp
15
+ * from `jd1 + jd2` of the parts `toJulianDateParts` writes, which rounds twice.
16
+ * - On `"UTC"` the count is ERFA's quasi-JD, the same as `toJulianDateParts`: a leap-second day
17
+ * counts as one day. On `"TAI"`, `"TT"` and `"TCG"` it is a true JD. TDB is not available.
18
+ * - Accepts any offset or bracketed zone, and a listed leap second `…T23:59:60Z`.
19
+ * - Domain: 1972-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z UTC; `null` outside it. Within
20
+ * half a double's spacing of 1972-01-01 (on TAI and TT; at most about 20 µs, measured 6.1 µs on
21
+ * TAI and 19.8 µs on TT) or of the end of 9999 (on UTC, TAI and TT; at most about 40 µs) it also
22
+ * returns `null`, because the nearest double lies outside the domain and `fromJulianDate`
23
+ * would reject it; `toJulianDateParts` covers the whole domain exactly.
24
+ *
25
+ * @param isoString ISO 8601 instant string
26
+ * @param scale the time scale to count on, default `"UTC"`
27
+ * @returns the Julian Date, or null on invalid input, an unknown scale or an instant outside the domain
28
+ *
29
+ * @example toJulianDate("2000-01-01T12:00:00Z") // 2451545
30
+ * @example toJulianDate("2000-01-01T00:00:00Z") // 2451544.5
31
+ * @example toJulianDate("2000-01-01T11:58:55.816Z", "TT") // 2451545
32
+ * @example toJulianDate("2026-01-01T12:00:00.00002Z") // 2461042 — a double there is 40.2 µs wide, so 20 µs past noon rounds back to noon
33
+ * @example toJulianDate("1971-12-31T23:59:59Z") // null — before 1972
34
+ */
35
+ function toJulianDate(isoString, scale = "UTC") {
36
+ try {
37
+ if (!isTimeScale(scale)) return null;
38
+ const reading = parseUtcReading(isoString);
39
+ if (reading === null) return null;
40
+ const position = dayPositionOf(LEAP_SECOND_STEPS, reading, scale);
41
+ if (position === null) return null;
42
+ const { epochDay, nanosOfDay, dayLength } = position;
43
+ const jd = nearestDouble((2n * epochDay + JD_OF_UNIX_EPOCH_MIDNIGHT_HALF_DAYS) * dayLength + 2n * nanosOfDay, 2n * dayLength);
44
+ return readsBackInDomain(epochDaysOfJulianDate(jd), LEAP_SECOND_STEPS, scale) ? jd : null;
45
+ } catch {
46
+ return null;
47
+ }
48
+ }
49
+
50
+ export { toJulianDate };