@checkdigit/time 1.0.0-PR.11-fede → 1.1.0

package/src/date-fns/milliseconds/index.ts

@@ -1,50 +0,0 @@
-import type { Duration } from '../types';
-
-// Leap year occures every 4 years, except for years that are divisable by 100 and not divisable by 400.
-// 1 mean year = (365+1/4-1/100+1/400) days = 365.2425 days
-const daysInYear = 365.2425;
-
-/**
- * @name milliseconds
- * @category Millisecond Helpers
- * @summary
- * Returns the number of milliseconds in the specified, years, months, weeks, days, hours, minutes and seconds.
- *
- * @description
- * Returns the number of milliseconds in the specified, years, months, weeks, days, hours, minutes and seconds.
- *
- * One years equals 365.2425 days according to the formula:
- *
- * > Leap year occures every 4 years, except for years that are divisable by 100 and not divisable by 400.
- * > 1 mean year = (365+1/4-1/100+1/400) days = 365.2425 days
- *
- * One month is a year divided by 12.
- *
- * @param duration - the object with years, months, weeks, days, hours, minutes and seconds to be added. Positive decimals will be rounded using `Math.floor`, decimals less than zero will be rounded using `Math.ceil`.
- * @returns the milliseconds
- *
- * @example
- * // 1 year in milliseconds
- * milliseconds({ years: 1 })
- * //=> 31556952000
- *
- * // 3 months in milliseconds
- * milliseconds({ months: 3 })
- * //=> 7889238000
- */
-export default function milliseconds({ years, months, weeks, days, hours, minutes, seconds }: Duration): number {
-  let totalDays = 0;
-
-  if (years) totalDays += years * daysInYear;
-  if (months) totalDays += months * (daysInYear / 12);
-  if (weeks) totalDays += weeks * 7;
-  if (days) totalDays += days;
-
-  let totalSeconds = totalDays * 24 * 60 * 60;
-
-  if (hours) totalSeconds += hours * 60 * 60;
-  if (minutes) totalSeconds += minutes * 60;
-  if (seconds) totalSeconds += seconds;
-
-  return Math.round(totalSeconds * 1000);
-}

package/src/date-fns/millisecondsToHours/index.ts

@@ -1,28 +0,0 @@
-import { millisecondsInHour } from '../constants/index';
-
-/**
- * @name millisecondsToHours
- * @category Conversion Helpers
- * @summary Convert milliseconds to hours.
- *
- * @description
- * Convert a number of milliseconds to a full number of hours.
- *
- * @param milliseconds - number of milliseconds to be converted
- *
- * @returns the number of milliseconds converted in hours
- *
- * @example
- * // Convert 7200000 milliseconds to hours:
- * const result = millisecondsToHours(7200000)
- * //=> 2
- *
- * @example
- * // It uses floor rounding:
- * const result = millisecondsToHours(7199999)
- * //=> 1
- */
-export default function millisecondsToHours(milliseconds: number): number {
-  const hours = milliseconds / millisecondsInHour;
-  return Math.floor(hours);
-}

package/src/date-fns/millisecondsToMinutes/index.ts

@@ -1,28 +0,0 @@
-import { millisecondsInMinute } from '../constants/index';
-
-/**
- * @name millisecondsToMinutes
- * @category Conversion Helpers
- * @summary Convert milliseconds to minutes.
- *
- * @description
- * Convert a number of milliseconds to a full number of minutes.
- *
- * @param milliseconds - number of milliseconds to be converted.
- *
- * @returns the number of milliseconds converted in minutes
- *
- * @example
- * // Convert 60000 milliseconds to minutes:
- * const result = millisecondsToMinutes(60000)
- * //=> 1
- *
- * @example
- * // It uses floor rounding:
- * const result = millisecondsToMinutes(119999)
- * //=> 1
- */
-export default function millisecondsToMinutes(milliseconds: number): number {
-  const minutes = milliseconds / millisecondsInMinute;
-  return Math.floor(minutes);
-}

package/src/date-fns/millisecondsToSeconds/index.ts

