parseSecond(t: number)

Requires:
@ray-js/panel-sdk≥1.0.0

Description

Parse seconds into a [HH, MM, SS] string array

Parameters

ParameterTypeRequiredDescription
tnumberYesTotal seconds

Return Value

Type: string[]
An array of three two-digit strings representing [hours, minutes, seconds]

Examples

Basic usage

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)

Requires:
@ray-js/panel-sdk≥1.0.0

Description

Format seconds as a 12-hour time string

Parameters

ParameterTypeRequiredDescription
secondnumberYesTotal seconds; values beyond one day (86400 seconds) are taken modulo

Return Value

Type: string
A 12-hour time string in the format 'HH:MM AM/PM'

Examples

Basic usage

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)

Requires:
@ray-js/panel-sdk≥1.0.0

Description

Parse a time string into total seconds

Parameters

ParameterTypeRequiredDescription
timeStrstringYesA colon-separated time string in 'HH:MM' or 'HH:MM:SS' format

Return Value

Type: number
The corresponding total seconds

Examples

Basic usage

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)

Requires:
@ray-js/panel-sdk≥1.0.0

Description

Convert a date string to a Unix timestamp (seconds)

Parameters

ParameterTypeRequiredDescription
dateStringstringYesA date string in 'YYYYMMDD' or 'YYYYMMDD HH:MM:SS' format

Return Value

Type: number
The corresponding Unix timestamp (seconds, 10 digits)

Examples

Basic usage

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

const { dateToTimer } = utils;

dateToTimer('20110801');          // 1312128000 (depends on time zone)
dateToTimer('20110801 12:11:11'); // 1312171871 (depends on time zone)

dateFormat(fmt: string, date: Date)

Requires:
@ray-js/panel-sdk≥1.0.0

Description

Format a Date object into a date string in the specified format

Parameters

ParameterTypeRequiredDescription
fmtstringYesA format template string supporting placeholders y (year), M (month), d (day), h (hour), m (minute), s (second), q (quarter), S (millisecond)
dateDateYesThe Date object to format

Return Value

Type: string
The formatted date string

Examples

Basic usage

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()

Requires:
@ray-js/panel-sdk≥1.0.0

Description

Get the current system time zone offset string

Parameters

None

Return Value

Type: string
A time zone offset string in '+HH:MM' or '-HH:MM' format

Examples

Basic usage

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

const { timezone } = utils;

const tz = timezone(); // e.g., '+08:00' (China Standard Time)