WMS_MAIN/app/lib/report/day_window.js

172 lines
5.6 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'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,
};