@@ -1,28 +0,0 @@
-import { millisecondsInSecond } from '../constants/index';
-
-/**
- * @name millisecondsToSeconds
- * @category Conversion Helpers
- * @summary Convert milliseconds to seconds.
- *
- * @description
- * Convert a number of milliseconds to a full number of seconds.
- *
- * @param milliseconds - number of milliseconds to be converted
- *
- * @returns the number of milliseconds converted in seconds
- *
- * @example
- * // Convert 1000 miliseconds to seconds:
- * const result = millisecondsToSeconds(1000)
- * //=> 1
- *
- * @example
- * // It uses floor rounding:
- * const result = millisecondsToSeconds(1999)
- * //=> 1
- */
-export default function millisecondsToSeconds(milliseconds: number): number {
-  const seconds = milliseconds / millisecondsInSecond;
-  return Math.floor(seconds);
-}

package/src/date-fns/min/index.ts

@@ -1,36 +0,0 @@
-import toDate from '../toDate/index';
-
-/**
- * @name min
- * @category Common Helpers
- * @summary Returns the earliest of the given dates.
- *
- * @description
- * Returns the earliest of the given dates.
- *
- * @param datesArray - the dates to compare
- * @returns - the earliest of the dates
- *
- * @example
- * // Which of these dates is the earliest?
- * const result = min([
- *   new Date(1989, 6, 10),
- *   new Date(1987, 1, 11),
- *   new Date(1995, 6, 2),
- *   new Date(1990, 0, 1)
- * ])
- * //=> Wed Feb 11 1987 00:00:00
- */
-export default function min<DateType extends Date>(datesArray: Array<DateType | number>): DateType | Date {
-  let result: Date | undefined;
-
-  datesArray.forEach(function (dirtyDate: Date | number) {
-    let currentDate = toDate(dirtyDate);
-
-    if (result === undefined || result > currentDate || isNaN(currentDate.getDate())) {
-      result = currentDate;
-    }
-  });
-
-  return result || new Date(NaN);
-}

package/src/date-fns/minutesToHours/index.ts

@@ -1,28 +0,0 @@
-import { minutesInHour } from '../constants/index';
-
-/**
- * @name minutesToHours
- * @category Conversion Helpers
- * @summary Convert minutes to hours.
- *
- * @description
- * Convert a number of minutes to a full number of hours.
- *
- * @param minutes - number of minutes to be converted
- *
- * @returns the number of minutes converted in hours
- *
- * @example
- * // Convert 140 minutes to hours:
- * const result = minutesToHours(120)
- * //=> 2
- *
- * @example
- * // It uses floor rounding:
- * const result = minutesToHours(179)
- * //=> 2
- */
-export default function minutesToHours(minutes: number): number {
-  const hours = minutes / minutesInHour;
-  return Math.floor(hours);
-}

package/src/date-fns/minutesToMilliseconds/index.ts

@@ -1,22 +0,0 @@
-import { millisecondsInMinute } from '../constants/index';
-
-/**
- * @name minutesToMilliseconds
- * @category Conversion Helpers
- * @summary Convert minutes to milliseconds.
- *
- * @description
- * Convert a number of minutes to a full number of milliseconds.
- *
- * @param minutes - number of minutes to be converted
- *
- * @returns the number of minutes converted in milliseconds
- *
- * @example
- * // Convert 2 minutes to milliseconds
- * const result = minutesToMilliseconds(2)
- * //=> 120000
- */
-export default function minutesToMilliseconds(minutes: number): number {
-  return Math.floor(minutes * millisecondsInMinute);
-}

package/src/date-fns/minutesToSeconds/index.ts

@@ -1,22 +0,0 @@
-import { secondsInMinute } from '../constants/index';
-
-/**
- * @name minutesToSeconds
- * @category Conversion Helpers
- * @summary Convert minutes to seconds.
- *
- * @description
- * Convert a number of minutes to a full number of seconds.
- *
- * @param minutes - number of minutes to be converted
- *
- * @returns the number of minutes converted in seconds
- *
- * @example
- * // Convert 2 minutes to seconds
- * const result = minutesToSeconds(2)
- * //=> 120
- */
-export default function minutesToSeconds(minutes: number): number {
-  return Math.floor(minutes * secondsInMinute);
-}

package/src/date-fns/monthsToQuarters/index.ts

