w-dwdata-hub 1.0.0

package/src/fetchWithRetry.mjs

@@ -0,0 +1,304 @@
+import get from 'lodash-es/get.js'
+import isbol from 'wsemi/src/isbol.mjs'
+import isestr from 'wsemi/src/isestr.mjs'
+import isearr from 'wsemi/src/isearr.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
+import ispint from 'wsemi/src/ispint.mjs'
+import isp0int from 'wsemi/src/isp0int.mjs'
+import cint from 'wsemi/src/cint.mjs'
+import delay from 'wsemi/src/delay.mjs'
+
+
+//預設User-Agent, 各資料來源網站多會擋無User-Agent之請求
+let DEFAULT_UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36'
+
+
+//預設值
+let DEFAULT_TIMEOUT_MS = 30000
+let DEFAULT_MAX_RETRIES = 10
+let DEFAULT_BASE_DELAY_MS = 5000
+let DEFAULT_MAX_DELAY_MS = 30000
+
+
+//視為暫時性故障之網路層錯誤碼, node內建fetch(undici)會把底層錯誤掛於err.cause
+let NETWORK_ERROR_CODES = ['ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND', 'ECONNREFUSED', 'ECONNABORTED', 'EAI_AGAIN', 'EPIPE']
+
+
+/**
+ * 判斷錯誤是否值得重試
+ *
+ * 有statusCode(即HTTP層錯誤)時, 5xx與429視為暫時性, 其餘由retryStatus指定;
+ * 無statusCode(即網路層錯誤)時, 由錯誤碼、AbortError與undici暫時性錯誤判斷
+ *
+ * @param {Error} err 輸入錯誤物件
+ * @param {Array} retryStatus 輸入額外視為可重試之HTTP狀態碼陣列
+ * @returns {Boolean} 回傳是否可重試布林值
+ */
+function isRetryableError(err, retryStatus) {
+
+    //statusCode, 由fetchOnce於HTTP非2xx時掛入
+    let statusCode = get(err, 'statusCode', null)
+    if (ispint(statusCode)) {
+        return statusCode >= 500 || statusCode === 429 || retryStatus.includes(statusCode)
+    }
+
+    //code, undici把底層錯誤掛在err.cause
+    let code = get(err, 'cause.code', null) || get(err, 'code', null)
+    if (isestr(code) && NETWORK_ERROR_CODES.includes(code)) {
+        return true
+    }
+
+    //AbortController觸發之逾時
+    let name = get(err, 'name', '')
+    if (name === 'AbortError' || name === 'TimeoutError') {
+        return true
+    }
+
+    //undici之socket與逾時類暫時性錯誤
+    let ms = String(get(err, 'cause.code', '') || get(err, 'message', ''))
+    if (/UND_ERR_(SOCKET|HEADERS_TIMEOUT|BODY_TIMEOUT|CONNECT_TIMEOUT)/.test(ms)) {
+        return true
+    }
+
+    return false
+}
+
+
+/**
+ * 單次抓取, HTTP非2xx時拋出帶statusCode之錯誤
+ *
+ * @param {String} url 輸入待抓取網址字串
+ * @param {Object} cfg 輸入已正規化之設定物件
+ * @returns {Promise} 回傳Promise，resolve回傳解析後資料
+ */
+async function fetchOnce(url, cfg) {
+
+    //ac, 以AbortController實作逾時, 避免socket卡住永不回應
+    let ac = new AbortController()
+    let idTimer = setTimeout(() => {
+        ac.abort()
+    }, cfg.timeout)
+
+    try {
+
+        //opt
+        let opt = {
+            method: cfg.method,
+            headers: cfg.headers,
+            signal: ac.signal,
+        }
+        if (cfg.body !== null) {
+            opt.body = cfg.body
+        }
+
+        //fetch
+        let res = await fetch(url, opt)
+
+        //check, node內建fetch不會因HTTP非2xx而拋錯, 需自行檢核
+        if (!res.ok) {
+            let err = new Error(`HTTP ${res.status} ${res.statusText}`.trim())
+            err.statusCode = res.status
+            err.url = url
+            throw err
+        }
+
+        //arrayBuffer
+        if (cfg.responseType === 'arrayBuffer') {
+            return await res.arrayBuffer()
+        }
+
+        //text
+        if (cfg.responseType === 'text') {
+            if (cfg.encoding !== '') {
+                //指定編碼(如big5)時需自行解碼, res.text()一律以utf-8解碼
+                let ab = await res.arrayBuffer()
+                return new TextDecoder(cfg.encoding).decode(ab)
+            }
+            return await res.text()
+        }
+
+        //json, 先取text再自行parse, 令維護頁面(HTTP 200+HTML)能產生可讀訊息而非裸SyntaxError
+        let text = await res.text()
+        try {
+            return JSON.parse(text)
+        }
+        catch (err) {
+            throw new Error(`回傳非JSON格式(可能為維護頁面或網路中介): ${text.slice(0, 100)}`)
+        }
+
+    }
+    finally {
+        clearTimeout(idTimer)
+    }
+}
+
+
+/**
+ * 以node內建fetch抓取資料並自動重試
+ *
+ * 特點：
+ * HTTP 5xx與429及網路層錯誤(含逾時)會自動重試，採線性退避baseDelayMs*attempt並以maxDelayMs為上限；
+ * HTTP 4xx(429除外)預設不重試，可由opt.retryStatus指定額外可重試狀態碼(如403、404)；
+ * responseType為'json'時先取原始文字再自行JSON.parse，令維護頁面能產生可讀錯誤訊息
+ *
+ * @param {String} url 輸入待抓取網址字串
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.method='GET'] 輸入HTTP方法字串，預設'GET'
+ * @param {Object} [opt.headers={}] 輸入額外HTTP標頭物件，未指定User-Agent時自動補預設值，預設{}
+ * @param {String} [opt.body=null] 輸入請求主體字串，預設null代表無主體
+ * @param {String} [opt.responseType='json'] 輸入回應解析方式字串，可為'json'、'text'、'arrayBuffer'，預設'json'
+ * @param {String} [opt.encoding=''] 輸入responseType為'text'時之解碼字串，例如'big5'，預設''代表utf-8
+ * @param {Integer} [opt.timeout=30000] 輸入單次請求逾時毫秒整數，預設30000
+ * @param {Integer} [opt.maxRetries=10] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設10
+ * @param {Integer} [opt.baseDelayMs=5000] 輸入線性退避之基礎毫秒整數，預設5000
+ * @param {Integer} [opt.maxDelayMs=30000] 輸入線性退避之上限毫秒整數，預設30000
+ * @param {Array} [opt.retryStatus=[]] 輸入額外視為可重試之HTTP狀態碼陣列，例如[403]，預設[]
+ * @param {String} [opt.label=''] 輸入重試訊息前綴字串，預設''
+ * @param {Boolean} [opt.showLog=true] 輸入是否顯示重試訊息布林值，預設true
+ * @returns {Promise} 回傳Promise，resolve回傳解析後資料，responseType為'json'時回物件、'text'時回字串、'arrayBuffer'時回ArrayBuffer，重試耗盡或遇不可重試錯誤時reject回傳錯誤物件
+ * @example
+ *
+ * import fetchWithRetry from './src/fetchWithRetry.mjs'
+ *
+ * let test = async () => {
+ *
+ *     let r = await fetchWithRetry('https://hacker-news.firebaseio.com/v0/item/1.json')
+ *     console.log(r.type, r.by)
+ *     // => 'story' 'pg'
+ *
+ * }
+ * await test()
+ *     .catch((err) => {
+ *         console.log(err)
+ *     })
+ *
+ */
+async function fetchWithRetry(url, opt = {}) {
+
+    //check
+    if (!isestr(url)) {
+        throw new Error(`url須為有效字串, 得到: ${url}`)
+    }
+
+    //method
+    let method = get(opt, 'method')
+    if (!isestr(method)) {
+        method = 'GET'
+    }
+
+    //headers
+    let headers = get(opt, 'headers')
+    if (!isobj(headers)) {
+        headers = {}
+    }
+    if (!isestr(get(headers, 'User-Agent'))) {
+        headers = { 'User-Agent': DEFAULT_UA, ...headers }
+    }
+
+    //body
+    let body = get(opt, 'body', null)
+    if (!isestr(body)) {
+        body = null
+    }
+
+    //responseType
+    let responseType = get(opt, 'responseType')
+    if (responseType !== 'text' && responseType !== 'arrayBuffer') {
+        responseType = 'json'
+    }
+
+    //encoding
+    let encoding = get(opt, 'encoding')
+    if (!isestr(encoding)) {
+        encoding = ''
+    }
+
+    //timeout
+    let timeout = get(opt, 'timeout')
+    if (!ispint(timeout)) {
+        timeout = DEFAULT_TIMEOUT_MS
+    }
+    else {
+        timeout = cint(timeout)
+    }
+
+    //maxRetries
+    let maxRetries = get(opt, 'maxRetries')
+    if (!isp0int(maxRetries)) {
+        maxRetries = DEFAULT_MAX_RETRIES
+    }
+    else {
+        maxRetries = cint(maxRetries)
+    }
+
+    //baseDelayMs
+    let baseDelayMs = get(opt, 'baseDelayMs')
+    if (!ispint(baseDelayMs)) {
+        baseDelayMs = DEFAULT_BASE_DELAY_MS
+    }
+    else {
+        baseDelayMs = cint(baseDelayMs)
+    }
+
+    //maxDelayMs
+    let maxDelayMs = get(opt, 'maxDelayMs')
+    if (!ispint(maxDelayMs)) {
+        maxDelayMs = DEFAULT_MAX_DELAY_MS
+    }
+    else {
+        maxDelayMs = cint(maxDelayMs)
+    }
+
+    //retryStatus
+    let retryStatus = get(opt, 'retryStatus')
+    if (!isearr(retryStatus)) {
+        retryStatus = []
+    }
+
+    //label
+    let label = get(opt, 'label')
+    if (!isestr(label)) {
+        label = 'fetchWithRetry'
+    }
+
+    //showLog
+    let showLog = get(opt, 'showLog')
+    if (!isbol(showLog)) {
+        showLog = true
+    }
+
+    //cfg
+    let cfg = { method, headers, body, responseType, encoding, timeout }
+
+    let lastError = null
+    for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
+
+        try {
+            return await fetchOnce(url, cfg)
+        }
+        catch (err) {
+            lastError = err
+
+            //check, 不可重試或已用盡次數則直接拋出
+            let attemptsLeft = maxRetries + 1 - attempt
+            if (!isRetryableError(err, retryStatus) || attemptsLeft <= 0) {
+                throw err
+            }
+
+            //線性退避
+            let ms = Math.min(baseDelayMs * attempt, maxDelayMs)
+            if (showLog) {
+                console.warn(`[${label}][Retry ${attempt}/${maxRetries}] ${err.message} — 等待 ${ms / 1000}s 後重試...`)
+            }
+            await delay(ms)
+
+        }
+
+    }
+
+    throw lastError
+}
+
+
+export { DEFAULT_UA, isRetryableError }
+export default fetchWithRetry

