--- name: "parseSecond" mode: "api" versionRequirements: - { name: "@ray-js/panel-sdk", version: "1.0.0" } title: "时间" summary: "介绍秒数转换、时分秒解析、日期格式化及时区查询等时间处理工具。" questions: - "parseSecond函数如何将秒数转化为时分秒的字符串数组？num参数有什么作用？" - "parseHour12函数如何将秒数转换为12小时制的时间字符串？返回格式是什么？" - "stringToSecond函数如何将"11:30"或"22:11:30"格式的时间字符串转换为秒数？" - "dateToTimer函数如何将"20110801"格式的日期字符串转换为Unix时间戳？" - "dateFormat函数支持哪些格式化占位符？如yyyy、MM、dd、hh、mm、ss等" - "timezone函数返回的时区格式是什么？例如"+08:00"代表什么时区？" - "如何从@ray-js/panel-sdk的utils中引入parseSecond等时间工具函数？" - "dateFormat函数中季度(q)和毫秒(S)的占位符分别支持几个字符？" - "parseSecond(111)的返回结果是什么？每个数组元素代表什么含义？" - "时间工具函数在面板定时功能开发中有哪些典型应用场景？" --- ## parseSecond > [VERSION] @ray-js/panel-sdk >= 1.0.0 ### 描述 将秒数解析为 [时, 分, 秒] 的字符串数组 ### 参数 `Params` | 参数 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | `t` | `number` | 是 | 总秒数 | ### 返回值 类型: `string[]` 包含三个两位字符串的数组，分别表示 [小时, 分钟, 秒] ### 示例代码 #### 基础用法 ```ts import { utils } from '@ray-js/panel-sdk'; const { parseSecond } = utils; parseSecond(111); // ['00', '01', '51'] parseSecond(3661); // ['01', '01', '01'] parseSecond(3333333); // ['25', '55', '33'] ``` --- name: "parseHour12" mode: "api" versionRequirements: - { name: "@ray-js/panel-sdk", version: "1.0.0" } title: "时间" summary: "介绍秒数转换、时分秒解析、日期格式化及时区查询等时间处理工具。" questions: - "parseSecond函数如何将秒数转化为时分秒的字符串数组？num参数有什么作用？" - "parseHour12函数如何将秒数转换为12小时制的时间字符串？返回格式是什么？" - "stringToSecond函数如何将"11:30"或"22:11:30"格式的时间字符串转换为秒数？" - "dateToTimer函数如何将"20110801"格式的日期字符串转换为Unix时间戳？" - "dateFormat函数支持哪些格式化占位符？如yyyy、MM、dd、hh、mm、ss等" - "timezone函数返回的时区格式是什么？例如"+08:00"代表什么时区？" - "如何从@ray-js/panel-sdk的utils中引入parseSecond等时间工具函数？" - "dateFormat函数中季度(q)和毫秒(S)的占位符分别支持几个字符？" - "parseSecond(111)的返回结果是什么？每个数组元素代表什么含义？" - "时间工具函数在面板定时功能开发中有哪些典型应用场景？" --- ## parseHour12 > [VERSION] @ray-js/panel-sdk >= 1.0.0 ### 描述 将秒数格式化为 12 小时制时间字符串 ### 参数 `Params` | 参数 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | `second` | `number` | 是 | 总秒数，超过一天（86400 秒）的部分会取余 | ### 返回值 无 ### 示例代码 #### 基础用法 ```ts import { utils } from '@ray-js/panel-sdk'; const { parseHour12 } = utils; parseHour12(111); // '12:01 AM' parseHour12(3333333); // '01:55 PM' parseHour12(43200); // '12:00 PM' ``` --- name: "stringToSecond" mode: "api" versionRequirements: - { name: "@ray-js/panel-sdk", version: "1.0.0" } title: "时间" summary: "介绍秒数转换、时分秒解析、日期格式化及时区查询等时间处理工具。" questions: - "parseSecond函数如何将秒数转化为时分秒的字符串数组？num参数有什么作用？" - "parseHour12函数如何将秒数转换为12小时制的时间字符串？返回格式是什么？" - "stringToSecond函数如何将"11:30"或"22:11:30"格式的时间字符串转换为秒数？" - "dateToTimer函数如何将"20110801"格式的日期字符串转换为Unix时间戳？" - "dateFormat函数支持哪些格式化占位符？如yyyy、MM、dd、hh、mm、ss等" - "timezone函数返回的时区格式是什么？例如"+08:00"代表什么时区？" - "如何从@ray-js/panel-sdk的utils中引入parseSecond等时间工具函数？" - "dateFormat函数中季度(q)和毫秒(S)的占位符分别支持几个字符？" - "parseSecond(111)的返回结果是什么？每个数组元素代表什么含义？" - "时间工具函数在面板定时功能开发中有哪些典型应用场景？" --- ## stringToSecond > [VERSION] @ray-js/panel-sdk >= 1.0.0 ### 描述 将时间字符串解析为总秒数 ### 参数 `Params` | 参数 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | `timeStr` | `string` | 是 | 冒号分隔的时间字符串，支持 'HH:MM' 或 'HH:MM:SS' 格式 | ### 返回值 无 ### 示例代码 #### 基础用法 ```ts import { utils } from '@ray-js/panel-sdk'; const { stringToSecond } = utils; stringToSecond('11:30'); // 690 stringToSecond('22:11:30'); // 79890 stringToSecond('01:00'); // 60 ``` --- name: "dateToTimer" mode: "api" versionRequirements: - { name: "@ray-js/panel-sdk", version: "1.0.0" } title: "时间" summary: "介绍秒数转换、时分秒解析、日期格式化及时区查询等时间处理工具。" questions: - "parseSecond函数如何将秒数转化为时分秒的字符串数组？num参数有什么作用？" - "parseHour12函数如何将秒数转换为12小时制的时间字符串？返回格式是什么？" - "stringToSecond函数如何将"11:30"或"22:11:30"格式的时间字符串转换为秒数？" - "dateToTimer函数如何将"20110801"格式的日期字符串转换为Unix时间戳？" - "dateFormat函数支持哪些格式化占位符？如yyyy、MM、dd、hh、mm、ss等" - "timezone函数返回的时区格式是什么？例如"+08:00"代表什么时区？" - "如何从@ray-js/panel-sdk的utils中引入parseSecond等时间工具函数？" - "dateFormat函数中季度(q)和毫秒(S)的占位符分别支持几个字符？" - "parseSecond(111)的返回结果是什么？每个数组元素代表什么含义？" - "时间工具函数在面板定时功能开发中有哪些典型应用场景？" --- ## dateToTimer > [VERSION] @ray-js/panel-sdk >= 1.0.0 ### 描述 将日期字符串转换为 Unix 时间戳（秒） ### 参数 `Params` | 参数 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | `dateString` | `string` | 是 | 日期字符串，格式为 'YYYYMMDD' 或 'YYYYMMDD HH:MM:SS' | ### 返回值 无 ### 示例代码 #### 基础用法 ```ts import { utils } from '@ray-js/panel-sdk'; const { dateToTimer } = utils; dateToTimer('20110801'); // 1312128000（取决于时区） dateToTimer('20110801 12:11:11'); // 1312171871（取决于时区） ``` --- name: "dateFormat" mode: "api" versionRequirements: - { name: "@ray-js/panel-sdk", version: "1.0.0" } title: "时间" summary: "介绍秒数转换、时分秒解析、日期格式化及时区查询等时间处理工具。" questions: - "parseSecond函数如何将秒数转化为时分秒的字符串数组？num参数有什么作用？" - "parseHour12函数如何将秒数转换为12小时制的时间字符串？返回格式是什么？" - "stringToSecond函数如何将"11:30"或"22:11:30"格式的时间字符串转换为秒数？" - "dateToTimer函数如何将"20110801"格式的日期字符串转换为Unix时间戳？" - "dateFormat函数支持哪些格式化占位符？如yyyy、MM、dd、hh、mm、ss等" - "timezone函数返回的时区格式是什么？例如"+08:00"代表什么时区？" - "如何从@ray-js/panel-sdk的utils中引入parseSecond等时间工具函数？" - "dateFormat函数中季度(q)和毫秒(S)的占位符分别支持几个字符？" - "parseSecond(111)的返回结果是什么？每个数组元素代表什么含义？" - "时间工具函数在面板定时功能开发中有哪些典型应用场景？" --- ## dateFormat > [VERSION] @ray-js/panel-sdk >= 1.0.0 > 💡 月(M)、日(d)、小时(h)、分(m)、秒(s)、季度(q) 可用 1-2 个占位符；年(y) 可用 1-4 个占位符；毫秒(S) 只能用 1 个占位符。 ### 描述 将 Date 对象格式化为指定格式的日期字符串 ### 参数 `Params` | 参数 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | `fmt` | `string` | 是 | 格式化模板字符串，支持 y(年)、M(月)、d(日)、h(时)、m(分)、s(秒)、q(季度)、S(毫秒) 占位符 | | `date` | `Date` | 是 | 要格式化的 Date 对象 | ### 返回值 无 ### 示例代码 #### 基础用法 ```ts import { utils } from '@ray-js/panel-sdk'; const { dateFormat } = utils; const date = new Date('2026-07-02 08:09:04.423'); dateFormat('yyyy-MM-dd hh:mm:ss.S', date); // '2026-07-02 08:09:04.423' dateFormat('yyyy-M-d h:m:s.S', date); // '2026-7-2 8:9:4.423' dateFormat('MM/dd/yyyy', date); // '07/02/2026' ``` --- name: "timezone" mode: "api" versionRequirements: - { name: "@ray-js/panel-sdk", version: "1.0.0" } title: "时间" summary: "介绍秒数转换、时分秒解析、日期格式化及时区查询等时间处理工具。" questions: - "parseSecond函数如何将秒数转化为时分秒的字符串数组？num参数有什么作用？" - "parseHour12函数如何将秒数转换为12小时制的时间字符串？返回格式是什么？" - "stringToSecond函数如何将"11:30"或"22:11:30"格式的时间字符串转换为秒数？" - "dateToTimer函数如何将"20110801"格式的日期字符串转换为Unix时间戳？" - "dateFormat函数支持哪些格式化占位符？如yyyy、MM、dd、hh、mm、ss等" - "timezone函数返回的时区格式是什么？例如"+08:00"代表什么时区？" - "如何从@ray-js/panel-sdk的utils中引入parseSecond等时间工具函数？" - "dateFormat函数中季度(q)和毫秒(S)的占位符分别支持几个字符？" - "parseSecond(111)的返回结果是什么？每个数组元素代表什么含义？" - "时间工具函数在面板定时功能开发中有哪些典型应用场景？" --- ## timezone > [VERSION] @ray-js/panel-sdk >= 1.0.0 ### 描述 获取当前系统时区偏移字符串 ### 参数 无 ### 返回值 无 ### 示例代码 #### 基础用法 ```ts import { utils } from '@ray-js/panel-sdk'; const { timezone } = utils; const tz = timezone(); // 例如 '+08:00'（中国标准时间） ```