parseSecond(t: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将秒数解析为 [时, 分, 秒] 的字符串数组

参数

参数类型必填说明
tnumber是总秒数

返回值

类型：string[]
包含三个两位字符串的数组，分别表示 [小时, 分钟, 秒]

示例代码

基础用法

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']

parseHour12(second: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将秒数格式化为 12 小时制时间字符串

参数

参数类型必填说明
secondnumber是总秒数，超过一天（86400 秒）的部分会取余

返回值

类型：string
格式为 'HH:MM AM/PM' 的 12 小时制时间字符串

示例代码

基础用法

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'

stringToSecond(timeStr: string)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将时间字符串解析为总秒数

参数

参数类型必填说明
timeStrstring是冒号分隔的时间字符串，支持 'HH:MM' 或 'HH:MM:SS' 格式

返回值

类型：number
对应的总秒数

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { stringToSecond } = utils;

stringToSecond('11:30');    // 690
stringToSecond('22:11:30'); // 79890
stringToSecond('01:00');    // 60

dateToTimer(dateString: string)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将日期字符串转换为 Unix 时间戳（秒）

参数

参数类型必填说明
dateStringstring是日期字符串，格式为 'YYYYMMDD' 或 'YYYYMMDD HH:MM:SS'

返回值

类型：number
对应的 Unix 时间戳（秒，10 位）

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { dateToTimer } = utils;

dateToTimer('20110801');          // 1312128000（取决于时区）
dateToTimer('20110801 12:11:11'); // 1312171871（取决于时区）

dateFormat(fmt: string, date: Date)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 Date 对象格式化为指定格式的日期字符串

参数

参数类型必填说明
fmtstring是格式化模板字符串，支持 y(年)、M(月)、d(日)、h(时)、m(分)、s(秒)、q(季度)、S(毫秒) 占位符
dateDate是要格式化的 Date 对象

返回值

类型：string
格式化后的日期字符串

示例代码

基础用法

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'

timezone()

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

获取当前系统时区偏移字符串

参数

无

返回值

类型：string
时区偏移字符串，格式为 '+HH:MM' 或 '-HH:MM'

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { timezone } = utils;

const tz = timezone(); // 例如 '+08:00'（中国标准时间）