@@ -1,28 +0,0 @@
-import { monthsInQuarter } from '../constants/index';
-
-/**
- * @name monthsToQuarters
- * @category Conversion Helpers
- * @summary Convert number of months to quarters.
- *
- * @description
- * Convert a number of months to a full number of quarters.
- *
- * @param months - number of months to be converted.
- *
- * @returns the number of months converted in quarters
- *
- * @example
- * // Convert 6 months to quarters:
- * const result = monthsToQuarters(6)
- * //=> 2
- *
- * @example
- * // It uses floor rounding:
- * const result = monthsToQuarters(7)
- * //=> 2
- */
-export default function monthsToQuarters(months: number): number {
-  const quarters = months / monthsInQuarter;
-  return Math.floor(quarters);
-}

package/src/date-fns/monthsToYears/index.ts

@@ -1,27 +0,0 @@
-import { monthsInYear } from '../constants/index';
-
-/**
- * @name monthsToYears
- * @category Conversion Helpers
- * @summary Convert number of months to years.
- *
- * @description
- * Convert a number of months to a full number of years.
- *
- * @param months - number of months to be converted
- *
- * @returns the number of months converted in years
- *
- * @example
- * // Convert 36 months to years:
- * const result = monthsToYears(36)
- * //=> 3
- *
- * // It uses floor rounding:
- * const result = monthsToYears(40)
- * //=> 3
- */
-export default function monthsToYears(months: number): number {
-  const years = months / monthsInYear;
-  return Math.floor(years);
-}

package/src/date-fns/nextDay/index.ts

@@ -1,32 +0,0 @@
-import addDays from '../addDays';
-import getDay from '../getDay';
-import type { Day } from '../types';
-
-/**
- * @name nextDay
- * @category Weekday Helpers
- * @summary When is the next day of the week?
- *
- * @description
- * When is the next day of the week? 0-6 the day of the week, 0 represents Sunday.
- *
- * @param date - the date to check
- * @param day - day of the week
- * @returns - the date is the next day of week
- *
- * @example
- * // When is the next Monday after Mar, 20, 2020?
- * const result = nextDay(new Date(2020, 2, 20), 1)
- * //=> Mon Mar 23 2020 00:00:00
- *
- * @example
- * // When is the next Tuesday after Mar, 21, 2020?
- * const result = nextDay(new Date(2020, 2, 21), 2)
- * //=> Tue Mar 24 2020 00:00:00
- */
-export default function nextDay<DateType extends Date>(date: DateType | number, day: Day): DateType {
-  let delta = day - getDay(date);
-  if (delta <= 0) delta += 7;
-
-  return addDays(date, delta);
-}

package/src/date-fns/nextFriday/index.ts

@@ -1,21 +0,0 @@
-import nextDay from '../nextDay/index';
-
-/**
- * @name nextFriday
- * @category Weekday Helpers
- * @summary When is the next Friday?
- *
- * @description
- * When is the next Friday?
- *
- * @param date - the date to start counting from
- * @returns the next Friday
- *
- * @example
- * // When is the next Friday after Mar, 22, 2020?
- * const result = nextFriday(new Date(2020, 2, 22))
- * //=> Fri Mar 27 2020 00:00:00
- */
-export default function nextFriday<DateType extends Date>(date: DateType | number): DateType {
-  return nextDay(date, 5);
-}

package/src/date-fns/nextMonday/index.ts

@@ -1,21 +0,0 @@
-import nextDay from '../nextDay/index';
-
-/**
- * @name nextMonday
- * @category Weekday Helpers
- * @summary When is the next Monday?
- *
- * @description
- * When is the next Monday?
- *
- * @param date - the date to start counting from
- * @returns the next Monday
- *
- * @example
- * // When is the next Monday after Mar, 22, 2020?
- * const result = nextMonday(new Date(2020, 2, 22))
- * //=> Mon Mar 23 2020 00:00:00
- */
-export default function nextMonday<DateType extends Date>(date: DateType | number): DateType {
-  return nextDay(date, 1);
-}

package/src/date-fns/nextSaturday/index.ts

@@ -1,21 +0,0 @@
-import nextDay from '../nextDay/index';
-
-/**
- * @name nextSaturday
- * @category Weekday Helpers
- * @summary When is the next Saturday?
- *
- * @description
- * When is the next Saturday?
- *
- * @param date - the date to start counting from
- * @returns the next Saturday
- *
- * @example
- * // When is the next Saturday after Mar, 22, 2020?
- * const result = nextSaturday(new Date(2020, 2, 22))
- * //=> Sat Mar 28 2020 00:00:00
- */
-export default function nextSaturday<DateType extends Date>(date: DateType | number): DateType {
-  return nextDay(date, 6);
-}