package/src/getOptFetch.mjs

@@ -0,0 +1,113 @@
+import get from 'lodash-es/get.js'
+import isbol from 'wsemi/src/isbol.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
+import isestr from 'wsemi/src/isestr.mjs'
+import isearr from 'wsemi/src/isearr.mjs'
+import ispint from 'wsemi/src/ispint.mjs'
+import isp0int from 'wsemi/src/isp0int.mjs'
+import cint from 'wsemi/src/cint.mjs'
+
+
+//各抓取函數共用之預設值
+let DEFAULT_TIMEOUT_MS = 30000
+let DEFAULT_MAX_RETRIES = 10
+let DEFAULT_BASE_DELAY_MS = 5000
+let DEFAULT_MAX_DELAY_MS = 30000
+
+
+/**
+ * 取得正整數設定值
+ *
+ * @param {Object} opt 輸入呼叫端設定物件
+ * @param {Object} dflt 輸入各抓取函數之預設值物件
+ * @param {String} key 輸入設定鍵名字串
+ * @param {Integer} fallback 輸入無設定時之預設整數
+ * @returns {Integer} 回傳正整數
+ */
+function pickPint(opt, dflt, key, fallback) {
+
+    let v = get(opt, key)
+    if (ispint(v)) {
+        return cint(v)
+    }
+
+    v = get(dflt, key)
+    if (ispint(v)) {
+        return cint(v)
+    }
+
+    return fallback
+}
+
+
+/**
+ * 正規化抓取設定
+ *
+ * 各抓取函數之timeout、maxRetries、baseDelayMs、maxDelayMs與showLog皆可由呼叫端覆寫,
+ * 未給者取該函數之預設值, 再未給者取全域預設值;
+ * responseType、encoding、headers、retryStatus與label屬各函數固有特性, 僅由dflt指定不開放覆寫
+ *
+ * @param {Object} [opt={}] 輸入呼叫端設定物件，預設{}
+ * @param {Object} [dflt={}] 輸入各抓取函數之預設值物件，預設{}
+ * @returns {Object} 回傳可直接傳入fetchWithRetry之設定物件，另含showLog供呼叫端判斷是否輸出過程訊息
+ * @example
+ *
+ * import getOptFetch from './src/getOptFetch.mjs'
+ *
+ * console.log(getOptFetch({ maxRetries: 2 }, { timeout: 15000, label: 'abc' }))
+ * // => { timeout: 15000, maxRetries: 2, baseDelayMs: 5000, maxDelayMs: 30000, showLog: true, label: 'abc' }
+ *
+ */
+function getOptFetch(opt = {}, dflt = {}) {
+
+    //maxRetries, 可為0故另行處理
+    let maxRetries = get(opt, 'maxRetries')
+    if (!isp0int(maxRetries)) {
+        maxRetries = get(dflt, 'maxRetries')
+    }
+    if (!isp0int(maxRetries)) {
+        maxRetries = DEFAULT_MAX_RETRIES
+    }
+    else {
+        maxRetries = cint(maxRetries)
+    }
+
+    //showLog
+    let showLog = get(opt, 'showLog')
+    if (!isbol(showLog)) {
+        showLog = get(dflt, 'showLog')
+    }
+    if (!isbol(showLog)) {
+        showLog = true
+    }
+
+    let r = {
+        timeout: pickPint(opt, dflt, 'timeout', DEFAULT_TIMEOUT_MS),
+        maxRetries,
+        baseDelayMs: pickPint(opt, dflt, 'baseDelayMs', DEFAULT_BASE_DELAY_MS),
+        maxDelayMs: pickPint(opt, dflt, 'maxDelayMs', DEFAULT_MAX_DELAY_MS),
+        showLog,
+    }
+
+    //各函數固有特性, 不開放呼叫端覆寫
+    if (isestr(get(dflt, 'responseType'))) {
+        r.responseType = dflt.responseType
+    }
+    if (isestr(get(dflt, 'encoding'))) {
+        r.encoding = dflt.encoding
+    }
+    if (isobj(get(dflt, 'headers'))) {
+        r.headers = dflt.headers
+    }
+    if (isearr(get(dflt, 'retryStatus'))) {
+        r.retryStatus = dflt.retryStatus
+    }
+    if (isestr(get(dflt, 'label'))) {
+        r.label = dflt.label
+    }
+
+    return r
+}
+
+
+export default getOptFetch

