@thi.ng/date 2.5.4 → 2.5.6

package/round.js

@@ -1,135 +1,88 @@
 import { DAY, HOUR, MINUTE, SECOND, WEEK } from "./api.js";
 import { ensureDate } from "./checks.js";
-/**
- * Rounds down `epoch` to minute precision.
- *
- * @param epoch -
- */
-export const floorSecond = (epoch) => {
-    const d = ensureDate(epoch);
-    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds());
+const floorSecond = (epoch) => {
+  const d = ensureDate(epoch);
+  return Date.UTC(
+    d.getUTCFullYear(),
+    d.getUTCMonth(),
+    d.getUTCDate(),
+    d.getUTCHours(),
+    d.getUTCMinutes(),
+    d.getUTCSeconds()
+  );
 };
-/**
- * Rounds down `epoch` to minute precision.
- *
- * @param epoch -
- */
-export const floorMinute = (epoch) => {
-    const d = ensureDate(epoch);
-    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), d.getUTCHours(), d.getUTCMinutes());
+const floorMinute = (epoch) => {
+  const d = ensureDate(epoch);
+  return Date.UTC(
+    d.getUTCFullYear(),
+    d.getUTCMonth(),
+    d.getUTCDate(),
+    d.getUTCHours(),
+    d.getUTCMinutes()
+  );
 };
-/**
- * Rounds down `epoch` to hour precision.
- *
- * @param epoch -
- */
-export const floorHour = (epoch) => {
-    const d = ensureDate(epoch);
-    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate(), d.getUTCHours());
+const floorHour = (epoch) => {
+  const d = ensureDate(epoch);
+  return Date.UTC(
+    d.getUTCFullYear(),
+    d.getUTCMonth(),
+    d.getUTCDate(),
+    d.getUTCHours()
+  );
 };
-/**
- * Rounds down `epoch` to day precision
- *
- * @param epoch -
- */
-export const floorDay = (epoch) => {
-    const d = ensureDate(epoch);
-    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+const floorDay = (epoch) => {
+  const d = ensureDate(epoch);
+  return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
 };
-/**
- * Rounds down `epoch` to week precision. Assumes ISO8601 week logic, i.e. weeks
- * start on Monday.
- *
- * @param epoch -
- */
-export const floorWeek = (epoch) => {
-    const d = ensureDate(epoch);
-    const w = d.getUTCDay();
-    return (Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()) -
-        ((w || 7) - 1) * DAY);
+const floorWeek = (epoch) => {
+  const d = ensureDate(epoch);
+  const w = d.getUTCDay();
+  return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()) - ((w || 7) - 1) * DAY;
 };
-/**
- * Rounds down `epoch` to month precision.
- *
- * @param epoch -
- */
-export const floorMonth = (epoch) => {
-    const d = ensureDate(epoch);
-    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth());
+const floorMonth = (epoch) => {
+  const d = ensureDate(epoch);
+  return Date.UTC(d.getUTCFullYear(), d.getUTCMonth());
 };
