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