package/src/htmlToMarkdown.mjs

@@ -0,0 +1,96 @@
+import get from 'lodash-es/get.js'
+import isbol from 'wsemi/src/isbol.mjs'
+import isstr from 'wsemi/src/isstr.mjs'
+import decodeEntities from './decodeEntities.mjs'
+
+
+/**
+ * HTML轉Markdown
+ *
+ * 採正則式逐項轉換, 不引入DOM解析器, 適用於已切出之正文區塊;
+ * 先移除script、style與註解, 再轉換標題、粗體、斜體、換行、連結與段落, 最後清除殘留標籤並收斂空行
+ *
+ * @param {String} html 輸入HTML字串
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {Boolean} [opt.image=false] 輸入是否將img標籤轉為Markdown圖片語法布林值，預設false代表直接移除
+ * @returns {String} 回傳Markdown字串，輸入非字串時回傳''
+ * @example
+ *
+ * import htmlToMarkdown from './src/htmlToMarkdown.mjs'
+ *
+ * console.log(htmlToMarkdown('<p>a<b>b</b></p><p>c</p>'))
+ * // => 'a**b**\n\nc'
+ *
+ * console.log(htmlToMarkdown('<p><img src="a.png" /></p>', { image: true }))
+ * // => '![](a.png)'
+ *
+ */
+function htmlToMarkdown(html, opt = {}) {
+
+    //check
+    if (!isstr(html)) {
+        return ''
+    }
+
+    //image
+    let image = get(opt, 'image')
+    if (!isbol(image)) {
+        image = false
+    }
+
+    let s = html
+
+    //移除script、style與註解
+    s = s.replace(/<script[\s\S]*?<\/script>/gi, '')
+    s = s.replace(/<style[\s\S]*?<\/style>/gi, '')
+    s = s.replace(/<!--[\s\S]*?-->/g, '')
+
+    //img
+    if (image) {
+        s = s.replace(/<img[^>]*src="([^"]+)"[^>]*\/?>/gi, (m, url) => `![](${url})`)
+    }
+
+    //h1-h6轉粗體段落
+    s = s.replace(/<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi, '\n\n**$1**\n\n')
+
+    //strong與b
+    //標籤名後須緊接'>'或空白, 否則<br>會被b規則吃掉而變成'**'(在br規則之前)
+    s = s.replace(/<\/?(?:strong|b)(?:\s[^>]*)?>/gi, '**')
+
+    //em與i
+    //同上, 標籤名後須緊接'>'或空白, 否則<img>會被i規則吃掉而變成'*'
+    s = s.replace(/<\/?(?:em|i)(?:\s[^>]*)?>/gi, '*')
+
+    //br
+    s = s.replace(/<br\s*\/?>/gi, '\n')
+
+    //a
+    s = s.replace(/<a\s+[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/gi, (m, url, text) => {
+        let t = text.replace(/<[^>]+>/g, '').trim()
+        return t ? `[${t}](${url})` : ''
+    })
+
+    //p
+    s = s.replace(/<p(?:\s[^>]*)?>/gi, '')
+    s = s.replace(/<\/p>/gi, '\n\n')
+
+    //雜項容器標籤
+    s = s.replace(/<\/?(?:div|span|section|article|font|u)(?:\s[^>]*)?>/gi, '')
+
+    //其餘殘留標籤
+    s = s.replace(/<[^>]+>/g, '')
+
+    //實體
+    s = decodeEntities(s)
+
+    //行內空白標準化
+    s = s.split('\n').map((l) => l.replace(/[ \t\u00A0]+/g, ' ').trimEnd()).join('\n')
+
+    //多重空行收斂
+    s = s.replace(/\n{3,}/g, '\n\n').replace(/\*\*\s*\*\*/g, '')
+
+    return s.trim()
+}
+
+
+export default htmlToMarkdown

