@prairielearn/formatter 1.0.1 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @prairielearn/formatter
 
+## 1.2.0
+
+### Minor Changes
+
+- d3336c2: Add `formatInterval` function
+
+## 1.1.0
+
+### Minor Changes
+
+- 03a363f: Add functions `formatDateYMD` and `formatDateYMDHM`
+
 ## 1.0.1
 
 ### Patch Changes

package/dist/date.d.ts

@@ -11,3 +11,19 @@ export declare function formatDate(date: Date, timeZone: string, { includeTz, lo
     includeTz?: boolean;
     longTz?: boolean;
 }): string;
+/**
+ * Format a date to a human-readable string like '2020-03-27'.
+ *
+ * @param date The date to format.
+ * @param timeZone The time zone to use for formatting.
+ * @returns Human-readable string representing the date.
+ */
+export declare function formatDateYMD(date: Date, timeZone: string): string;
+/**
+ * Format a date to a human-readable string like '2020-03-27 14:27'.
+ *
+ * @param date The date to format.
+ * @param timeZone The time zone to use for formatting.
+ * @returns Human-readable string representing the date.
+ */
+export declare function formatDateYMDHM(date: Date, timeZone: string): string;

package/dist/date.js

@@ -27,4 +27,42 @@ export function formatDate(date, timeZone, { includeTz = true, longTz = false }
     }
     return dateFormatted;
 }
+/**
+ * Format a date to a human-readable string like '2020-03-27'.
+ *
+ * @param date The date to format.
+ * @param timeZone The time zone to use for formatting.
+ * @returns Human-readable string representing the date.
+ */
+export function formatDateYMD(date, timeZone) {
+    const options = {
+        timeZone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    };
+    const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);
+    return `${parts.year.value}-${parts.month.value}-${parts.day.value}`;
+}
+/**
+ * Format a date to a human-readable string like '2020-03-27 14:27'.
+ *
+ * @param date The date to format.
+ * @param timeZone The time zone to use for formatting.
+ * @returns Human-readable string representing the date.
+ */
+export function formatDateYMDHM(date, timeZone) {
+    const options = {
+        timeZone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+    };
+    const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);
+    return `${parts.year.value}-${parts.month.value}-${parts.day.value} ${parts.hour.value}:${parts.minute.value}`;
+}
 //# sourceMappingURL=date.js.map