-/**
- * Rounds down `epoch` to month precision, but at beginning of a quarter.
- *
- * @param epoch -
- */
-export const floorQuarter = (epoch) => {
-    const d = ensureDate(epoch);
-    return Date.UTC(d.getUTCFullYear(), ((d.getUTCMonth() / 3) | 0) * 3);
+const floorQuarter = (epoch) => {
+  const d = ensureDate(epoch);
+  return Date.UTC(d.getUTCFullYear(), (d.getUTCMonth() / 3 | 0) * 3);
 };
-/**
- * Rounds down `epoch` to year precision.
- *
- * @param epoch -
- */
-export const floorYear = (epoch) => Date.UTC(ensureDate(epoch).getUTCFullYear(), 0);
-/**
- * Rounds up `epoch` to minute precision.
- *
- * @param epoch -
- */
-export const ceilSecond = (epoch) => floorSecond(ensureDate(epoch).getTime() + SECOND);
-/**
- * Rounds up `epoch` to minute precision.
- *
- * @param epoch -
- */
-export const ceilMinute = (epoch) => floorMinute(ensureDate(epoch).getTime() + MINUTE);
-/**
- * Rounds up `epoch` to hour precision.
- *
- * @param epoch -
- */
-export const ceilHour = (epoch) => floorHour(ensureDate(epoch).getTime() + HOUR);
-/**
- * Rounds up `epoch` to day precision
- *
- * @param epoch -
- */
-export const ceilDay = (epoch) => floorDay(ensureDate(epoch).getTime() + DAY);
-/**
- * Rounds up `epoch` to week precision. Assumes ISO8601 week logic, i.e. weeks
- * start on Monday.
- *
- * @param epoch -
- */
-export const ceilWeek = (epoch) => floorWeek(ensureDate(epoch).getTime() + WEEK);
-/**
- * Rounds up `epoch` to month precision
- *
- * @param epoch -
- */
-export const ceilMonth = (epoch) => {
-    const d = ensureDate(epoch);
-    let y = d.getUTCFullYear();
-    let m = d.getUTCMonth() + 1;
-    m > 11 && y++;
-    return Date.UTC(y, m % 12);
+const floorYear = (epoch) => Date.UTC(ensureDate(epoch).getUTCFullYear(), 0);
+const ceilSecond = (epoch) => floorSecond(ensureDate(epoch).getTime() + SECOND);
+const ceilMinute = (epoch) => floorMinute(ensureDate(epoch).getTime() + MINUTE);
+const ceilHour = (epoch) => floorHour(ensureDate(epoch).getTime() + HOUR);
+const ceilDay = (epoch) => floorDay(ensureDate(epoch).getTime() + DAY);
+const ceilWeek = (epoch) => floorWeek(ensureDate(epoch).getTime() + WEEK);
+const ceilMonth = (epoch) => {
+  const d = ensureDate(epoch);
+  let y = d.getUTCFullYear();
+  let m = d.getUTCMonth() + 1;
+  m > 11 && y++;
+  return Date.UTC(y, m % 12);
 };
-/**
- * Rounds up `epoch` to month precision (beginning of next quarter)
- *
- * @param epoch -
- */
-export const ceilQuarter = (epoch) => {
-    const d = ensureDate(epoch);
-    let y = d.getUTCFullYear();
-    let m = (((d.getUTCMonth() + 3) / 3) | 0) * 3;
-    m > 11 && y++;
-    return Date.UTC(y, m % 12);
+const ceilQuarter = (epoch) => {
+  const d = ensureDate(epoch);
+  let y = d.getUTCFullYear();
+  let m = ((d.getUTCMonth() + 3) / 3 | 0) * 3;
+  m > 11 && y++;
+  return Date.UTC(y, m % 12);
+};
+const ceilYear = (epoch) => Date.UTC(ensureDate(epoch).getUTCFullYear() + 1, 0);
+export {
+  ceilDay,
+  ceilHour,
+  ceilMinute,
+  ceilMonth,
+  ceilQuarter,
+  ceilSecond,
+  ceilWeek,
+  ceilYear,
+  floorDay,
+  floorHour,
+  floorMinute,
+  floorMonth,
+  floorQuarter,
+  floorSecond,
+  floorWeek,
+  floorYear
 };
-/**
- * Rounds up `epoch` to year precision
- *
- * @param epoch -
- */
-export const ceilYear = (epoch) => Date.UTC(ensureDate(epoch).getUTCFullYear() + 1, 0);

package/timecode.js

@@ -1,46 +1,22 @@
 import { Z2 } from "@thi.ng/strings/pad-left";
 import { decomposeDuration } from "./duration.js";
-/**
- * Returns a time formatter for given FPS (frames / second, in [1..1000] range),
- * e.g. `HH:mm:ss:ff`. The returned function takes a single arg (time in
- * milliseconds) and returns formatted string.
- *
- * @remarks
- * The timecode considers days too, but only includes them in the result if the
- * day part is non-zero. The 4 separators between each field can be customized
- * via 2nd arg (default: all `:`).
- *
- * @example
- * ```ts
- * a = defTimecode(30);
- * a(HOUR + 2*MINUTE + 3*SECOND + 4*1000/30)
- * // "01:02:03:04"
- *
- * a(DAY);
- * // "01:00:00:00:00"
- *
- * b = defTimecode(30, ["d ", "h ", "' ", '" ']);
- * b(Day + HOUR + 2*MINUTE + 3*SECOND + 999)
- * // "01d 01h 02' 03" 29"
- * ```
- *
- * @param fps -
- * @param sep -
- */
-export const defTimecode = (fps, sep = "::::") => {
-    const frame = 1000 / fps;
-    return (t) => {
-        const [_, __, d, h, m, s, ms] = decomposeDuration(t);
-        const parts = [
-            Z2(h),
-            sep[1],
-            Z2(m),
-            sep[2],
-            Z2(s),
-            sep[3],
-            Z2((ms / frame) | 0),
-        ];
-        d > 0 && parts.unshift(Z2(d), sep[0]);
-        return parts.join("");
-    };
+const defTimecode = (fps, sep = "::::") => {
+  const frame = 1e3 / fps;
+  return (t) => {
+    const [_, __, d, h, m, s, ms] = decomposeDuration(t);
+    const parts = [
+      Z2(h),
+      sep[1],
+      Z2(m),
+      sep[2],
+      Z2(s),
+      sep[3],
+      Z2(ms / frame | 0)
+    ];
+    d > 0 && parts.unshift(Z2(d), sep[0]);
+    return parts.join("");
+  };
+};
+export {
+  defTimecode
 };

package/units.js

@@ -1,20 +1,25 @@
 import { DAYS_IN_MONTH, DAYS_IN_MONTH_OFFSET } from "./api.js";
 import { isLeapYear } from "./checks.js";
-export const daysInMonth = (year, month) => {
-    const days = DAYS_IN_MONTH[month];
-    return days + ~~(month === 1 && isLeapYear(year));
+const daysInMonth = (year, month) => {
+  const days = DAYS_IN_MONTH[month];
+  return days + ~~(month === 1 && isLeapYear(year));
 };
-export const dayInYear = (y, m, d) => DAYS_IN_MONTH_OFFSET[m] + d + ~~(m > 1 && isLeapYear(y));
-export const weekInYear = (y, m, d) => {
-    const start = new Date(Date.UTC(y, 0, 1)).getDay() || 7;
-    if (!m) {
-        if (start === 5 && d < 4)
-            return 53;
-        if (start === 6 && d < 3)
-            return 52 + ~~isLeapYear(y - 1);
-        if (start === 7 && d < 2)
-            return 52;
-    }
-    const offset = (start < 5 ? 8 : 15) - start;
-    return Math.ceil((dayInYear(y, m, d) - offset) / 7 + 1);
+const dayInYear = (y, m, d) => DAYS_IN_MONTH_OFFSET[m] + d + ~~(m > 1 && isLeapYear(y));
+const weekInYear = (y, m, d) => {
+  const start = new Date(Date.UTC(y, 0, 1)).getDay() || 7;
+  if (!m) {
+    if (start === 5 && d < 4)
+      return 53;
+    if (start === 6 && d < 3)
+      return 52 + ~~isLeapYear(y - 1);
+    if (start === 7 && d < 2)
+      return 52;
+  }
+  const offset = (start < 5 ? 8 : 15) - start;
+  return Math.ceil((dayInYear(y, m, d) - offset) / 7 + 1);
+};
+export {
+  dayInYear,
+  daysInMonth,
+  weekInYear
 };