package/src/isYmd.mjs

@@ -0,0 +1,42 @@
+import isestr from 'wsemi/src/isestr.mjs'
+import cint from 'wsemi/src/cint.mjs'
+
+
+/**
+ * 判斷是否為合法之YYYYMMDD日期字串
+ *
+ * 除檢核8碼數字格式外, 另檢核日曆合法性, 例如20260230雖為8碼數字但該日不存在
+ *
+ * @param {String} dateStr 輸入日期字串
+ * @returns {Boolean} 回傳是否為合法YYYYMMDD日期字串之布林值
+ * @example
+ *
+ * import isYmd from './src/isYmd.mjs'
+ *
+ * console.log(isYmd('20260807'), isYmd('20260230'), isYmd('2026-08-07'), isYmd(20260807))
+ * // => true false false false
+ *
+ */
+function isYmd(dateStr) {
+
+    //check
+    if (!isestr(dateStr)) {
+        return false
+    }
+    if (!/^\d{8}$/.test(dateStr)) {
+        return false
+    }
+
+    //y, m, d
+    let y = cint(dateStr.slice(0, 4))
+    let m = cint(dateStr.slice(4, 6))
+    let d = cint(dateStr.slice(6, 8))
+
+    //dt, 由Date回推以檢核日曆合法性
+    let dt = new Date(y, m - 1, d)
+
+    return dt.getFullYear() === y && dt.getMonth() === m - 1 && dt.getDate() === d
+}
+
+
+export default isYmd