package/dist/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,iBAAiB,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,IAAU,EACV,QAAgB,EAChB,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,GAAG,KAAK,KAAgD,EAAE;IAEpF,MAAM,OAAO,GAA+B;QAC1C,QAAQ;QACR,SAAS,EAAE,KAAK;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;KACxC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClG,IAAI,aAAa,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAClJ,IAAI,SAAS,EAAE,CAAC;QACd,aAAa,GAAG,GAAG,aAAa,KAAK,KAAK,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC;IACnE,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["import keyBy from 'lodash/keyBy.js';\n\n/**\n * Format a date to a human-readable string like '2020-03-27T12:34:56 (CDT)'.\n *\n * @param date The date to format.\n * @param timeZone The time zone to use for formatting.\n * @param param2.includeTz Whether to include the time zone in the output (default true).\n * @param param2.longTz Whether to use the long time zone name (default false).\n * @returns Human-readable string representing the date.\n */\nexport function formatDate(\n  date: Date,\n  timeZone: string,\n  { includeTz = true, longTz = false }: { includeTz?: boolean; longTz?: boolean } = {},\n): string {\n  const options: Intl.DateTimeFormatOptions = {\n    timeZone,\n    hourCycle: 'h23',\n    year: 'numeric',\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n    second: '2-digit',\n    timeZoneName: longTz ? 'long' : 'short',\n  };\n  const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);\n  let dateFormatted = `${parts.year.value}-${parts.month.value}-${parts.day.value} ${parts.hour.value}:${parts.minute.value}:${parts.second.value}`;\n  if (includeTz) {\n    dateFormatted = `${dateFormatted} (${parts.timeZoneName.value})`;\n  }\n  return dateFormatted;\n}\n"]}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,iBAAiB,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,IAAU,EACV,QAAgB,EAChB,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,GAAG,KAAK,KAAgD,EAAE;IAEpF,MAAM,OAAO,GAA+B;QAC1C,QAAQ;QACR,SAAS,EAAE,KAAK;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;KACxC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClG,IAAI,aAAa,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAClJ,IAAI,SAAS,EAAE,CAAC;QACd,aAAa,GAAG,GAAG,aAAa,KAAK,KAAK,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC;IACnE,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,QAAgB;IACxD,MAAM,OAAO,GAA+B;QAC1C,QAAQ;QACR,SAAS,EAAE,KAAK;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;KACf,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClG,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,QAAgB;IAC1D,MAAM,OAAO,GAA+B;QAC1C,QAAQ;QACR,SAAS,EAAE,KAAK;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClG,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;AACjH,CAAC","sourcesContent":["import keyBy from 'lodash/keyBy.js';\n\n/**\n * Format a date to a human-readable string like '2020-03-27T12:34:56 (CDT)'.\n *\n * @param date The date to format.\n * @param timeZone The time zone to use for formatting.\n * @param param2.includeTz Whether to include the time zone in the output (default true).\n * @param param2.longTz Whether to use the long time zone name (default false).\n * @returns Human-readable string representing the date.\n */\nexport function formatDate(\n  date: Date,\n  timeZone: string,\n  { includeTz = true, longTz = false }: { includeTz?: boolean; longTz?: boolean } = {},\n): string {\n  const options: Intl.DateTimeFormatOptions = {\n    timeZone,\n    hourCycle: 'h23',\n    year: 'numeric',\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n    second: '2-digit',\n    timeZoneName: longTz ? 'long' : 'short',\n  };\n  const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);\n  let dateFormatted = `${parts.year.value}-${parts.month.value}-${parts.day.value} ${parts.hour.value}:${parts.minute.value}:${parts.second.value}`;\n  if (includeTz) {\n    dateFormatted = `${dateFormatted} (${parts.timeZoneName.value})`;\n  }\n  return dateFormatted;\n}\n\n/**\n * Format a date to a human-readable string like '2020-03-27'.\n *\n * @param date The date to format.\n * @param timeZone The time zone to use for formatting.\n * @returns Human-readable string representing the date.\n */\nexport function formatDateYMD(date: Date, timeZone: string): string {\n  const options: Intl.DateTimeFormatOptions = {\n    timeZone,\n    hourCycle: 'h23',\n    year: 'numeric',\n    month: '2-digit',\n    day: '2-digit',\n  };\n  const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);\n  return `${parts.year.value}-${parts.month.value}-${parts.day.value}`;\n}\n\n/**\n * Format a date to a human-readable string like '2020-03-27 14:27'.\n *\n * @param date The date to format.\n * @param timeZone The time zone to use for formatting.\n * @returns Human-readable string representing the date.\n */\nexport function formatDateYMDHM(date: Date, timeZone: string): string {\n  const options: Intl.DateTimeFormatOptions = {\n    timeZone,\n    hourCycle: 'h23',\n    year: 'numeric',\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n  };\n  const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);\n  return `${parts.year.value}-${parts.month.value}-${parts.day.value} ${parts.hour.value}:${parts.minute.value}`;\n}\n"]}

package/dist/date.test.js

@@ -1,5 +1,5 @@
 import { assert } from 'chai';