package/src/date-fns/nextSunday/index.ts

@@ -1,21 +0,0 @@
-import nextDay from '../nextDay/index';
-
-/**
- * @name nextSunday
- * @category Weekday Helpers
- * @summary When is the next Sunday?
- *
- * @description
- * When is the next Sunday?
- *
- * @param date - the date to start counting from
- * @returns the next Sunday
- *
- * @example
- * // When is the next Sunday after Mar, 22, 2020?
- * const result = nextSunday(new Date(2020, 2, 22))
- * //=> Sun Mar 29 2020 00:00:00
- */
-export default function nextSunday<DateType extends Date>(date: DateType | number): DateType {
-  return nextDay(date, 0);
-}

package/src/date-fns/nextThursday/index.ts

@@ -1,21 +0,0 @@
-import nextDay from '../nextDay/index';
-
-/**
- * @name nextThursday
- * @category Weekday Helpers
- * @summary When is the next Thursday?
- *
- * @description
- * When is the next Thursday?
- *
- * @param date - the date to start counting from
- * @returns the next Thursday
- *
- * @example
- * // When is the next Thursday after Mar, 22, 2020?
- * const result = nextThursday(new Date(2020, 2, 22))
- * //=> Thur Mar 26 2020 00:00:00
- */
-export default function nextThursday<DateType extends Date>(date: DateType | number): DateType {
-  return nextDay(date, 4);
-}

package/src/date-fns/nextTuesday/index.ts

@@ -1,21 +0,0 @@
-import nextDay from '../nextDay/index';
-
-/**
- * @name nextTuesday
- * @category Weekday Helpers
- * @summary When is the next Tuesday?
- *
- * @description
- * When is the next Tuesday?
- *
- * @param date - the date to start counting from
- * @returns the next Tuesday
- *
- * @example
- * // When is the next Tuesday after Mar, 22, 2020?
- * const result = nextTuesday(new Date(2020, 2, 22))
- * //=> Tue Mar 24 2020 00:00:00
- */
-export default function nextTuesday<DateType extends Date>(date: DateType | number): DateType {
-  return nextDay(date, 2);
-}

package/src/date-fns/nextWednesday/index.ts

@@ -1,21 +0,0 @@
-import nextDay from '../nextDay/index';
-
-/**
- * @name nextWednesday
- * @category Weekday Helpers
- * @summary When is the next Wednesday?
- *
- * @description
- * When is the next Wednesday?
- *
- * @param date - the date to start counting from
- * @returns the next Wednesday
- *
- * @example
- * // When is the next Wednesday after Mar, 22, 2020?
- * const result = nextWednesday(new Date(2020, 2, 22))
- * //=> Wed Mar 25 2020 00:00:00
- */
-export default function nextWednesday<DateType extends Date>(date: DateType | number): DateType {
-  return nextDay(date, 3);
-}

package/src/date-fns/parse/_lib/Parser.ts

@@ -1,39 +0,0 @@
-import type { Match } from '../../locale/types';
-import { ValueSetter } from './Setter';
-import type { ParseFlags, ParseResult, ParserOptions } from './types';
-
-export abstract class Parser<Value> {
-  public abstract incompatibleTokens: string[] | '*';
-  public abstract priority: number;
-  public subPriority?: number;
-
-  public run(
-    dateString: string,
-    token: string,
-    match: Match,
-    options: ParserOptions
-  ): { setter: ValueSetter<Value>; rest: string } | null {
-    const result = this.parse(dateString, token, match, options);
-    if (!result) {
-      return null;
-    }
-
-    return {
-      setter: new ValueSetter<Value>(result.value, this.validate, this.set, this.priority, this.subPriority),
-      rest: result.rest,
-    };
-  }
-
-  protected abstract parse(dateString: string, token: string, match: Match, options: ParserOptions): ParseResult<Value>;
-
-  protected validate<DateType extends Date>(_utcDate: DateType, _value: Value, _options: ParserOptions): boolean {
-    return true;
-  }
-
-  protected abstract set<DateType extends Date>(
-    date: DateType,
-    flags: ParseFlags,
-    value: Value,
-    options: ParserOptions
-  ): DateType | [DateType, ParseFlags];
-}