package/src/parseIntComma.mjs

@@ -0,0 +1,28 @@
+/**
+ * 含千分位逗號之字串轉整數
+ *
+ * 證交所與櫃買中心之數值欄位皆以逗號分隔千分位, 且缺值以'-'或空字串表示;
+ * 非字串者原樣回傳(該類API之數值欄位偶為number), 無法轉為整數者回傳0
+ *
+ * @param {String} str 輸入含千分位逗號之數值字串
+ * @returns {Number} 回傳整數，非字串輸入時原樣回傳，無法轉換時回傳0
+ * @example
+ *
+ * import parseIntComma from './src/parseIntComma.mjs'
+ *
+ * console.log(parseIntComma('1,234,567'), parseIntComma('-'), parseIntComma(''), parseIntComma(12))
+ * // => 1234567 0 0 12
+ *
+ */
+function parseIntComma(str) {
+
+    //check, 該類API之數值欄位偶為number, 原樣回傳
+    if (typeof str !== 'string') {
+        return str
+    }
+
+    return parseInt(str.replace(/,/g, ''), 10) || 0
+}
+
+
+export default parseIntComma

package/src/safeFilename.mjs

@@ -0,0 +1,30 @@
+import isstr from 'wsemi/src/isstr.mjs'
+
+
+/**
+ * 字串轉安全檔名
+ *
+ * 將Windows與POSIX皆不允許之字元(\/:*?"<>|)替換為底線, 並截斷至200字元以避開檔名長度上限
+ *
+ * @param {String} name 輸入檔名字串
+ * @returns {String} 回傳安全檔名字串
+ * @example
+ *
+ * import safeFilename from './src/safeFilename.mjs'
+ *
+ * console.log(safeFilename('a/b:c*d?e'))
+ * // => 'a_b_c_d_e'
+ *
+ */
+function safeFilename(name) {
+
+    //check
+    if (!isstr(name)) {
+        name = String(name === null || name === undefined ? '' : name)
+    }
+
+    return name.replace(/[\\/:*?"<>|]/g, '_').slice(0, 200)
+}
+
+
+export default safeFilename

package/src/toDatetimeUTC8.mjs

@@ -0,0 +1,71 @@
+import ot from 'dayjs'
+import utc from 'dayjs/plugin/utc.js'
+import isnum from 'wsemi/src/isnum.mjs'
+import isestr from 'wsemi/src/isestr.mjs'
+
+
+//utc外掛, dayjs核心之format()一律以執行環境時區輸出, 需掛utc外掛才能以utcOffset指定固定偏移
+ot.extend(utc)
+
+
+//台灣時區偏移小時數, 台灣自1980年起無日光節約時間, 故固定為UTC+8
+let TZ_OFFSET_HOUR = 8
+
+
+//輸出格式
+let FORMAT = 'YYYY-MM-DD HH:mm:ss'
+
+
+/**
+ * 時間轉UTC+8之日期時間字串
+ *
+ * 可接受ISO時間字串、RFC822時間字串、unix秒數(非毫秒)或Date物件, 一律輸出台灣時間'YYYY-MM-DD HH:mm:ss';
+ * 以dayjs之utc外掛指定固定偏移+8, 不受執行環境時區影響(在UTC伺服器上結果相同)
+ *
+ * @param {String|Number|Date} value 輸入ISO或RFC822時間字串、unix秒數或Date物件
+ * @returns {String} 回傳UTC+8之日期時間字串，格式為'YYYY-MM-DD HH:mm:ss'，輸入為空或無法解析時回傳''
+ * @example
+ *
+ * import toDatetimeUTC8 from './src/toDatetimeUTC8.mjs'
+ *
+ * console.log(toDatetimeUTC8('2026-08-07T01:02:03Z'))
+ * // => '2026-08-07 09:02:03'
+ *
+ * console.log(toDatetimeUTC8(1786000000))
+ * // => '2026-08-06 15:06:40'
+ *
+ * console.log(toDatetimeUTC8('abc'), toDatetimeUTC8(''), toDatetimeUTC8(null))
+ * // => '' '' ''
+ *
+ */
+function toDatetimeUTC8(value) {
+
+    let dt = null
+
+    //數值一律視為unix秒數, dayjs之ot(number)為毫秒故須改用ot.unix
+    if (isnum(value)) {
+        if (value === 0) {
+            return ''
+        }
+        dt = ot.unix(value)
+    }
+    else if (value instanceof Date) {
+        dt = ot(value)
+    }
+    else if (isestr(value)) {
+        dt = ot(value)
+    }
+    else {
+        return ''
+    }
+
+    //check
+    if (!dt.isValid()) {
+        return ''
+    }
+
+    return dt.utcOffset(TZ_OFFSET_HOUR).format(FORMAT)
+}
+
+
+export default toDatetimeUTC8