-import { formatDate } from './date.js';
+import { formatDate, formatDateYMD, formatDateYMDHM } from './date.js';
 describe('date formatting', () => {
     describe('formatDate', () => {
         it('formats a UTC date', () => {
@@ -27,5 +27,41 @@ describe('date formatting', () => {
             assert.equal(formatDate(date, 'America/Chicago', { longTz: true }), '2018-01-01 06:00:00 (Central Standard Time)');
         });
     });
+    describe('formatDateYMD()', () => {
+        it('should handle a UTC date', () => {
+            const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));
+            assert.equal(formatDateYMD(date, 'UTC'), '2018-01-01');
+        });
+        it('should handle a CST date', () => {
+            const date = new Date(Date.UTC(2018, 0, 3, 5, 0, 0));
+            assert.equal(formatDateYMD(date, 'America/Chicago'), '2018-01-02');
+        });
+        it('should handle a CDT date', () => {
+            const date = new Date(Date.UTC(2018, 6, 1, 12, 0, 0));
+            assert.equal(formatDateYMD(date, 'America/Chicago'), '2018-07-01');
+        });
+        it('should correctly format dates with zero hours', () => {
+            const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));
+            assert.equal(formatDateYMD(date, 'UTC'), '2018-01-01');
+        });
+    });
+    describe('formatDateYMDHM()', () => {
+        it('should handle a UTC date', () => {
+            const date = new Date(Date.UTC(2018, 0, 1, 12, 34, 7));
+            assert.equal(formatDateYMDHM(date, 'UTC'), '2018-01-01 12:34');
+        });
+        it('should handle a CST date', () => {
+            const date = new Date(Date.UTC(2018, 0, 3, 5, 10, 50));
+            assert.equal(formatDateYMDHM(date, 'America/Chicago'), '2018-01-02 23:10');
+        });
+        it('should handle a CDT date', () => {
+            const date = new Date(Date.UTC(2018, 6, 1, 19, 8, 19));
+            assert.equal(formatDateYMDHM(date, 'America/Chicago'), '2018-07-01 14:08');
+        });
+        it('should correctly format dates with zero hours', () => {
+            const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));
+            assert.equal(formatDateYMDHM(date, 'UTC'), '2018-01-01 00:01');
+        });
+    });
 });
 //# sourceMappingURL=date.test.js.map

package/dist/date.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.test.js","sourceRoot":"","sources":["../src/date.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,2BAA2B,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,2BAA2B,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CACV,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EACrD,6CAA6C,CAC9C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { assert } from 'chai';\n\nimport { formatDate } from './date.js';\n\ndescribe('date formatting', () => {\n  describe('formatDate', () => {\n    it('formats a UTC date', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'UTC'), '2018-01-01 12:00:00 (UTC)');\n    });\n    it('formats a CST date', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'America/Chicago'), '2018-01-01 06:00:00 (CST)');\n    });\n    it('formats a CDT date', () => {\n      const date = new Date(Date.UTC(2018, 6, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'America/Chicago'), '2018-07-01 07:00:00 (CDT)');\n    });\n    it('formats dates with zero hours', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));\n      assert.equal(formatDate(date, 'UTC'), '2018-01-01 00:01:00 (UTC)');\n    });\n    it('formats dates without the timezone', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'UTC', { includeTz: false }), '2018-01-01 12:00:00');\n    });\n    it('formats dates with the long timezone name', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(\n        formatDate(date, 'America/Chicago', { longTz: true }),\n        '2018-01-01 06:00:00 (Central Standard Time)',\n      );\n    });\n  });\n});\n"]}
+{"version":3,"file":"date.test.js","sourceRoot":"","sources":["../src/date.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { assert } from 'chai';\n\nimport { formatDate, formatDateYMD, formatDateYMDHM } from './date.js';\n\ndescribe('date formatting', () => {\n  describe('formatDate', () => {\n    it('formats a UTC date', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'UTC'), '2018-01-01 12:00:00 (UTC)');\n    });\n    it('formats a CST date', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'America/Chicago'), '2018-01-01 06:00:00 (CST)');\n    });\n    it('formats a CDT date', () => {\n      const date = new Date(Date.UTC(2018, 6, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'America/Chicago'), '2018-07-01 07:00:00 (CDT)');\n    });\n    it('formats dates with zero hours', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));\n      assert.equal(formatDate(date, 'UTC'), '2018-01-01 00:01:00 (UTC)');\n    });\n    it('formats dates without the timezone', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(formatDate(date, 'UTC', { includeTz: false }), '2018-01-01 12:00:00');\n    });\n    it('formats dates with the long timezone name', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(\n        formatDate(date, 'America/Chicago', { longTz: true }),\n        '2018-01-01 06:00:00 (Central Standard Time)',\n      );\n    });\n  });\n\n  describe('formatDateYMD()', () => {\n    it('should handle a UTC date', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));\n      assert.equal(formatDateYMD(date, 'UTC'), '2018-01-01');\n    });\n    it('should handle a CST date', () => {\n      const date = new Date(Date.UTC(2018, 0, 3, 5, 0, 0));\n      assert.equal(formatDateYMD(date, 'America/Chicago'), '2018-01-02');\n    });\n    it('should handle a CDT date', () => {\n      const date = new Date(Date.UTC(2018, 6, 1, 12, 0, 0));\n      assert.equal(formatDateYMD(date, 'America/Chicago'), '2018-07-01');\n    });\n    it('should correctly format dates with zero hours', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));\n      assert.equal(formatDateYMD(date, 'UTC'), '2018-01-01');\n    });\n  });\n\n  describe('formatDateYMDHM()', () => {\n    it('should handle a UTC date', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 12, 34, 7));\n      assert.equal(formatDateYMDHM(date, 'UTC'), '2018-01-01 12:34');\n    });\n    it('should handle a CST date', () => {\n      const date = new Date(Date.UTC(2018, 0, 3, 5, 10, 50));\n      assert.equal(formatDateYMDHM(date, 'America/Chicago'), '2018-01-02 23:10');\n    });\n    it('should handle a CDT date', () => {\n      const date = new Date(Date.UTC(2018, 6, 1, 19, 8, 19));\n      assert.equal(formatDateYMDHM(date, 'America/Chicago'), '2018-07-01 14:08');\n    });\n    it('should correctly format dates with zero hours', () => {\n      const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));\n      assert.equal(formatDateYMDHM(date, 'UTC'), '2018-01-01 00:01');\n    });\n  });\n});\n"]}

