@first-ch/tools-mcp 0.4.0 → 0.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +132 -30
- package/aspect-ratio.mjs +706 -0
- package/base64.mjs +356 -0
- package/color.mjs +629 -0
- package/cron.mjs +633 -0
- package/diff.mjs +322 -0
- package/hash.mjs +234 -0
- package/html-escape.mjs +308 -0
- package/json-yaml.mjs +1693 -0
- package/jwt.mjs +639 -0
- package/lib.mjs +103 -0
- package/markdown-table.mjs +641 -0
- package/marp-theme.css +51 -0
- package/marp.mjs +219 -0
- package/package.json +132 -6
- package/px-rem.mjs +488 -0
- package/qr.mjs +744 -0
- package/server.mjs +942 -2
- package/sql-format.mjs +694 -0
- package/testdata.mjs +608 -0
- package/unixtime.mjs +505 -0
- package/url.mjs +415 -0
- package/user-agent.mjs +633 -0
- package/uuid.mjs +238 -0
- package/vendor/jsquash-webp/CHECKSUMS.sha256 +10 -0
package/unixtime.mjs
ADDED
|
@@ -0,0 +1,505 @@
|
|
|
1
|
+
/* UNIXタイムスタンプ⇄日時変換(unixtime_convert)
|
|
2
|
+
* アルゴリズムは FirstCHTools の site/unixtime/app.js と同一
|
|
3
|
+
* (2箇所ルール: site側が正本・片方を直したらもう片方も同じ内容で反映する)。
|
|
4
|
+
* 下の「変換コア」は site 側からそのまま持ってきたもので、両ファイルから
|
|
5
|
+
* コアの開始/終了コメントに挟まれた範囲を sed で切り出し(site側は字下げ2文字を落とす)、
|
|
6
|
+
* diff が空になることで同期を機械的に確認できる。
|
|
7
|
+
*
|
|
8
|
+
* 数値は桁数から単位を推定し(10桁まで秒 / 13桁までミリ秒 / 16桁までマイクロ秒 / それ以上ナノ秒)、
|
|
9
|
+
* 日時側は ISO 8601・`YYYY/M/D H:mm`・和文表記・HTTP-date・`now` を受け付ける。
|
|
10
|
+
* オフセットを持たない日時は指定タイムゾーンの壁時計として解釈し、その旨を notes で返す。 */
|
|
11
|
+
|
|
12
|
+
/* ==== ここから変換コア(site / MCP で同一) ==== */
|
|
13
|
+
|
|
14
|
+
const MAX_MS = 8.64e15; // ECMAScript の Date が表せる範囲(±約27万年)
|
|
15
|
+
const MAX_ROWS = 500;
|
|
16
|
+
|
|
17
|
+
const UNIT_LABEL = {
|
|
18
|
+
s: { ja: 'UNIX秒', en: 'Unix seconds' },
|
|
19
|
+
ms: { ja: 'UNIXミリ秒', en: 'Unix milliseconds' },
|
|
20
|
+
us: { ja: 'UNIXマイクロ秒', en: 'Unix microseconds' },
|
|
21
|
+
ns: { ja: 'UNIXナノ秒', en: 'Unix nanoseconds' },
|
|
22
|
+
};
|
|
23
|
+
const KIND_LABEL = {
|
|
24
|
+
iso: { ja: 'ISO 8601', en: 'ISO 8601' },
|
|
25
|
+
datetime: { ja: '日時文字列', en: 'Date & time' },
|
|
26
|
+
now: { ja: '現在時刻', en: 'Current time' },
|
|
27
|
+
};
|
|
28
|
+
const ERROR_TEXT = {
|
|
29
|
+
unparsable: {
|
|
30
|
+
ja: '数値としても日時としても読めません。',
|
|
31
|
+
en: 'Not readable as a number or a date.',
|
|
32
|
+
},
|
|
33
|
+
range: {
|
|
34
|
+
ja: '扱える範囲(西暦±27万年ほど)を超えています。単位の指定が合っているか確認してください。',
|
|
35
|
+
en: 'Outside the range a date can represent (about ±270,000 years). Check that the unit is right.',
|
|
36
|
+
},
|
|
37
|
+
invalidDate: {
|
|
38
|
+
ja: '存在しない日付・時刻です。',
|
|
39
|
+
en: 'That date or time does not exist.',
|
|
40
|
+
},
|
|
41
|
+
badZone: {
|
|
42
|
+
ja: 'タイムゾーン名を解決できません。',
|
|
43
|
+
en: 'That time zone name cannot be resolved.',
|
|
44
|
+
},
|
|
45
|
+
};
|
|
46
|
+
const NOTE_TEXT = {
|
|
47
|
+
truncated: {
|
|
48
|
+
ja: 'ミリ秒より下の桁は切り捨てました。',
|
|
49
|
+
en: 'Digits below the millisecond were dropped.',
|
|
50
|
+
},
|
|
51
|
+
ymdLike: {
|
|
52
|
+
ja: 'YYYYMMDD の日付ではなくUNIX秒として解釈しました(日付として読むなら 2026-08-24 の形で入れてください)。',
|
|
53
|
+
en: 'Read as Unix seconds, not as a YYYYMMDD date (write it as 2026-08-24 to read it as a date).',
|
|
54
|
+
},
|
|
55
|
+
zoneAssumed: {
|
|
56
|
+
ja: 'オフセットが無いため、選択中のタイムゾーンの時刻として解釈しました。',
|
|
57
|
+
en: 'No offset in the input, so it was read as a local time in the selected time zone.',
|
|
58
|
+
},
|
|
59
|
+
dstShift: {
|
|
60
|
+
ja: 'そのタイムゾーンに存在しない時刻(夏時間の切り替え)のため、繰り上げて解釈しました。',
|
|
61
|
+
en: 'That wall-clock time does not exist in this zone (DST change), so it was moved forward.',
|
|
62
|
+
},
|
|
63
|
+
unitForced: {
|
|
64
|
+
ja: '単位の自動判定を使わず、指定された単位で読みました。',
|
|
65
|
+
en: 'Read with the unit you picked instead of auto-detection.',
|
|
66
|
+
},
|
|
67
|
+
};
|
|
68
|
+
|
|
69
|
+
const fmtCache = new Map();
|
|
70
|
+
function partsFormatter(timeZone) {
|
|
71
|
+
let f = fmtCache.get(timeZone);
|
|
72
|
+
if (!f) {
|
|
73
|
+
f = new Intl.DateTimeFormat('en-US', {
|
|
74
|
+
timeZone,
|
|
75
|
+
hourCycle: 'h23',
|
|
76
|
+
year: 'numeric',
|
|
77
|
+
month: '2-digit',
|
|
78
|
+
day: '2-digit',
|
|
79
|
+
hour: '2-digit',
|
|
80
|
+
minute: '2-digit',
|
|
81
|
+
second: '2-digit',
|
|
82
|
+
era: 'short',
|
|
83
|
+
});
|
|
84
|
+
fmtCache.set(timeZone, f);
|
|
85
|
+
}
|
|
86
|
+
return f;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** 実時刻(ms) → そのタイムゾーンの壁時計 */
|
|
90
|
+
function tzParts(ms, timeZone) {
|
|
91
|
+
const o = {};
|
|
92
|
+
for (const p of partsFormatter(timeZone).formatToParts(new Date(ms))) {
|
|
93
|
+
if (p.type !== 'literal') o[p.type] = p.value;
|
|
94
|
+
}
|
|
95
|
+
let y = +o.year;
|
|
96
|
+
if (/^B/.test(o.era || '')) y = 1 - y; // 紀元前は 1BC = 0年 として数える
|
|
97
|
+
return { y, mo: +o.month, d: +o.day, h: +o.hour, mi: +o.minute, s: +o.second };
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
function tzOffset(ms, timeZone) {
|
|
101
|
+
const p = tzParts(ms, timeZone);
|
|
102
|
+
return makeUTC(p.y, p.mo, p.d, p.h, p.mi, p.s, 0) - Math.floor(ms / 1000) * 1000;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/** 壁時計 → 実時刻(ms)。オフセットを2回引き直してDSTの境目でもずれないようにする */
|
|
106
|
+
function zonedToMs(w, timeZone) {
|
|
107
|
+
const guess = makeUTC(w.y, w.mo, w.d, w.h, w.mi, w.s, 0);
|
|
108
|
+
const first = guess - tzOffset(guess, timeZone);
|
|
109
|
+
const second = guess - tzOffset(first, timeZone);
|
|
110
|
+
// 夏時間で飛ばされて存在しない壁時計は、2回目が切り替え前へ戻ってしまう。
|
|
111
|
+
// その場合は1回目(=切り替え後へ繰り上げた時刻)を採る。
|
|
112
|
+
const back = tzParts(second, timeZone);
|
|
113
|
+
if (back.h !== w.h || back.mi !== w.mi || back.d !== w.d) return first;
|
|
114
|
+
return second;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** Date.UTC は 0〜99年を1900年代に丸めるため、年は必ず setUTCFullYear で入れ直す */
|
|
118
|
+
function makeUTC(y, mo, d, h, mi, s, msPart) {
|
|
119
|
+
const dt = new Date(0);
|
|
120
|
+
dt.setUTCFullYear(2000, mo - 1, d);
|
|
121
|
+
dt.setUTCHours(h, mi, s, msPart);
|
|
122
|
+
dt.setUTCFullYear(y);
|
|
123
|
+
return dt.getTime();
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
function isValidTimeZone(tz) {
|
|
127
|
+
if (!tz || typeof tz !== 'string') return false;
|
|
128
|
+
try {
|
|
129
|
+
new Intl.DateTimeFormat('en-US', { timeZone: tz });
|
|
130
|
+
return true;
|
|
131
|
+
} catch (e) {
|
|
132
|
+
return false;
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
const pad = (n, w) => String(Math.abs(n)).padStart(w, '0');
|
|
137
|
+
const yearText = (y) => (y < 0 ? '-' + pad(y, 4) : pad(y, 4));
|
|
138
|
+
/** その年月の日数。うるう年を年ごとに正しく数えるため、必ず対象の年で計算する */
|
|
139
|
+
function daysInMonth(y, mo) {
|
|
140
|
+
const dt = new Date(0);
|
|
141
|
+
dt.setUTCFullYear(y, mo, 1); // mo は1始まりなので月インデックスとしては翌月
|
|
142
|
+
dt.setUTCHours(0, 0, 0, 0);
|
|
143
|
+
dt.setUTCDate(0); // 前月末日=対象月の末日
|
|
144
|
+
return dt.getUTCDate();
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
function offsetText(ms, timeZone) {
|
|
148
|
+
const min = Math.round(tzOffset(ms, timeZone) / 60000);
|
|
149
|
+
const sign = min < 0 ? '-' : '+';
|
|
150
|
+
return sign + pad(Math.trunc(Math.abs(min) / 60), 2) + ':' + pad(Math.abs(min) % 60, 2);
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
function dowOf(y, mo, d) {
|
|
154
|
+
return new Date(makeUTC(y, mo, d, 12, 0, 0, 0)).getUTCDay();
|
|
155
|
+
}
|
|
156
|
+
const DOW = {
|
|
157
|
+
ja: ['日', '月', '火', '水', '木', '金', '土'],
|
|
158
|
+
en: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
|
|
159
|
+
};
|
|
160
|
+
|
|
161
|
+
/** BigInt の切り捨て除算(負数でも下方向へ丸める) */
|
|
162
|
+
function bigFloorDiv(a, b) {
|
|
163
|
+
const q = a / b;
|
|
164
|
+
return a % b !== 0n && a < 0n !== b < 0n ? q - 1n : q;
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/** 桁数から単位を推定する。10桁までは秒、13桁までミリ秒、16桁までマイクロ秒、それ以上はナノ秒 */
|
|
168
|
+
function autoUnit(intStr) {
|
|
169
|
+
const n = intStr.replace(/^0+(?=\d)/, '').length;
|
|
170
|
+
if (n <= 10) return 's';
|
|
171
|
+
if (n <= 13) return 'ms';
|
|
172
|
+
if (n <= 16) return 'us';
|
|
173
|
+
return 'ns';
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
const NUM_RE = /^([+-]?)(\d+)(?:[.,](\d+))?$/;
|
|
177
|
+
const DT_RE = /^(\d{1,6})[-/.](\d{1,2})[-/.](\d{1,2})(?:[T\s]+(\d{1,2}):(\d{1,2})(?::(\d{1,2}))?(?:[.,](\d{1,9}))?)?(?:\s*(Z|UTC|GMT|[+-]\d{1,2}(?::?\d{2})?))?$/i;
|
|
178
|
+
const RFC_RE = /^(?:[A-Za-z]{3,9},?\s+)?(\d{1,2})[\s-]+([A-Za-z]{3,9})[\s-]+(\d{2,6})(?:\s+(\d{1,2}):(\d{1,2})(?::(\d{1,2}))?)?(?:\s*(Z|UTC|GMT|[+-]\d{2}:?\d{2}))?$/;
|
|
179
|
+
const MONTHS = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
|
|
180
|
+
|
|
181
|
+
/** 全角・和文表記をASCIIの日時表記へ寄せる */
|
|
182
|
+
function normalizeInput(raw) {
|
|
183
|
+
let s = String(raw)
|
|
184
|
+
.replace(/[0-9]/g, (c) => String.fromCharCode(c.charCodeAt(0) - 0xfee0))
|
|
185
|
+
.replace(/[/:-+.]/g, (c) => ({ '/': '/', ':': ':', '-': '-', '+': '+', '.': '.' }[c]))
|
|
186
|
+
.replace(/ /g, ' ')
|
|
187
|
+
.trim();
|
|
188
|
+
// 引用符・括弧・区切りのカンマは、CSVやJSONから貼ったときに前後へ付いてくるので剥がす
|
|
189
|
+
let prev;
|
|
190
|
+
do {
|
|
191
|
+
prev = s;
|
|
192
|
+
s = s.replace(/^[\s"'`[(<]+/, '').replace(/[\s"'`\])>,;]+$/, '');
|
|
193
|
+
} while (s !== prev);
|
|
194
|
+
s = s.replace(/(\d{1,6})年\s*(\d{1,2})月\s*(\d{1,2})日/, '$1-$2-$3');
|
|
195
|
+
s = s.replace(/(\d{1,2})時\s*(\d{1,2})分\s*(?:(\d{1,2})秒)?/, (m, h, mi, sec) => `${h}:${mi}` + (sec ? `:${sec}` : ''));
|
|
196
|
+
s = s.replace(/^@/, '');
|
|
197
|
+
return s.trim();
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
function offsetMinutesOf(spec) {
|
|
201
|
+
if (!spec) return null;
|
|
202
|
+
const t = spec.toUpperCase();
|
|
203
|
+
if (t === 'Z' || t === 'UTC' || t === 'GMT') return 0;
|
|
204
|
+
const m = /^([+-])(\d{1,2}):?(\d{2})?$/.exec(t);
|
|
205
|
+
if (!m) return null;
|
|
206
|
+
const v = +m[2] * 60 + (m[3] ? +m[3] : 0);
|
|
207
|
+
return m[1] === '-' ? -v : v;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/** 1行を解析して実時刻(ms)にする。読めない行は ok:false で返す */
|
|
211
|
+
function parseOne(raw, opts) {
|
|
212
|
+
const timeZone = opts.timeZone;
|
|
213
|
+
const unitOpt = opts.unit || 'auto';
|
|
214
|
+
const notes = [];
|
|
215
|
+
const original = String(raw).trim();
|
|
216
|
+
const s = normalizeInput(raw);
|
|
217
|
+
if (!s) return null;
|
|
218
|
+
|
|
219
|
+
const fail = (code) => ({ ok: false, input: original, error: code });
|
|
220
|
+
|
|
221
|
+
if (/^(now|today|current|今|いま|現在|現在時刻)$/i.test(s)) {
|
|
222
|
+
return finish(opts.now, 'now', null, notes, original, opts);
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
const num = NUM_RE.exec(s);
|
|
226
|
+
if (num) {
|
|
227
|
+
const neg = num[1] === '-';
|
|
228
|
+
const intStr = num[2];
|
|
229
|
+
const frac = num[3] || '';
|
|
230
|
+
const unit = unitOpt === 'auto' ? autoUnit(intStr) : unitOpt;
|
|
231
|
+
if (unitOpt !== 'auto' && unitOpt !== autoUnit(intStr)) notes.push(['unitForced']);
|
|
232
|
+
const sign = neg ? -1n : 1n;
|
|
233
|
+
const big = BigInt(intStr) * sign;
|
|
234
|
+
let msBig;
|
|
235
|
+
let cut = false;
|
|
236
|
+
if (unit === 's') {
|
|
237
|
+
msBig = big * 1000n + sign * BigInt((frac + '000').slice(0, 3));
|
|
238
|
+
if (frac.length > 3 && /[1-9]/.test(frac.slice(3))) cut = true;
|
|
239
|
+
} else if (unit === 'ms') {
|
|
240
|
+
msBig = big;
|
|
241
|
+
if (/[1-9]/.test(frac)) cut = true;
|
|
242
|
+
} else {
|
|
243
|
+
const div = unit === 'us' ? 1000n : 1000000n;
|
|
244
|
+
msBig = bigFloorDiv(big, div);
|
|
245
|
+
if (big % div !== 0n || /[1-9]/.test(frac)) cut = true;
|
|
246
|
+
}
|
|
247
|
+
if (cut) notes.push(['truncated']);
|
|
248
|
+
if (unit === 's' && intStr.length === 8 && looksLikeYmd(intStr)) notes.push(['ymdLike']);
|
|
249
|
+
const ms = Number(msBig);
|
|
250
|
+
if (!Number.isFinite(ms) || Math.abs(ms) > MAX_MS) return fail('range');
|
|
251
|
+
return finish(ms, unit, unit, notes, original, opts);
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
let y;
|
|
255
|
+
let mo;
|
|
256
|
+
let d;
|
|
257
|
+
let h = 0;
|
|
258
|
+
let mi = 0;
|
|
259
|
+
let sec = 0;
|
|
260
|
+
let msPart = 0;
|
|
261
|
+
let offSpec = null;
|
|
262
|
+
|
|
263
|
+
const dt = DT_RE.exec(s);
|
|
264
|
+
const rfc = dt ? null : RFC_RE.exec(s);
|
|
265
|
+
if (dt) {
|
|
266
|
+
y = +dt[1];
|
|
267
|
+
mo = +dt[2];
|
|
268
|
+
d = +dt[3];
|
|
269
|
+
h = dt[4] ? +dt[4] : 0;
|
|
270
|
+
mi = dt[5] ? +dt[5] : 0;
|
|
271
|
+
sec = dt[6] ? +dt[6] : 0;
|
|
272
|
+
msPart = dt[7] ? +(dt[7] + '000').slice(0, 3) : 0;
|
|
273
|
+
if (dt[7] && dt[7].length > 3 && /[1-9]/.test(dt[7].slice(3))) notes.push(['truncated']);
|
|
274
|
+
offSpec = dt[8] || null;
|
|
275
|
+
} else if (rfc) {
|
|
276
|
+
const mi3 = MONTHS.indexOf(rfc[2].slice(0, 3).toLowerCase());
|
|
277
|
+
if (mi3 < 0) return fail('unparsable');
|
|
278
|
+
d = +rfc[1];
|
|
279
|
+
mo = mi3 + 1;
|
|
280
|
+
y = +rfc[3];
|
|
281
|
+
if (rfc[3].length === 2) y += y < 70 ? 2000 : 1900;
|
|
282
|
+
h = rfc[4] ? +rfc[4] : 0;
|
|
283
|
+
mi = rfc[5] ? +rfc[5] : 0;
|
|
284
|
+
sec = rfc[6] ? +rfc[6] : 0;
|
|
285
|
+
offSpec = rfc[7] || null;
|
|
286
|
+
} else {
|
|
287
|
+
return fail('unparsable');
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
if (mo < 1 || mo > 12 || d < 1 || d > daysInMonth(y, mo)) return fail('invalidDate');
|
|
291
|
+
if (h > 23 || mi > 59 || sec > 60) return fail('invalidDate');
|
|
292
|
+
if (sec === 60) sec = 59; // うるう秒はその分の59秒に寄せる
|
|
293
|
+
|
|
294
|
+
let ms;
|
|
295
|
+
if (offSpec) {
|
|
296
|
+
const off = offsetMinutesOf(offSpec);
|
|
297
|
+
if (off === null) return fail('unparsable');
|
|
298
|
+
ms = makeUTC(y, mo, d, h, mi, sec, msPart) - off * 60000;
|
|
299
|
+
} else {
|
|
300
|
+
if (!isValidTimeZone(timeZone)) return fail('badZone');
|
|
301
|
+
ms = zonedToMs({ y, mo, d, h, mi, s: sec }, timeZone) + msPart;
|
|
302
|
+
const back = tzParts(ms, timeZone);
|
|
303
|
+
if (back.h !== h || back.mi !== mi || back.d !== d) notes.push(['dstShift']);
|
|
304
|
+
notes.push(['zoneAssumed']);
|
|
305
|
+
}
|
|
306
|
+
if (!Number.isFinite(ms) || Math.abs(ms) > MAX_MS) return fail('range');
|
|
307
|
+
return finish(ms, dt && offSpec ? 'iso' : 'datetime', null, notes, original, opts);
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
function looksLikeYmd(intStr) {
|
|
311
|
+
const y = +intStr.slice(0, 4);
|
|
312
|
+
const mo = +intStr.slice(4, 6);
|
|
313
|
+
const d = +intStr.slice(6, 8);
|
|
314
|
+
return y >= 1900 && y <= 2999 && mo >= 1 && mo <= 12 && d >= 1 && d <= daysInMonth(y, mo);
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
/** 実時刻(ms) から表示用の各表記を組み立てる */
|
|
318
|
+
function finish(ms, kind, unit, notes, original, opts) {
|
|
319
|
+
const timeZone = isValidTimeZone(opts.timeZone) ? opts.timeZone : 'UTC';
|
|
320
|
+
const u = tzParts(ms, 'UTC');
|
|
321
|
+
const p = tzParts(ms, timeZone);
|
|
322
|
+
const sub = ((ms % 1000) + 1000) % 1000;
|
|
323
|
+
const frac = sub ? '.' + pad(sub, 3) : '';
|
|
324
|
+
const hms = (q) => `${pad(q.h, 2)}:${pad(q.mi, 2)}:${pad(q.s, 2)}`;
|
|
325
|
+
const ymd = (q) => `${yearText(q.y)}-${pad(q.mo, 2)}-${pad(q.d, 2)}`;
|
|
326
|
+
const off = offsetText(ms, timeZone);
|
|
327
|
+
return {
|
|
328
|
+
ok: true,
|
|
329
|
+
input: original,
|
|
330
|
+
kind,
|
|
331
|
+
unit: unit || null,
|
|
332
|
+
ms,
|
|
333
|
+
seconds: Math.floor(ms / 1000),
|
|
334
|
+
millis: ms,
|
|
335
|
+
iso: `${ymd(u)}T${hms(u)}${frac}Z`,
|
|
336
|
+
isoLocal: `${ymd(p)}T${hms(p)}${frac}${off}`,
|
|
337
|
+
local: `${ymd(p)} ${hms(p)}${frac}`,
|
|
338
|
+
timeZone,
|
|
339
|
+
offset: off,
|
|
340
|
+
dow: dowOf(p.y, p.mo, p.d),
|
|
341
|
+
relativeMs: ms - opts.now,
|
|
342
|
+
notes,
|
|
343
|
+
};
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
/** 相対表示(○分前 / in 3 hours)。基準は opts.now */
|
|
347
|
+
function relativeText(diffMs, lang) {
|
|
348
|
+
const future = diffMs > 0;
|
|
349
|
+
const abs = Math.abs(diffMs);
|
|
350
|
+
const ja = lang !== 'en';
|
|
351
|
+
if (abs < 5000) return ja ? 'たった今' : 'just now';
|
|
352
|
+
// [1単位の長さ, その単位を使う上限, 表記]。上限は次の単位ちょうどなので、
|
|
353
|
+
// 365日を「11か月」ではなく「1年」と読ませられる。
|
|
354
|
+
const steps = [
|
|
355
|
+
[1000, 60000, { ja: '秒', en: 'second' }],
|
|
356
|
+
[60000, 3600000, { ja: '分', en: 'minute' }],
|
|
357
|
+
[3600000, 86400000, { ja: '時間', en: 'hour' }],
|
|
358
|
+
[86400000, 2629800000, { ja: '日', en: 'day' }],
|
|
359
|
+
[2629800000, 31536000000, { ja: 'か月', en: 'month' }], // 365日ちょうどで「1年」に切り替える
|
|
360
|
+
[31557600000, Infinity, { ja: '年', en: 'year' }],
|
|
361
|
+
];
|
|
362
|
+
for (const [size, limit, label] of steps) {
|
|
363
|
+
if (abs < limit) {
|
|
364
|
+
const v = Math.floor(abs / size);
|
|
365
|
+
const n = Math.max(1, v);
|
|
366
|
+
if (ja) return `${n}${label.ja}${future ? '後' : '前'}`;
|
|
367
|
+
const unit = label.en + (n === 1 ? '' : 's');
|
|
368
|
+
return future ? `in ${n} ${unit}` : `${n} ${unit} ago`;
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
return ja ? '不明' : 'unknown';
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
function kindLabel(row, lang) {
|
|
375
|
+
const ja = lang !== 'en';
|
|
376
|
+
const t = row.unit ? UNIT_LABEL[row.unit] : KIND_LABEL[row.kind];
|
|
377
|
+
return t ? (ja ? t.ja : t.en) : row.kind;
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
function noteLabel(note, lang) {
|
|
381
|
+
const t = NOTE_TEXT[note[0]];
|
|
382
|
+
return t ? (lang === 'en' ? t.en : t.ja) : note[0];
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
function errorLabel(code, lang) {
|
|
386
|
+
const t = ERROR_TEXT[code];
|
|
387
|
+
return t ? (lang === 'en' ? t.en : t.ja) : code;
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
/**
|
|
391
|
+
* 複数行をまとめて変換する。
|
|
392
|
+
* opts: { timeZone, unit: 'auto'|'s'|'ms'|'us'|'ns', now }
|
|
393
|
+
*/
|
|
394
|
+
function convertAll(text, opts) {
|
|
395
|
+
const o = {
|
|
396
|
+
timeZone: isValidTimeZone(opts && opts.timeZone) ? opts.timeZone : 'UTC',
|
|
397
|
+
unit: (opts && opts.unit) || 'auto',
|
|
398
|
+
now: opts && Number.isFinite(opts.now) ? opts.now : Date.now(),
|
|
399
|
+
};
|
|
400
|
+
const lines = String(text == null ? '' : text).split(/\r\n|\r|\n/);
|
|
401
|
+
const rows = [];
|
|
402
|
+
let truncatedRows = false;
|
|
403
|
+
for (const line of lines) {
|
|
404
|
+
if (rows.length >= MAX_ROWS) {
|
|
405
|
+
if (line.trim()) truncatedRows = true;
|
|
406
|
+
continue;
|
|
407
|
+
}
|
|
408
|
+
const r = parseOne(line, o);
|
|
409
|
+
if (r) rows.push(r);
|
|
410
|
+
}
|
|
411
|
+
return {
|
|
412
|
+
timeZone: o.timeZone,
|
|
413
|
+
unit: o.unit,
|
|
414
|
+
now: o.now,
|
|
415
|
+
rows,
|
|
416
|
+
ok: rows.filter((r) => r.ok).length,
|
|
417
|
+
ng: rows.filter((r) => !r.ok).length,
|
|
418
|
+
truncatedRows,
|
|
419
|
+
};
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
/* ==== ここまで変換コア ==== */
|
|
423
|
+
|
|
424
|
+
export class UnixTimeError extends Error {
|
|
425
|
+
constructor(message) {
|
|
426
|
+
super(message);
|
|
427
|
+
this.name = 'UnixTimeError';
|
|
428
|
+
}
|
|
429
|
+
}
|
|
430
|
+
|
|
431
|
+
const UNITS = ['auto', 's', 'ms', 'us', 'ns'];
|
|
432
|
+
|
|
433
|
+
/** now は ms の数値か、解釈できる日時文字列を受ける(未指定なら実行時刻) */
|
|
434
|
+
function resolveNow(now) {
|
|
435
|
+
if (now === undefined || now === null || now === '') return Date.now();
|
|
436
|
+
if (typeof now === 'number') {
|
|
437
|
+
if (!Number.isFinite(now) || Math.abs(now) > MAX_MS) throw new UnixTimeError(`now が扱える範囲を超えています: ${now}`);
|
|
438
|
+
return now;
|
|
439
|
+
}
|
|
440
|
+
const r = parseOne(String(now), { timeZone: 'UTC', unit: 'auto', now: Date.now() });
|
|
441
|
+
if (!r || !r.ok) throw new UnixTimeError(`now を日時として読めません: ${now}`);
|
|
442
|
+
return r.ms;
|
|
443
|
+
}
|
|
444
|
+
|
|
445
|
+
/**
|
|
446
|
+
* UNIXタイムスタンプと日時表記を相互変換する(tools.first-ch.com/unixtime/ と同一ロジック)。
|
|
447
|
+
*
|
|
448
|
+
* @param {string} input 1行1件の入力(数値・ISO 8601・日時文字列・now)
|
|
449
|
+
* @param {object} [opts]
|
|
450
|
+
* @param {string} [opts.timeZone='UTC'] 現地時刻に使うIANAタイムゾーン名
|
|
451
|
+
* @param {'auto'|'s'|'ms'|'us'|'ns'} [opts.unit='auto'] 数値の単位(既定は桁数からの自動判定)
|
|
452
|
+
* @param {number|string} [opts.now] 相対表示の基準時刻(既定は実行時刻)
|
|
453
|
+
* @param {'ja'|'en'} [opts.lang='ja'] ラベル・相対表示・注記の言語
|
|
454
|
+
* @returns {object}
|
|
455
|
+
*/
|
|
456
|
+
export function unixtimeConvert(input, opts = {}) {
|
|
457
|
+
if (typeof input !== 'string' || input.trim() === '') {
|
|
458
|
+
throw new UnixTimeError('変換する値が空です(1行に1件で渡してください)');
|
|
459
|
+
}
|
|
460
|
+
const timeZone = opts.timeZone === undefined || opts.timeZone === null || opts.timeZone === '' ? 'UTC' : String(opts.timeZone);
|
|
461
|
+
if (!isValidTimeZone(timeZone)) {
|
|
462
|
+
throw new UnixTimeError(`タイムゾーン名を解決できません: ${timeZone}(例: UTC / Asia/Tokyo / America/New_York)`);
|
|
463
|
+
}
|
|
464
|
+
const unit = opts.unit === undefined || opts.unit === null ? 'auto' : String(opts.unit);
|
|
465
|
+
if (UNITS.indexOf(unit) === -1) {
|
|
466
|
+
throw new UnixTimeError(`unit は ${UNITS.join(' / ')} のいずれかを指定してください(受け取った値: ${opts.unit})`);
|
|
467
|
+
}
|
|
468
|
+
const lang = opts.lang === 'en' ? 'en' : 'ja';
|
|
469
|
+
const now = resolveNow(opts.now);
|
|
470
|
+
|
|
471
|
+
const res = convertAll(input, { timeZone, unit, now });
|
|
472
|
+
const nowRow = finish(now, 'now', null, [], String(now), { timeZone, now });
|
|
473
|
+
|
|
474
|
+
return {
|
|
475
|
+
time_zone: res.timeZone,
|
|
476
|
+
utc_offset: nowRow.offset,
|
|
477
|
+
unit: res.unit,
|
|
478
|
+
now: {
|
|
479
|
+
unix_seconds: nowRow.seconds,
|
|
480
|
+
unix_millis: nowRow.millis,
|
|
481
|
+
iso_utc: nowRow.iso,
|
|
482
|
+
local: `${nowRow.local} (${DOW[lang][nowRow.dow]})`,
|
|
483
|
+
},
|
|
484
|
+
converted: res.ok,
|
|
485
|
+
unreadable: res.ng,
|
|
486
|
+
rows: res.rows.map((r) =>
|
|
487
|
+
r.ok
|
|
488
|
+
? {
|
|
489
|
+
input: r.input,
|
|
490
|
+
read_as: kindLabel(r, lang),
|
|
491
|
+
unix_seconds: r.seconds,
|
|
492
|
+
unix_millis: r.millis,
|
|
493
|
+
iso_utc: r.iso,
|
|
494
|
+
iso_local: r.isoLocal,
|
|
495
|
+
local: r.local,
|
|
496
|
+
weekday: DOW[lang][r.dow],
|
|
497
|
+
utc_offset: r.offset,
|
|
498
|
+
relative: relativeText(r.relativeMs, lang),
|
|
499
|
+
notes: r.notes.map((n) => ({ code: n[0], message: noteLabel(n, lang) })),
|
|
500
|
+
}
|
|
501
|
+
: { input: r.input, error: { code: r.error, message: errorLabel(r.error, lang) } },
|
|
502
|
+
),
|
|
503
|
+
truncated: res.truncatedRows ? `先頭 ${MAX_ROWS} 行までを変換しました` : undefined,
|
|
504
|
+
};
|
|
505
|
+
}
|