ddkq
ddkq -> 钉钉考勤
根据打卡时间表(excel),获取上下班时间,加班时间以及所有打卡时间
Install
$ npm install ddkq
Usage
const { getTimeAll, getTimeOn, getTimeOff, getTimeOver } = require('ddkq')
const excels = ['2018.11']
const timeAlls = getTimeAll(excels)
const timeOns = getTimeOn(excels)
const timeOffs = getTimeOff(excels)
const timeOvers = getTimeOver(excels)
API
getTimeAll(excels[, config])
根据 excels 获取所有打卡时间
-
excels
{Array}
格式为yyyy-mm
,值必须与 excels 名一一对应 -
config
{Object}
-
sorting
{String}
默认结果按照 excels 数组顺序排序-
'asc'
结果按照日期升序 -
'desc'
结果按照日期降序
-
-
excelsPath
{String}
默认 excels 放在程序根目录下,如果放在其他地方,需要手动指定其位置
-
- return:
{Array<Object>}
返回数组,数组内每个对象代表该天详细数据-
year
{Number}
年 -
month
{Number}
月 -
day
{Number}
日 -
punchTimes
{Array<String>}
该日打卡时间数组,数组值hh:mm
格式 -
format
{String}
格式化时间,格式yyyy-mm-dd
-
getTimeOn(excels[, config])
根据 excels 获取所有上班打卡数据
- return:
{Array<Object>}
返回数组,数组内每个对象代表该天详细数据-
year
{Number}
年 -
month
{Number}
月 -
day
{Number}
日 -
time
{String}
时间,格式hh:mm
-
format
{String}
格式化时间,格式yyyy-mm-dd
-
timestamp
{Number}
该日上班打卡时间戳
-
getTimeOff(excels[, config])
根据 excels 获取所有下班打卡数据
- return:
{Array<Object>}
返回数组,数组内每个对象代表该天详细数据-
year
{Number}
年 -
month
{Number}
月 -
day
{Number}
日 -
time
{String}
时间,格式hh:mm
-
format
{String}
格式化时间,格式yyyy-mm-dd
-
timestamp
{Number}
该日下班打卡时间戳
-
getTimeOver(excels[, config])
根据 excels 获取所有加班日期数据
其他配置与前几个 API 一样,另外 config
可配置 overtimeStart
,默认 20
,即 20 点后算当天加班
-
config
{Object}
-
overtimeStart
{Number}
默认 20,如果需要配置 20 点半,则为20.5
,其他时间雷同
-
- return:
{Array<Object>}
返回数组,数组内每个对象代表该天详细数据-
year
{Number}
年 -
month
{Number}
月 -
day
{Number}
日 -
time
{String}
时间,格式hh:mm
-
format
{String}
格式化时间,格式yyyy-mm-dd
-
timestamp
{Number}
该加班日下班打卡时间戳
-
License
MIT