package/dist/index.d.ts

@@ -1 +1,2 @@
-export { formatDate } from './date.js';
+export { formatDate, formatDateYMD, formatDateYMDHM } from './date.js';
+export { formatInterval } from './interval.js';

package/dist/index.js

@@ -1,2 +1,3 @@
-export { formatDate } from './date.js';
+export { formatDate, formatDateYMD, formatDateYMDHM } from './date.js';
+export { formatInterval } from './interval.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC","sourcesContent":["export { formatDate } from './date.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export { formatDate, formatDateYMD, formatDateYMDHM } from './date.js';\nexport { formatInterval } from './interval.js';\n"]}

package/dist/interval.d.ts

@@ -0,0 +1,11 @@
+export declare const SECOND_IN_MILLISECONDS = 1000;
+export declare const MINUTE_IN_MILLISECONDS: number;
+export declare const HOUR_IN_MILLISECONDS: number;
+export declare const DAY_IN_MILLISECONDS: number;
+/**
+ * Format an interval (in milliseconds) to a human-readable string like '3 h 40 m'.
+ *
+ * @param interval Time interval in milliseconds.
+ * @returns Human-readable string representing the interval.
+ */
+export declare function formatInterval(interval: number): string;

package/dist/interval.js

@@ -0,0 +1,35 @@
+export const SECOND_IN_MILLISECONDS = 1000;
+export const MINUTE_IN_MILLISECONDS = 60 * SECOND_IN_MILLISECONDS;
+export const HOUR_IN_MILLISECONDS = 60 * MINUTE_IN_MILLISECONDS;
+export const DAY_IN_MILLISECONDS = 24 * HOUR_IN_MILLISECONDS;
+/**
+ * Format an interval (in milliseconds) to a human-readable string like '3 h 40 m'.
+ *
+ * @param interval Time interval in milliseconds.
+ * @returns Human-readable string representing the interval.
+ */
+export function formatInterval(interval) {
+    const sign = interval < 0 ? '-' : '';
+    const days = Math.floor(Math.abs(interval) / DAY_IN_MILLISECONDS);
+    const hours = Math.floor(Math.abs(interval) / HOUR_IN_MILLISECONDS) % 24;
+    const mins = Math.floor(Math.abs(interval) / MINUTE_IN_MILLISECONDS) % 60;
+    const secs = Math.floor(Math.abs(interval) / SECOND_IN_MILLISECONDS) % 60;
+    const parts = [];
+    if (days > 0) {
+        parts.push(`${sign}${days} d`);
+    }
+    if (hours > 0) {
+        parts.push(`${sign}${hours} h`);
+    }
+    if (mins > 0) {
+        parts.push(`${sign}${mins} min`);
+    }
+    if (secs > 0) {
+        parts.push(`${sign}${secs} s`);
+    }
+    if (parts.length === 0) {
+        parts.push('0 s');
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=interval.js.map

package/dist/interval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interval.js","sourceRoot":"","sources":["../src/interval.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,sBAAsB,CAAC;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,sBAAsB,CAAC;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,oBAAoB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAErC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,mBAAmB,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC,GAAG,EAAE,CAAC;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,sBAAsB,CAAC,GAAG,EAAE,CAAC;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,sBAAsB,CAAC,GAAG,EAAE,CAAC;IAE1E,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC","sourcesContent":["export const SECOND_IN_MILLISECONDS = 1000;\nexport const MINUTE_IN_MILLISECONDS = 60 * SECOND_IN_MILLISECONDS;\nexport const HOUR_IN_MILLISECONDS = 60 * MINUTE_IN_MILLISECONDS;\nexport const DAY_IN_MILLISECONDS = 24 * HOUR_IN_MILLISECONDS;\n\n/**\n * Format an interval (in milliseconds) to a human-readable string like '3 h 40 m'.\n *\n * @param interval Time interval in milliseconds.\n * @returns Human-readable string representing the interval.\n */\nexport function formatInterval(interval: number): string {\n  const sign = interval < 0 ? '-' : '';\n\n  const days = Math.floor(Math.abs(interval) / DAY_IN_MILLISECONDS);\n  const hours = Math.floor(Math.abs(interval) / HOUR_IN_MILLISECONDS) % 24;\n  const mins = Math.floor(Math.abs(interval) / MINUTE_IN_MILLISECONDS) % 60;\n  const secs = Math.floor(Math.abs(interval) / SECOND_IN_MILLISECONDS) % 60;\n\n  const parts: string[] = [];\n\n  if (days > 0) {\n    parts.push(`${sign}${days} d`);\n  }\n  if (hours > 0) {\n    parts.push(`${sign}${hours} h`);\n  }\n  if (mins > 0) {\n    parts.push(`${sign}${mins} min`);\n  }\n  if (secs > 0) {\n    parts.push(`${sign}${secs} s`);\n  }\n  if (parts.length === 0) {\n    parts.push('0 s');\n  }\n\n  return parts.join(' ');\n}\n"]}

package/dist/interval.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/interval.test.js

@@ -0,0 +1,31 @@
+import { assert } from 'chai';
+import { formatInterval } from './interval.js';
+describe('interval formatting', () => {
+    describe('formatInterval()', () => {
+        it('should handle seconds', () => {
+            assert.equal(formatInterval(7000), '7 s');
+        });
+        it('should handle fractional seconds', () => {
+            assert.equal(formatInterval(7321), '7 s');
+        });
+        it('should handle minutes', () => {
+            assert.equal(formatInterval(2 * 60 * 1000), '2 min');
+        });
+        it('should handle hours', () => {
+            assert.equal(formatInterval(3 * 60 * 60 * 1000), '3 h');
+        });
+        it('should handle hours', () => {
+            assert.equal(formatInterval(4 * 24 * 60 * 60 * 1000), '4 d');
+        });
+        it('should handle complex intervals', () => {
+            assert.equal(formatInterval((((4 * 24 + 3) * 60 + 2) * 60 + 7) * 1000), '4 d 3 h 2 min 7 s');
+        });
+        it('should handle zero', () => {
+            assert.equal(formatInterval(0), '0 s');
+        });
+        it('should handle negative intervals', () => {
+            assert.equal(formatInterval(-(((4 * 24 + 3) * 60 + 2) * 60 + 7) * 1000), '-4 d -3 h -2 min -7 s');
+        });
+    });
+});
+//# sourceMappingURL=interval.test.js.map

package/dist/interval.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interval.test.js","sourceRoot":"","sources":["../src/interval.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,mBAAmB,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,KAAK,CACV,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAC1D,uBAAuB,CACxB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { assert } from 'chai';\n\nimport { formatInterval } from './interval.js';\n\ndescribe('interval formatting', () => {\n  describe('formatInterval()', () => {\n    it('should handle seconds', () => {\n      assert.equal(formatInterval(7000), '7 s');\n    });\n    it('should handle fractional seconds', () => {\n      assert.equal(formatInterval(7321), '7 s');\n    });\n    it('should handle minutes', () => {\n      assert.equal(formatInterval(2 * 60 * 1000), '2 min');\n    });\n    it('should handle hours', () => {\n      assert.equal(formatInterval(3 * 60 * 60 * 1000), '3 h');\n    });\n    it('should handle hours', () => {\n      assert.equal(formatInterval(4 * 24 * 60 * 60 * 1000), '4 d');\n    });\n    it('should handle complex intervals', () => {\n      assert.equal(formatInterval((((4 * 24 + 3) * 60 + 2) * 60 + 7) * 1000), '4 d 3 h 2 min 7 s');\n    });\n    it('should handle zero', () => {\n      assert.equal(formatInterval(0), '0 s');\n    });\n    it('should handle negative intervals', () => {\n      assert.equal(\n        formatInterval(-(((4 * 24 + 3) * 60 + 2) * 60 + 7) * 1000),\n        '-4 d -3 h -2 min -7 s',\n      );\n    });\n  });\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prairielearn/formatter",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "type": "module",
   "main": "dist/index.js",
   "repository": {

package/src/date.test.ts

@@ -1,6 +1,6 @@
 import { assert } from 'chai';
 
-import { formatDate } from './date.js';
+import { formatDate, formatDateYMD, formatDateYMDHM } from './date.js';
 
 describe('date formatting', () => {
   describe('formatDate', () => {
@@ -32,4 +32,42 @@ describe('date formatting', () => {
       );
     });
   });
+
+  describe('formatDateYMD()', () => {
+    it('should handle a UTC date', () => {
+      const date = new Date(Date.UTC(2018, 0, 1, 12, 0, 0));
+      assert.equal(formatDateYMD(date, 'UTC'), '2018-01-01');
+    });
+    it('should handle a CST date', () => {
+      const date = new Date(Date.UTC(2018, 0, 3, 5, 0, 0));
+      assert.equal(formatDateYMD(date, 'America/Chicago'), '2018-01-02');
+    });
+    it('should handle a CDT date', () => {
+      const date = new Date(Date.UTC(2018, 6, 1, 12, 0, 0));
+      assert.equal(formatDateYMD(date, 'America/Chicago'), '2018-07-01');
+    });
+    it('should correctly format dates with zero hours', () => {
+      const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));
+      assert.equal(formatDateYMD(date, 'UTC'), '2018-01-01');
+    });
+  });
+
+  describe('formatDateYMDHM()', () => {
+    it('should handle a UTC date', () => {
+      const date = new Date(Date.UTC(2018, 0, 1, 12, 34, 7));
+      assert.equal(formatDateYMDHM(date, 'UTC'), '2018-01-01 12:34');
+    });
+    it('should handle a CST date', () => {
+      const date = new Date(Date.UTC(2018, 0, 3, 5, 10, 50));
+      assert.equal(formatDateYMDHM(date, 'America/Chicago'), '2018-01-02 23:10');
+    });
+    it('should handle a CDT date', () => {
+      const date = new Date(Date.UTC(2018, 6, 1, 19, 8, 19));
+      assert.equal(formatDateYMDHM(date, 'America/Chicago'), '2018-07-01 14:08');
+    });
+    it('should correctly format dates with zero hours', () => {
+      const date = new Date(Date.UTC(2018, 0, 1, 0, 1, 0));
+      assert.equal(formatDateYMDHM(date, 'UTC'), '2018-01-01 00:01');
+    });
+  });
 });

package/src/date.ts

@@ -32,3 +32,43 @@ export function formatDate(
   }
   return dateFormatted;
 }
+
+/**
+ * Format a date to a human-readable string like '2020-03-27'.
+ *
+ * @param date The date to format.
+ * @param timeZone The time zone to use for formatting.
+ * @returns Human-readable string representing the date.
+ */
+export function formatDateYMD(date: Date, timeZone: string): string {
+  const options: Intl.DateTimeFormatOptions = {
+    timeZone,
+    hourCycle: 'h23',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+  };
+  const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);
+  return `${parts.year.value}-${parts.month.value}-${parts.day.value}`;
+}
+
+/**
+ * Format a date to a human-readable string like '2020-03-27 14:27'.
+ *
+ * @param date The date to format.
+ * @param timeZone The time zone to use for formatting.
+ * @returns Human-readable string representing the date.
+ */
+export function formatDateYMDHM(date: Date, timeZone: string): string {
+  const options: Intl.DateTimeFormatOptions = {
+    timeZone,
+    hourCycle: 'h23',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+  };
+  const parts = keyBy(new Intl.DateTimeFormat('en-US', options).formatToParts(date), (x) => x.type);
+  return `${parts.year.value}-${parts.month.value}-${parts.day.value} ${parts.hour.value}:${parts.minute.value}`;
+}

