leecc-tools

A lightweight JavaScript utility library for date formatting and type checking.

Installation

npm install leecc-tools

Usage

Date Utilities

import { formatDate, formatRelativeTime, parseDate, getTimestamp, getStartOfDay, getEndOfDay } from 'lec-tools';

// Format date
formatDate(new Date(), 'YYYY-MM-DD HH:mm:ss');  // '2026-03-18 14:30:00'
formatDate(Date.now(), 'YYYY-MM-DD');            // '2026-03-18'

// Relative time
formatRelativeTime(Date.now() - 3600000);       // '1小时前'
formatRelativeTime(Date.now() - 3600000, 'en'); // '1 hour ago'

// Parse date
parseDate('2026-03-18');  // Date object

// Get timestamp
getTimestamp();           // Current timestamp in ms

// Start/End of day
getStartOfDay(new Date());  // 2026-03-18 00:00:00
getEndOfDay(new Date());    // 2026-03-18 23:59:59.999

Type Checking

import { getType, isString, isNumber, isArray, isObject, isEmpty, isPromise, isMap, isSet } from 'lec-tools';

// Get precise type
getType('hello');     // 'string'
getType([1, 2]);      // 'array'
getType(null);        // 'null'
getType(new Date());  // 'date'
getType(new Map());   // 'map'

// Type checks
isString('hello');   // true
isNumber(123);       // true
isArray([]);         // true
isObject({});        // true
isEmpty(null);       // true
isEmpty('');         // true
isEmpty([]);         // true
isEmpty({});         // true
isPromise(Promise.resolve());  // true

// Check for collections
isMap(new Map());    // true
isSet(new Set());    // true

API

Date

| Method | Description | |--------|-------------| | formatDate(date, format) | Format date with custom format string | | formatRelativeTime(date, lang) | Get relative time string | | parseDate(dateStr) | Parse string to Date | | getTimestamp(date) | Get timestamp in milliseconds | | getStartOfDay(date) | Get start of day | | getEndOfDay(date) | Get end of day |

Type

| Method | Description | |--------|-------------| | getType(value) | Get precise type string | | isString(value) | Check if string | | isNumber(value) | Check if number | | isBoolean(value) | Check if boolean | | isFunction(value) | Check if function | | isArray(value) | Check if array | | isObject(value) | Check if object | | isDate(value) | Check if Date | | isRegExp(value) | Check if RegExp | | isNull(value) | Check if null | | isUndefined(value) | Check if undefined | | isNil(value) | Check if null or undefined | | isEmpty(value) | Check if empty | | isPromise(value) | Check if Promise | | isError(value) | Check if Error | | isMap(value) | Check if Map | | isSet(value) | Check if Set |

License

MIT