Futils

simple javascript utility

List Of Utility

| Utility | Func Name | | :-------| :-------- | | date parser | dateParser | | date from now | dateFromNow | | date array | dateArray | | debounce | debounce | | delay | sleep |

Date Parser

// dateParser.js
import { dateParser } from "@hfrada/futils";

const date = new Date(2000, 2, 1, 10, 20, 30, 40);
const parse = dateParser(date, format, defResult); // 01/03/2000

Type of date is a string, number or Date. Format default is "DD/MM/YY" with result in dateParser.js. Param defResult refers to the result of invalid date parsing with default empty string.

| Param | Type | Required | Default | | :-----| :--- | :------- | :------ | | date | string | number | Date | true | undefined | | format | string | false | "DD/MM/YY" | | defResult | string | false | "" |

The available formats are as follows: | Format | Result | | :----- | :----- | | YY | 2000 | | MN | Maret | | MNs | Mar | | DD | 01 | | HH | 10 | | mm | 20 | | ss | 30 | | ms | 40 |

Date From Now

// dateParser.js
import { dateFromNow } from "@hfrada/futils";

const date = new Date().getTime() - 10_000;
const parse = dateFromNow(date); // 10 detik lalu

Type of date is a string, number or Date. Result will be a subtract string from the current date with the date from the parameter.

| Param | Type | Required | Default | | :-----| :--- | :------- | :------ | | date | string | number | Date | true | undefined |

The available results are as follows: | Interval | Result | | :----- | :----- | | year | 1 tahun lalu | | month | 3 bulan lalu | | day | 10 hari lalu | | hour | 5 jam lalu | | minute | 10 menit lalu | | second | 20 detik lalu |

Date Array

// dateArray.js
import { dateArray } from "@hfrada/futils";

const ranges = dateArray(startDate, endDate); // [Date, ..., Date]

Date Array is used to create date ranges. The length is based on the startDate and endDate parameters. The parameter startDate has type Date and cannot be greater than endDate. The endDate parameter has type Date and its value must be greater than or equal to startDate.

| Param | Type | Required | Default | | :-----| :--- | :------- | :------ | | startDate | Date | true | undefined | | endDate | Date | true | undefined |

File

documentation here

Debounce

// debounce.js
import { debounce } from "@hfrada/futils";

function callback(...args) {
    // do something
}
const bouncer = debounce(callback, time);
bouncer(); // run callback after `time` delay
bouncer(); // remove previous process and rerun callback after `time` delay

Debounce make code is only triggered once per user input. Debouce waits for a delay to run the some process. During this time, if the process is overwritten, the previous process will not be executed. Debounce delay can be custom by parameter time with type number in milliseconds.

| Param | Type | Required | Default | | :-----| :--- | :------- | :------ | | callback | function | true | undefined | | time | number | false | 300 |

Delay

// delay.js
import { sleep } from "@hfrada/futils";

async function callWithDelay() {
    // do something before delay
    sleep(time);
    // do something after delay
}

Delay is used to pending the asynchronous process before executing the next process. Delay can be custom by parameter time with type number in milliseconds. | Param | Type | Required | Default | | :-----| :--- | :------- | :------ | | time | number | false | 1000 |