package/src/index.ts

@@ -1 +1,2 @@
-export { formatDate } from './date.js';
+export { formatDate, formatDateYMD, formatDateYMDHM } from './date.js';
+export { formatInterval } from './interval.js';

package/src/interval.test.ts

@@ -0,0 +1,35 @@
+import { assert } from 'chai';
+
+import { formatInterval } from './interval.js';
+
+describe('interval formatting', () => {
+  describe('formatInterval()', () => {
+    it('should handle seconds', () => {
+      assert.equal(formatInterval(7000), '7 s');
+    });
+    it('should handle fractional seconds', () => {
+      assert.equal(formatInterval(7321), '7 s');
+    });
+    it('should handle minutes', () => {
+      assert.equal(formatInterval(2 * 60 * 1000), '2 min');
+    });
+    it('should handle hours', () => {
+      assert.equal(formatInterval(3 * 60 * 60 * 1000), '3 h');
+    });
+    it('should handle hours', () => {
+      assert.equal(formatInterval(4 * 24 * 60 * 60 * 1000), '4 d');
+    });
+    it('should handle complex intervals', () => {
+      assert.equal(formatInterval((((4 * 24 + 3) * 60 + 2) * 60 + 7) * 1000), '4 d 3 h 2 min 7 s');
+    });
+    it('should handle zero', () => {
+      assert.equal(formatInterval(0), '0 s');
+    });
+    it('should handle negative intervals', () => {
+      assert.equal(
+        formatInterval(-(((4 * 24 + 3) * 60 + 2) * 60 + 7) * 1000),
+        '-4 d -3 h -2 min -7 s',
+      );
+    });
+  });
+});