package/src/date-fns/parse/_lib/Setter.ts

@@ -1,63 +0,0 @@
-import transpose from '../../transpose/index';
-import constructFrom from '../../constructFrom/index';
-import type { ParseFlags, ParserOptions } from './types';
-
-const TIMEZONE_UNIT_PRIORITY = 10;
-
-export abstract class Setter {
-  public abstract priority: number;
-  public subPriority = 0;
-
-  public validate<DateType extends Date>(_utcDate: DateType, _options?: ParserOptions): boolean {
-    return true;
-  }
-
-  public abstract set<DateType extends Date>(
-    utcDate: DateType,
-    flags: ParseFlags,
-    options: ParserOptions
-  ): DateType | [DateType, ParseFlags];
-}
-
-export class ValueSetter<Value> extends Setter {
-  constructor(
-    private value: Value,
-
-    private validateValue: <DateType extends Date>(utcDate: DateType, value: Value, options: ParserOptions) => boolean,
-
-    private setValue: <DateType extends Date>(
-      utcDate: DateType,
-      flags: ParseFlags,
-      value: Value,
-      options: ParserOptions
-    ) => DateType | [DateType, ParseFlags],
-    public priority: number,
-    subPriority?: number
-  ) {
-    super();
-    if (subPriority) {
-      this.subPriority = subPriority;
-    }
-  }
-
-  override validate<DateType extends Date>(date: DateType, options: ParserOptions): boolean {
-    return this.validateValue(date, this.value, options);
-  }
-
-  set<DateType extends Date>(
-    date: DateType,
-    flags: ParseFlags,
-    options: ParserOptions
-  ): DateType | [DateType, ParseFlags] {
-    return this.setValue(date, flags, this.value, options);
-  }
-}
-
-export class DateToSystemTimezoneSetter extends Setter {
-  priority = TIMEZONE_UNIT_PRIORITY;
-  override subPriority = -1;
-  set<DateType extends Date>(date: DateType, flags: ParseFlags): DateType {
-    if (flags.timestampIsSet) return date;
-    return constructFrom(date, transpose(date, Date));
-  }
-}

package/src/date-fns/parse/_lib/constants.ts

@@ -1,31 +0,0 @@
-export const numericPatterns = {
-  month: /^(1[0-2]|0?\d)/, // 0 to 12
-  date: /^(3[0-1]|[0-2]?\d)/, // 0 to 31
-  dayOfYear: /^(36[0-6]|3[0-5]\d|[0-2]?\d?\d)/, // 0 to 366
-  week: /^(5[0-3]|[0-4]?\d)/, // 0 to 53
-  hour23h: /^(2[0-3]|[0-1]?\d)/, // 0 to 23
-  hour24h: /^(2[0-4]|[0-1]?\d)/, // 0 to 24
-  hour11h: /^(1[0-1]|0?\d)/, // 0 to 11
-  hour12h: /^(1[0-2]|0?\d)/, // 0 to 12
-  minute: /^[0-5]?\d/, // 0 to 59
-  second: /^[0-5]?\d/, // 0 to 59
-
-  singleDigit: /^\d/, // 0 to 9
-  twoDigits: /^\d{1,2}/, // 0 to 99
-  threeDigits: /^\d{1,3}/, // 0 to 999
-  fourDigits: /^\d{1,4}/, // 0 to 9999
-
-  anyDigitsSigned: /^-?\d+/,
-  singleDigitSigned: /^-?\d/, // 0 to 9, -0 to -9
-  twoDigitsSigned: /^-?\d{1,2}/, // 0 to 99, -0 to -99
-  threeDigitsSigned: /^-?\d{1,3}/, // 0 to 999, -0 to -999
-  fourDigitsSigned: /^-?\d{1,4}/, // 0 to 9999, -0 to -9999
-};
-
-export const timezonePatterns = {
-  basicOptionalMinutes: /^([+-])(\d{2})(\d{2})?|Z/,
-  basic: /^([+-])(\d{2})(\d{2})|Z/,
-  basicOptionalSeconds: /^([+-])(\d{2})(\d{2})((\d{2}))?|Z/,
-  extended: /^([+-])(\d{2}):(\d{2})|Z/,
-  extendedOptionalSeconds: /^([+-])(\d{2}):(\d{2})(:(\d{2}))?|Z/,
-};