standards-core

Common standards used within MTCC. Contains core functions without external dependencies.

Use case of installing this repo rather than the standards repo is for usage in front-end apps without any Node.js dependencies.

Installation

npm i https://github.com/MTCC-Plc/standards-core#{hash of the commit}

Unlike a regular install from the npm registry, this package will be fetched from GitHub.

In order to pin to a specific version, the hash of the commit should be passed at the end of the url. If unsure which commit to use, pick the latest one. For example:

npm i https://github.com/MTCC-Plc/standards-core#133d0a7

Either the short or long hash are fine.

Usage

Date Formats

To use the same date formats across all apps, use the defined formats from this library. Can be used with either moment or dayjs.

import { DT_FORMATS } from "standards";
dayjs(comment.createdAt).format(DT_FORMATS.SHORT);
moment(comment.createdAt).format(DT_FORMATS.SHORT);

Time Durations

To display time durations in a human readable format. Enter either the total minutes, hours or seconds. Enter only one value of the three. If multiple values are entered, only one will be considered in the following order of preference: minutes, seconds, hours. If none of the values are entered, an error will be thrown.

import { timeDurationHumanReadable } from "standards";
timeDurationHumanReadable({ seconds: 500 });

Level and Grade Check

Pass in employee level_grade string to check if employee is above a certain level, grade or both.

import { isLevelOrAbove, isGradeOrAbove, isLevelGradeOrAbove } from "standards";
isLevelOrAbove("L2G2", 2); // returns [true, 2]
isGradeOrAbove("L2G3", 2); // returns [true, 3]
isLevelGradeOrAbove("L5G3", 4, 6); // returns false