package/src/interval.ts

@@ -0,0 +1,39 @@
+export const SECOND_IN_MILLISECONDS = 1000;
+export const MINUTE_IN_MILLISECONDS = 60 * SECOND_IN_MILLISECONDS;
+export const HOUR_IN_MILLISECONDS = 60 * MINUTE_IN_MILLISECONDS;
+export const DAY_IN_MILLISECONDS = 24 * HOUR_IN_MILLISECONDS;
+
+/**
+ * Format an interval (in milliseconds) to a human-readable string like '3 h 40 m'.
+ *
+ * @param interval Time interval in milliseconds.
+ * @returns Human-readable string representing the interval.
+ */
+export function formatInterval(interval: number): string {
+  const sign = interval < 0 ? '-' : '';
+
+  const days = Math.floor(Math.abs(interval) / DAY_IN_MILLISECONDS);
+  const hours = Math.floor(Math.abs(interval) / HOUR_IN_MILLISECONDS) % 24;
+  const mins = Math.floor(Math.abs(interval) / MINUTE_IN_MILLISECONDS) % 60;
+  const secs = Math.floor(Math.abs(interval) / SECOND_IN_MILLISECONDS) % 60;
+
+  const parts: string[] = [];
+
+  if (days > 0) {
+    parts.push(`${sign}${days} d`);
+  }
+  if (hours > 0) {
+    parts.push(`${sign}${hours} h`);
+  }
+  if (mins > 0) {
+    parts.push(`${sign}${mins} min`);
+  }
+  if (secs > 0) {
+    parts.push(`${sign}${secs} s`);
+  }
+  if (parts.length === 0) {
+    parts.push('0 s');
+  }
+
+  return parts.join(' ');
+}