@chronicle.app/schema 0.2.0 → 0.4.0

package/dist/datetime.d.ts

@@ -0,0 +1,10 @@
+/** Whether `value` is a full instant in UTC, such as `2024-03-02T14:05:00Z`. */
+export declare function isInstant(value: string): boolean;
+/**
+ * Whether `value` is a :DateTime string: a full instant in UTC
+ * (`2024-03-02T14:05:00Z`), or a date at year, month, or day precision that
+ * may leave trailing year digits, the month, or the day unspecified with `X`
+ * and may end in one qualifier (`?` uncertain, `~` approximate, `%` both).
+ */
+export declare function isDateTime(value: string): boolean;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/datetime.js

@@ -0,0 +1,49 @@
+// A :DateTime string is one point in time, written in a subset of EDTF
+// (ISO 8601-2). See the :DateTime comment in chronicle.ttl for the forms.
+// A year with any trailing digits unspecified: 1987, 198X, 19XX, 1XXX, XXXX.
+const YEAR = String.raw `\d{4}|\d{3}X|\d{2}XX|\dXXX|XXXX`;
+const DATE = new RegExp(String.raw `^(?<year>${YEAR})(?:-(?<month>\d{2}|XX)(?:-(?<day>\d{2}|XX))?)?(?<qualifier>[?~%])?$`);
+const INSTANT = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})T(?<hour>\d{2}):(?<minute>\d{2}):(?<second>\d{2})(?:\.\d+)?Z$/;
+const daysIn = (year, month) => new Date(Date.UTC(year, month, 0)).getUTCDate();
+const validDay = (year, month, day) => {
+    if (month === 'XX' || day === 'XX')
+        return true;
+    const days = /X/.test(year) ? daysIn(2000, Number(month)) : daysIn(Number(year), Number(month));
+    return Number(day) >= 1 && Number(day) <= days;
+};
+/** Whether `value` is a full instant in UTC, such as `2024-03-02T14:05:00Z`. */
+export function isInstant(value) {
+    const instant = INSTANT.exec(value)?.groups;
+    if (!instant)
+        return false;
+    const { year, month, day, hour, minute, second } = instant;
+    return (Number(month) >= 1 &&
+        Number(month) <= 12 &&
+        validDay(year, month, day) &&
+        Number(hour) <= 23 &&
+        Number(minute) <= 59 &&
+        Number(second) <= 59);
+}
+/**
+ * Whether `value` is a :DateTime string: a full instant in UTC
+ * (`2024-03-02T14:05:00Z`), or a date at year, month, or day precision that
+ * may leave trailing year digits, the month, or the day unspecified with `X`
+ * and may end in one qualifier (`?` uncertain, `~` approximate, `%` both).
+ */
+export function isDateTime(value) {
+    if (INSTANT.test(value))
+        return isInstant(value);
+    const date = DATE.exec(value)?.groups;
+    if (!date)
+        return false;
+    const { year, month, day } = date;
+    // An unspecified month with a known day says nothing usable; neither does
+    // a value with no known digit at all.
+    if (month === 'XX' && day !== undefined && day !== 'XX')
+        return false;
+    if (year === 'XXXX' && (month === undefined || month === 'XX'))
+        return false;
+    if (month === undefined || month === 'XX')
+        return true;
+    return (Number(month) >= 1 && Number(month) <= 12 && (day === undefined || validDay(year, month, day)));
+}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './schema.js';
+export { isDateTime, isInstant } from './datetime.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1 +1,2 @@
 export * from './schema.js';
+export { isDateTime, isInstant } from './datetime.js';