dayjs-tz-helper

Day.js 時區輔助套件，提供安全解析時區日期字串與時間戳轉換功能 (Day.js timezone helper for safe timezone date string parsing and timestamp conversion)

安裝 (Installation)

# 使用 yarn / Using yarn
yarn add dayjs-tz-helper

# 使用 yarn-tool / Using yarn-tool
yarn-tool add dayjs-tz-helper
# yt 是 yarn-tool 的別名 / yt is an alias for yarn-tool
yt add dayjs-tz-helper

# 使用 pnpm / Using pnpm
pnpm add dayjs-tz-helper

# 使用 npm / Using npm
npm install dayjs-tz-helper

功能 (Features)

• tzDayjsSafeParse - 安全解析時區日期字串，處理多種邊界情況
• secondsToMilliseconds - 秒轉毫秒
• millisecondsToSeconds - 毫秒轉秒
• _isUnsafeOffsetDateString - 偵測不安全的偏移日期字串
• _isUnsafeUTCDateString - 偵測 UTC/GMT 日期字串

使用方式 (Usage)

import { tzDayjsSafeParse, secondsToMilliseconds, millisecondsToSeconds } from 'dayjs-tz-helper';

// 安全解析時區日期
const date1 = tzDayjsSafeParse('2023-03-31T04:00:00.000Z');
const date2 = tzDayjsSafeParse('2023-03-31T12:00:00+08:00', 'Asia/Taipei');

// 時間戳轉換
const ms = secondsToMilliseconds(1318781876); // 1318781876000
const sec = millisecondsToSeconds(1318781876000); // 1318781876