guest/steel_prices_service

Fork 0

Files

ECRZ da4a055c1c modify：新增小程序

2026-01-06 18:00:43 +08:00

4.0 KiB

Raw Blame History

根目录 > utils

utils - 工具函数模块

最后更新：2026-01-06 15:26:54

变更记录 (Changelog)

2026-01-06

初始化模块文档
识别当前包含时间格式化工具函数

模块职责

当前职责：提供通用的工具函数，当前仅包含日期时间格式化功能。

扩展方向：

封装 API 请求方法（wx.request）
添加数据验证与格式化工具
添加本地存储管理工具
添加常用业务逻辑工具函数

入口与启动

模块路径

物理路径：utils/util.js
导出方式：CommonJS module.exports

引入方式

const util = require('../../utils/util.js')

// 使用工具函数
const formattedTime = util.formatTime(new Date())

对外接口

当前提供的工具函数

1. formatTime(date)

功能：将日期对象格式化为 YYYY/MM/DD HH:mm:ss 格式

参数：

date：Date 对象

返回值：

格式化的时间字符串，例如：'2026/01/06 15:26:54'

示例：

const now = new Date()
const formatted = util.formatTime(now)
console.log(formatted) // 输出：2026/01/06 15:26:54

关键依赖与配置

依赖文件

文件	用途
`util.js`	工具函数实现

外部依赖

无外部依赖（纯 JavaScript 实现）

数据模型

formatTime 实现细节

const formatTime = date => {
  const year = date.getFullYear()
  const month = date.getMonth() + 1
  const day = date.getDate()
  const hour = date.getHours()
  const minute = date.getMinutes()
  const second = date.getSeconds()

  return `${[year, month, day].map(formatNumber).join('/')} ${[hour, minute, second].map(formatNumber).join(':')}`
}

const formatNumber = n => {
  n = n.toString()
  return n[1] ? n : `0${n}`
}

测试与质量

测试覆盖

手动测试：在 pages/logs 中使用正常
单元测试：暂无

边界情况

月份补零（1 → 01）
时分秒补零（8 → 08）

常见问题 (FAQ)

Q: 如何添加新的工具函数？

A: 在 util.js 中添加函数并导出：

// 添加新函数
const formatPrice = price => {
  return `¥${price.toFixed(2)}`
}

// 在 module.exports 中导出
module.exports = {
  formatTime,
  formatPrice  // 新增
}

Q: 是否需要拆分为多个文件？

A: 当前项目规模小，单文件足够。随着功能增加，建议拆分为：

utils/api.js：API 请求封装
utils/storage.js：本地存储管理
utils/validator.js：数据验证
utils/format.js：格式化工具

下一步建议

推荐新增工具函数

1. API 请求封装（`utils/request.js`）

const BASE_URL = 'http://localhost:3000/api'

function request(url, data = {}, method = 'GET') {
  return new Promise((resolve, reject) => {
    wx.request({
      url: `${BASE_URL}${url}`,
      data,
      method,
      success: res => resolve(res.data),
      fail: err => reject(err)
    })
  })
}

module.exports = { request }

2. 价格格式化（扩展 `util.js`）

const formatPrice = (price, unit = '元/吨') => {
  return `${price.toFixed(2)} ${unit}`
}

const formatNumberWithComma = num => {
  return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',')
}

3. 本地存储管理（`utils/storage.js`）

const STORAGE_KEYS = {
  SEARCH_HISTORY: 'search_history',
  USER_FAVORITES: 'user_favorites'
}

function getStorage(key) {
  return wx.getStorageSync(key) || []
}

function setStorage(key, data) {
  wx.setStorageSync(key, data)
}

module.exports = { STORAGE_KEYS, getStorage, setStorage }

模块状态：可用，待扩展 优先级：中（API 封装为高优先级） 预估工作量：1-2 小时（封装常用工具函数）

4.0 KiB Raw Blame History Unescape Escape