172 lines
5.6 KiB
JavaScript
172 lines
5.6 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* 报表「日窗口」纯函数工具模块(无 ctx 依赖,可单测)。
|
||
*
|
||
* 日窗口定义:[D 07:00, D+1 07:00) 半开区间(毫秒时间戳),
|
||
* 与旧 PHP《7日出入库数据》(Wms.php putout_putin_storage7) 的
|
||
* 07:00 切日口径保持一致,统一使用服务器本地时区(不依赖 UTC)。
|
||
*/
|
||
|
||
const DEFAULT_DAY_COUNT = 7;
|
||
const DEFAULT_CUTOVER_HOUR = 7;
|
||
|
||
/**
|
||
* 数字补零为两位字符串。
|
||
* @param {number} value 数值
|
||
* @return {string} 补零后的两位字符串
|
||
*/
|
||
function pad2(value) {
|
||
return String(value).padStart(2, '0');
|
||
}
|
||
|
||
/**
|
||
* 按本地时区构建连续的日窗口列表(最旧在前)。
|
||
*
|
||
* 规则:
|
||
* 1. 每个窗口为 [D 07:00, D+1 07:00)(cutoverHour 可配置),start 含、end 不含;
|
||
* 2. 最新窗口是「包含 now 的窗口」:now 当日已过切点时从今日切点起算,
|
||
* 未过切点时从昨日切点起算;
|
||
* 3. 窗口共 dayCount 个,按时间从旧到新排列;
|
||
* 4. 通过 `new Date(y, m, d + offset, hour)` 构造,规避夏令时导致的 24h 步进偏差。
|
||
*
|
||
* @param {Object} [options={}] 构建选项
|
||
* @param {number} [options.dayCount=7] 窗口数量
|
||
* @param {number} [options.cutoverHour=7] 切点小时(0-23)
|
||
* @param {number|Date} [options.now=Date.now()] 参考时刻
|
||
* @return {Array<{start: number, end: number}>} 日窗口列表(毫秒,最旧在前)
|
||
*/
|
||
function buildDayWindows({ dayCount = DEFAULT_DAY_COUNT, cutoverHour = DEFAULT_CUTOVER_HOUR, now = Date.now() } = {}) {
|
||
const normalizedCount = Math.max(1, Math.floor(Number(dayCount) || DEFAULT_DAY_COUNT));
|
||
const normalizedHour = Math.min(23, Math.max(0, Math.floor(Number(cutoverHour) || 0)));
|
||
const current = new Date(Number(now) || Date.now());
|
||
|
||
// 今天切点:本地时区当日 07:00
|
||
let anchor = new Date(
|
||
current.getFullYear(),
|
||
current.getMonth(),
|
||
current.getDate(),
|
||
normalizedHour,
|
||
0,
|
||
0,
|
||
0
|
||
);
|
||
|
||
// 未到今日切点:最新窗口尚未开始,从昨日切点起算
|
||
if (current.getTime() < anchor.getTime()) {
|
||
anchor = new Date(
|
||
anchor.getFullYear(),
|
||
anchor.getMonth(),
|
||
anchor.getDate() - 1,
|
||
normalizedHour,
|
||
0,
|
||
0,
|
||
0
|
||
);
|
||
}
|
||
|
||
const windows = [];
|
||
for (let index = 0; index < normalizedCount; index += 1) {
|
||
// 最旧在前:dayOffset 从 -(count-1) 递增到 0
|
||
const dayOffset = index - (normalizedCount - 1);
|
||
const start = new Date(
|
||
anchor.getFullYear(),
|
||
anchor.getMonth(),
|
||
anchor.getDate() + dayOffset,
|
||
normalizedHour,
|
||
0,
|
||
0,
|
||
0
|
||
);
|
||
const end = new Date(
|
||
anchor.getFullYear(),
|
||
anchor.getMonth(),
|
||
anchor.getDate() + dayOffset + 1,
|
||
normalizedHour,
|
||
0,
|
||
0,
|
||
0
|
||
);
|
||
windows.push({
|
||
start: start.getTime(),
|
||
end: end.getTime(),
|
||
});
|
||
}
|
||
|
||
return windows;
|
||
}
|
||
|
||
/**
|
||
* 按 PHP date() 风格的 token 格式化窗口开始日期(本地时区,无前导零)。
|
||
*
|
||
* 支持的 token:
|
||
* Y=四位年;y=两位年;m=补零月;n=无前导零月;d=补零日;j=无前导零日;
|
||
* H=补零小时;i=补零分钟;s=补零秒。其余字符原样保留。
|
||
*
|
||
* @param {Array<{start: number, end: number}>} windows 日窗口列表
|
||
* @param {number} index 窗口下标
|
||
* @param {string} [pattern='Y/n/j'] 日期格式模板(如 '2026/8/23')
|
||
* @return {string} 格式化后的日期字符串
|
||
*/
|
||
function formatWindowStart(windows, index, pattern = 'Y/n/j') {
|
||
const windowItem = Array.isArray(windows) ? windows[index] : null;
|
||
if (!windowItem || !Number.isFinite(Number(windowItem.start))) {
|
||
return '';
|
||
}
|
||
|
||
const date = new Date(Number(windowItem.start));
|
||
const tokens = {
|
||
Y: String(date.getFullYear()),
|
||
y: String(date.getFullYear()).slice(2),
|
||
m: pad2(date.getMonth() + 1),
|
||
n: String(date.getMonth() + 1),
|
||
d: pad2(date.getDate()),
|
||
j: String(date.getDate()),
|
||
H: pad2(date.getHours()),
|
||
i: pad2(date.getMinutes()),
|
||
s: pad2(date.getSeconds()),
|
||
};
|
||
|
||
return String(pattern || 'Y/n/j').replace(/[YymndjHis]/g, character => tokens[character]);
|
||
}
|
||
|
||
/**
|
||
* 取时刻的本地 'HH:mm'(补零)。
|
||
* @param {Date|number} date 日期对象或毫秒时间戳
|
||
* @return {string} 'HH:mm' 格式字符串
|
||
*/
|
||
function hhmmOf(date) {
|
||
const normalizedDate = date instanceof Date ? date : new Date(Number(date) || Date.now());
|
||
return `${pad2(normalizedDate.getHours())}:${pad2(normalizedDate.getMinutes())}`;
|
||
}
|
||
|
||
/**
|
||
* 取时刻的本地自然日('YYYY-MM-DD')。
|
||
* @param {Date|number} date 日期对象或毫秒时间戳
|
||
* @return {string} 'YYYY-MM-DD' 格式字符串
|
||
*/
|
||
function scheduleDateOf(date) {
|
||
const normalizedDate = date instanceof Date ? date : new Date(Number(date) || Date.now());
|
||
return `${normalizedDate.getFullYear()}-${pad2(normalizedDate.getMonth() + 1)}-${pad2(normalizedDate.getDate())}`;
|
||
}
|
||
|
||
/**
|
||
* 从窗口参数对象解析 dayCount/cutoverHour,供查询器与元数据接口共用。
|
||
* 口径与查询器保持一致:dayCount 缺省 7(<=0 视为 7),cutoverHour 缺省 7 且钳制到 0-23。
|
||
* @param {Object} [params={}] 窗口参数(支持 dayCount/day_count、cutoverHour/cutover_hour)
|
||
* @return {{dayCount: number, cutoverHour: number}} 归一化窗口参数
|
||
*/
|
||
function resolveWindowConfig(params = {}) {
|
||
const dayCount = Math.max(1, Math.floor(Number(params.dayCount || params.day_count || 7)));
|
||
const cutoverHour = Math.min(23, Math.max(0, Math.floor(Number(params.cutoverHour ?? params.cutover_hour ?? 7))));
|
||
return { dayCount, cutoverHour };
|
||
}
|
||
|
||
module.exports = {
|
||
buildDayWindows,
|
||
formatWindowStart,
|
||
hhmmOf,
|
||
scheduleDateOf,
|
||
resolveWindowConfig,
|
||
};
|