EET 辅助工具使用场景

本文档按使用场景整理 convert、ts、int-to-bytes 三个辅助命令组的典型用法，便于快速查找与参考。

一、字符串格式转换（convert）

1.1 编码场景

场景	命令	描述
将明文转为 Base64 便于传输或存储	`eet convert utf8-to-base64 -i "待编码文本"`	适用于 HTTP Header、JSON 中嵌入二进制、配置文件等需要可打印字符的场景
将明文转为 Hex 便于调试或协议对接	`eet convert utf8-to-hex -i "待编码文本"`	适用于日志脱敏、协议字段、数据库存储等需要十六进制表示的场景
管道输出仅 Base64 值	`eet convert utf8-to-base64 -i "hello" --raw`	便于直接复制或作为下一命令输入

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
eet convert utf8-to-base64 -i "待编码文本"
{
  "metadata": {
    "operation": "encode",
    "algorithm": "utf8-to-base64",
    "encoding": "base64",
    "input": {
      "type": "text",
      "size": 15
    },
    "parameters": {
      "source": "utf-8",
      "target": "base64"
    }
  },
  "result": {
    "value": "5b6F57yW56CB5paH5pys"
  },
  "runtime": {
    "request_id": "b8d42079-d9df-4c62-9597-a78f3881f921",
    "timestamp": "2026-02-21T16:17:48.459104+08:00",
    "duration_ms": 0.005,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet convert utf8-to-hex -i "待编码文本"
{
  "metadata": {
    "operation": "encode",
    "algorithm": "utf8-to-hex",
    "encoding": "hex",
    "input": {
      "type": "text",
      "size": 15
    },
    "parameters": {
      "source": "utf-8",
      "target": "hex"
    }
  },
  "result": {
    "value": "e5be85e7bc96e7a081e69687e69cac"
  },
  "runtime": {
    "request_id": "e453408c-6f57-481e-84ed-e772c800efbc",
    "timestamp": "2026-02-21T16:18:13.404828+08:00",
    "duration_ms": 0.002,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

1.2 解码场景

场景	命令	描述
解码 Base64 得到可读文本	`eet convert base64-decode -i "aGVsbG8="`	当解码结果为可打印 UTF-8 时，自动输出 UTF-8 字符串
解码 Base64 得到 Hex（二进制数据）	`eet convert base64-decode -i "AQIDBAU="`	当解码结果为非可打印字节时，自动输出 Hex 便于查看原始字节
解码 Hex 得到可读文本	`eet convert hex-decode -i "68656c6c6f"`	当解码结果为可打印 UTF-8 时，自动输出 UTF-8 字符串
解码 Hex 得到 Base64（二进制数据）	`eet convert hex-decode -i "0102030405"`	当解码结果为非可打印字节时，自动输出 Base64 便于存储或传输
仅输出解码结果	`eet convert base64-decode -i "aGVsbG8=" --raw`	输出 `hello`，便于管道或复制

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
eet convert base64-decode -i "aGVsbG8="
{
  "metadata": {
    "operation": "decode",
    "algorithm": "base64-decode",
    "encoding": "utf-8",
    "input": {
      "type": "base64",
      "size": 8
    },
    "parameters": {
      "source": "base64",
      "target": "utf-8",
      "auto_detected": true
    }
  },
  "result": {
    "value": "hello",
    "output_encoding": "utf-8"
  },
  "runtime": {
    "request_id": "5eca7980-a771-4ade-b986-49634e458683",
    "timestamp": "2026-02-21T16:19:04.911076+08:00",
    "duration_ms": 0.026,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet convert base64-decode -i "AQIDBAU="
{
  "metadata": {
    "operation": "decode",
    "algorithm": "base64-decode",
    "encoding": "hex",
    "input": {
      "type": "base64",
      "size": 8
    },
    "parameters": {
      "source": "base64",
      "target": "hex",
      "auto_detected": true
    }
  },
  "result": {
    "value": "0102030405",
    "output_encoding": "hex"
  },
  "runtime": {
    "request_id": "21492322-44df-468c-b85b-e3003bfb6804",
    "timestamp": "2026-02-21T16:19:28.185698+08:00",
    "duration_ms": 0.025,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet convert hex-decode -i "68656c6c6f"
{
  "metadata": {
    "operation": "decode",
    "algorithm": "hex-decode",
    "encoding": "utf-8",
    "input": {
      "type": "hex",
      "size": 5
    },
    "parameters": {
      "source": "hex",
      "target": "utf-8",
      "auto_detected": true
    }
  },
  "result": {
    "value": "hello",
    "output_encoding": "utf-8"
  },
  "runtime": {
    "request_id": "60060e09-aefb-421f-b1f8-e2fd0182fdff",
    "timestamp": "2026-02-21T16:19:49.428491+08:00",
    "duration_ms": 0.009,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet convert hex-decode -i "0102030405"
{
  "metadata": {
    "operation": "decode",
    "algorithm": "hex-decode",
    "encoding": "base64",
    "input": {
      "type": "hex",
      "size": 5
    },
    "parameters": {
      "source": "hex",
      "target": "base64",
      "auto_detected": true
    }
  },
  "result": {
    "value": "AQIDBAU=",
    "output_encoding": "base64"
  },
  "runtime": {
    "request_id": "955ab625-2af0-491b-a5b2-7da86f832968",
    "timestamp": "2026-02-21T16:20:12.578165+08:00",
    "duration_ms": 0.021,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

1.3 典型工作流

工作流	命令组合	描述
验证 Base64 编码是否正确	`eet convert utf8-to-base64 -i "x"` → `eet convert base64-decode -i "<输出>"`	编码后再解码，应得到原文本
协议字段格式转换	`eet convert utf8-to-hex -i "payload"`	将字符串转为协议要求的 Hex 格式
日志/调试中查看二进制内容	`eet convert base64-decode -i "<密文或二进制>"`	自动判断输出 UTF-8 或 Hex，便于人工阅读

二、时间戳转换（ts）

2.1 时间戳 → 可读时间

场景	命令	描述
将秒级时间戳转为北京时间	`eet ts to-datetime -i 1708502400`	默认时区为 Asia/Shanghai，输出 ISO 8601 格式
将时间戳转为指定时区时间	`eet ts to-datetime -i 1708502400 -z America/New_York`	适用于跨时区协作、日志分析
使用固定 UTC 偏移	`eet ts to-datetime -i 1708502400 -z +08:00`	不依赖 IANA 时区库，适用于简单场景
仅输出时间字符串	`eet ts to-datetime -i 1708502400 --raw`	便于脚本解析或复制

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
eet ts to-datetime -i 1708502400
{
  "metadata": {
    "operation": "ts-to-datetime",
    "algorithm": "timestamp-convert",
    "encoding": "utf-8",
    "input": {
      "type": "timestamp",
      "size": 0
    },
    "parameters": {
      "timezone": "UTC+08:00",
      "input_timestamp": 1708502400
    }
  },
  "result": {
    "value": "2024-02-21T16:00:00+08:00",
    "timestamp": 1708502400,
    "timezone": "UTC+08:00"
  },
  "runtime": {
    "request_id": "15640e09-4b45-406f-92b6-4ef33da5b7ab",
    "timestamp": "2026-02-21T16:20:47.220240+08:00",
    "duration_ms": 0.231,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet ts to-datetime -i 1708502400 -z America/New_York
{
  "metadata": {
    "operation": "ts-to-datetime",
    "algorithm": "timestamp-convert",
    "encoding": "utf-8",
    "input": {
      "type": "timestamp",
      "size": 0
    },
    "parameters": {
      "timezone": "America/New_York",
      "input_timestamp": 1708502400
    }
  },
  "result": {
    "value": "2024-02-21T03:00:00-05:00",
    "timestamp": 1708502400,
    "timezone": "America/New_York"
  },
  "runtime": {
    "request_id": "0e8c1954-b611-4d9b-a7ea-5b5fcc952c5a",
    "timestamp": "2026-02-21T16:21:13.756555+08:00",
    "duration_ms": 1.511,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet ts to-datetime -i 1708502400 -z +08:00
{
  "metadata": {
    "operation": "ts-to-datetime",
    "algorithm": "timestamp-convert",
    "encoding": "utf-8",
    "input": {
      "type": "timestamp",
      "size": 0
    },
    "parameters": {
      "timezone": "UTC+08:00",
      "input_timestamp": 1708502400
    }
  },
  "result": {
    "value": "2024-02-21T16:00:00+08:00",
    "timestamp": 1708502400,
    "timezone": "UTC+08:00"
  },
  "runtime": {
    "request_id": "9d819164-bdba-4495-98eb-cfb25f9436cd",
    "timestamp": "2026-02-21T16:21:38.126324+08:00",
    "duration_ms": 0.328,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

2.2 可读时间 → 时间戳

场景	命令	描述
带时区的时间字符串转时间戳	`eet ts to-ts -i "2024-02-21T12:00:00+08:00"`	输入含时区信息，无需指定 -z
无时区时间按北京时间解析	`eet ts to-ts -i "2024-02-21 12:00:00" -z Asia/Shanghai`	适用于本地时间字符串，需明确指定时区
解析其他时区的时间	`eet ts to-ts -i "2024-02-21 09:00:00" -z America/Los_Angeles`	将洛杉矶时间转为 UTC 秒级时间戳
仅输出时间戳数值	`eet ts to-ts -i "2024-02-21T12:00:00+08:00" --raw`	便于脚本或 API 调用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
eet ts to-ts -i "2024-02-21T12:00:00+08:00"
{
  "metadata": {
    "operation": "datetime-to-ts",
    "algorithm": "timestamp-convert",
    "encoding": "utf-8",
    "input": {
      "type": "text",
      "size": 25
    },
    "parameters": {
      "timezone": "UTC+08:00",
      "output_timestamp": 1708488000
    }
  },
  "result": {
    "value": 1708488000,
    "timestamp": 1708488000,
    "datetime_str": "2024-02-21T12:00:00+08:00"
  },
  "runtime": {
    "request_id": "3b1ed762-99bd-4c78-8d84-a52dba180eb1",
    "timestamp": "2026-02-21T16:22:10.915791+08:00",
    "duration_ms": 1.161,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet ts to-ts -i "2024-02-21 12:00:00" -z Asia/Shanghai
{
  "metadata": {
    "operation": "datetime-to-ts",
    "algorithm": "timestamp-convert",
    "encoding": "utf-8",
    "input": {
      "type": "text",
      "size": 19
    },
    "parameters": {
      "timezone": "UTC+08:00",
      "output_timestamp": 1708488000
    }
  },
  "result": {
    "value": 1708488000,
    "timestamp": 1708488000,
    "datetime_str": "2024-02-21 12:00:00"
  },
  "runtime": {
    "request_id": "a388cdd8-c0b5-4822-9f20-85fce6faddab",
    "timestamp": "2026-02-21T16:22:40.211732+08:00",
    "duration_ms": 1.746,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet ts to-ts -i "2024-02-21 09:00:00" -z America/Los_Angeles
{
  "metadata": {
    "operation": "datetime-to-ts",
    "algorithm": "timestamp-convert",
    "encoding": "utf-8",
    "input": {
      "type": "text",
      "size": 19
    },
    "parameters": {
      "timezone": "America/Los_Angeles",
      "output_timestamp": 1708534800
    }
  },
  "result": {
    "value": 1708534800,
    "timestamp": 1708534800,
    "datetime_str": "2024-02-21 09:00:00"
  },
  "runtime": {
    "request_id": "2f13e798-33ab-406f-9086-4f0f80be92e1",
    "timestamp": "2026-02-21T16:22:59.250088+08:00",
    "duration_ms": 2.649,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

2.3 时区查阅

场景	命令	描述
查看主要时区及当前时间	`eet ts list-timezones`	列出约 50 个常用时区，显示 UTC 偏移和当前时间
指定时间戳查看各时区对应时间	`eet ts list-timezones -i 1708502400`	用于分析某时刻在全球各时区的表示
表格形式快速查阅	`eet ts list-timezones --raw`	三列输出：时区名、UTC 偏移、ISO 时间

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
eet ts list-timezones
{
  "metadata": {
    "operation": "list-timezones",
    "algorithm": "timezone-list",
    "encoding": "utf-8",
    "input": {
      "type": "current",
      "size": 0
    },
    "parameters": {
      "timestamp": 1771662203,
      "count": 53
    }
  },
  "result": {
    "timezones": [
      {
        "timezone": "Africa/Cairo",
        "utc_offset": "UTC+02:00",
        "datetime": "2026-02-21T10:23:23+02:00"
      },
      {
        "timezone": "Africa/Johannesburg",
        "utc_offset": "UTC+02:00",
        "datetime": "2026-02-21T10:23:23+02:00"
      },
      {
        "timezone": "Africa/Lagos",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "America/Bogota",
        "utc_offset": "UTC-05:00",
        "datetime": "2026-02-21T03:23:23-05:00"
      },
      {
        "timezone": "America/Buenos_Aires",
        "utc_offset": "UTC-03:00",
        "datetime": "2026-02-21T05:23:23-03:00"
      },
      {
        "timezone": "America/Caracas",
        "utc_offset": "UTC-04:00",
        "datetime": "2026-02-21T04:23:23-04:00"
      },
      {
        "timezone": "America/Chicago",
        "utc_offset": "UTC-06:00",
        "datetime": "2026-02-21T02:23:23-06:00"
      },
      {
        "timezone": "America/Denver",
        "utc_offset": "UTC-07:00",
        "datetime": "2026-02-21T01:23:23-07:00"
      },
      {
        "timezone": "America/Lima",
        "utc_offset": "UTC-05:00",
        "datetime": "2026-02-21T03:23:23-05:00"
      },
      {
        "timezone": "America/Los_Angeles",
        "utc_offset": "UTC-08:00",
        "datetime": "2026-02-21T00:23:23-08:00"
      },
      {
        "timezone": "America/Mexico_City",
        "utc_offset": "UTC-06:00",
        "datetime": "2026-02-21T02:23:23-06:00"
      },
      {
        "timezone": "America/New_York",
        "utc_offset": "UTC-05:00",
        "datetime": "2026-02-21T03:23:23-05:00"
      },
      {
        "timezone": "America/Santiago",
        "utc_offset": "UTC-03:00",
        "datetime": "2026-02-21T05:23:23-03:00"
      },
      {
        "timezone": "America/Sao_Paulo",
        "utc_offset": "UTC-03:00",
        "datetime": "2026-02-21T05:23:23-03:00"
      },
      {
        "timezone": "America/Toronto",
        "utc_offset": "UTC-05:00",
        "datetime": "2026-02-21T03:23:23-05:00"
      },
      {
        "timezone": "America/Vancouver",
        "utc_offset": "UTC-08:00",
        "datetime": "2026-02-21T00:23:23-08:00"
      },
      {
        "timezone": "Asia/Bangkok",
        "utc_offset": "UTC+07:00",
        "datetime": "2026-02-21T15:23:23+07:00"
      },
      {
        "timezone": "Asia/Dubai",
        "utc_offset": "UTC+04:00",
        "datetime": "2026-02-21T12:23:23+04:00"
      },
      {
        "timezone": "Asia/Ho_Chi_Minh",
        "utc_offset": "UTC+07:00",
        "datetime": "2026-02-21T15:23:23+07:00"
      },
      {
        "timezone": "Asia/Hong_Kong",
        "utc_offset": "UTC+08:00",
        "datetime": "2026-02-21T16:23:23+08:00"
      },
      {
        "timezone": "Asia/Jakarta",
        "utc_offset": "UTC+07:00",
        "datetime": "2026-02-21T15:23:23+07:00"
      },
      {
        "timezone": "Asia/Jerusalem",
        "utc_offset": "UTC+02:00",
        "datetime": "2026-02-21T10:23:23+02:00"
      },
      {
        "timezone": "Asia/Kolkata",
        "utc_offset": "UTC+05:30",
        "datetime": "2026-02-21T13:53:23+05:30"
      },
      {
        "timezone": "Asia/Kuala_Lumpur",
        "utc_offset": "UTC+08:00",
        "datetime": "2026-02-21T16:23:23+08:00"
      },
      {
        "timezone": "Asia/Manila",
        "utc_offset": "UTC+08:00",
        "datetime": "2026-02-21T16:23:23+08:00"
      },
      {
        "timezone": "Asia/Riyadh",
        "utc_offset": "UTC+03:00",
        "datetime": "2026-02-21T11:23:23+03:00"
      },
      {
        "timezone": "Asia/Seoul",
        "utc_offset": "UTC+09:00",
        "datetime": "2026-02-21T17:23:23+09:00"
      },
      {
        "timezone": "Asia/Shanghai",
        "utc_offset": "UTC+08:00",
        "datetime": "2026-02-21T16:23:23+08:00"
      },
      {
        "timezone": "Asia/Singapore",
        "utc_offset": "UTC+08:00",
        "datetime": "2026-02-21T16:23:23+08:00"
      },
      {
        "timezone": "Asia/Taipei",
        "utc_offset": "UTC+08:00",
        "datetime": "2026-02-21T16:23:23+08:00"
      },
      {
        "timezone": "Asia/Tehran",
        "utc_offset": "UTC+03:30",
        "datetime": "2026-02-21T11:53:23+03:30"
      },
      {
        "timezone": "Asia/Tokyo",
        "utc_offset": "UTC+09:00",
        "datetime": "2026-02-21T17:23:23+09:00"
      },
      {
        "timezone": "Australia/Adelaide",
        "utc_offset": "UTC+10:30",
        "datetime": "2026-02-21T18:53:23+10:30"
      },
      {
        "timezone": "Australia/Brisbane",
        "utc_offset": "UTC+10:00",
        "datetime": "2026-02-21T18:23:23+10:00"
      },
      {
        "timezone": "Australia/Perth",
        "utc_offset": "UTC+08:00",
        "datetime": "2026-02-21T16:23:23+08:00"
      },
      {
        "timezone": "Europe/Amsterdam",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Athens",
        "utc_offset": "UTC+02:00",
        "datetime": "2026-02-21T10:23:23+02:00"
      },
      {
        "timezone": "Europe/Berlin",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Istanbul",
        "utc_offset": "UTC+03:00",
        "datetime": "2026-02-21T11:23:23+03:00"
      },
      {
        "timezone": "Europe/London",
        "utc_offset": "UTC+00:00",
        "datetime": "2026-02-21T08:23:23+00:00"
      },
      {
        "timezone": "Europe/Madrid",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Moscow",
        "utc_offset": "UTC+03:00",
        "datetime": "2026-02-21T11:23:23+03:00"
      },
      {
        "timezone": "Europe/Paris",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Prague",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Rome",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Stockholm",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Warsaw",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Europe/Zurich",
        "utc_offset": "UTC+01:00",
        "datetime": "2026-02-21T09:23:23+01:00"
      },
      {
        "timezone": "Pacific/Auckland",
        "utc_offset": "UTC+13:00",
        "datetime": "2026-02-21T21:23:23+13:00"
      },
      {
        "timezone": "Pacific/Fiji",
        "utc_offset": "UTC+12:00",
        "datetime": "2026-02-21T20:23:23+12:00"
      },
      {
        "timezone": "Pacific/Guam",
        "utc_offset": "UTC+10:00",
        "datetime": "2026-02-21T18:23:23+10:00"
      },
      {
        "timezone": "Pacific/Honolulu",
        "utc_offset": "UTC-10:00",
        "datetime": "2026-02-20T22:23:23-10:00"
      },
      {
        "timezone": "UTC",
        "utc_offset": "UTC+00:00",
        "datetime": "2026-02-21T08:23:23+00:00"
      }
    ],
    "count": 53
  },
  "runtime": {
    "request_id": "00c65b4a-1c51-4a78-966e-78790ebd98fe",
    "timestamp": "2026-02-21T16:23:23.412038+08:00",
    "duration_ms": 21.406,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet ts list-timezones -i 1708502400
{
  "metadata": {
    "operation": "list-timezones",
    "algorithm": "timezone-list",
    "encoding": "utf-8",
    "input": {
      "type": "timestamp",
      "size": 0
    },
    "parameters": {
      "timestamp": 1708502400,
      "count": 53
    }
  },
  "result": {
    "timezones": [
      {
        "timezone": "Africa/Cairo",
        "utc_offset": "UTC+02:00",
        "datetime": "2024-02-21T10:00:00+02:00"
      },
      {
        "timezone": "Africa/Johannesburg",
        "utc_offset": "UTC+02:00",
        "datetime": "2024-02-21T10:00:00+02:00"
      },
      {
        "timezone": "Africa/Lagos",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "America/Bogota",
        "utc_offset": "UTC-05:00",
        "datetime": "2024-02-21T03:00:00-05:00"
      },
      {
        "timezone": "America/Buenos_Aires",
        "utc_offset": "UTC-03:00",
        "datetime": "2024-02-21T05:00:00-03:00"
      },
      {
        "timezone": "America/Caracas",
        "utc_offset": "UTC-04:00",
        "datetime": "2024-02-21T04:00:00-04:00"
      },
      {
        "timezone": "America/Chicago",
        "utc_offset": "UTC-06:00",
        "datetime": "2024-02-21T02:00:00-06:00"
      },
      {
        "timezone": "America/Denver",
        "utc_offset": "UTC-07:00",
        "datetime": "2024-02-21T01:00:00-07:00"
      },
      {
        "timezone": "America/Lima",
        "utc_offset": "UTC-05:00",
        "datetime": "2024-02-21T03:00:00-05:00"
      },
      {
        "timezone": "America/Los_Angeles",
        "utc_offset": "UTC-08:00",
        "datetime": "2024-02-21T00:00:00-08:00"
      },
      {
        "timezone": "America/Mexico_City",
        "utc_offset": "UTC-06:00",
        "datetime": "2024-02-21T02:00:00-06:00"
      },
      {
        "timezone": "America/New_York",
        "utc_offset": "UTC-05:00",
        "datetime": "2024-02-21T03:00:00-05:00"
      },
      {
        "timezone": "America/Santiago",
        "utc_offset": "UTC-03:00",
        "datetime": "2024-02-21T05:00:00-03:00"
      },
      {
        "timezone": "America/Sao_Paulo",
        "utc_offset": "UTC-03:00",
        "datetime": "2024-02-21T05:00:00-03:00"
      },
      {
        "timezone": "America/Toronto",
        "utc_offset": "UTC-05:00",
        "datetime": "2024-02-21T03:00:00-05:00"
      },
      {
        "timezone": "America/Vancouver",
        "utc_offset": "UTC-08:00",
        "datetime": "2024-02-21T00:00:00-08:00"
      },
      {
        "timezone": "Asia/Bangkok",
        "utc_offset": "UTC+07:00",
        "datetime": "2024-02-21T15:00:00+07:00"
      },
      {
        "timezone": "Asia/Dubai",
        "utc_offset": "UTC+04:00",
        "datetime": "2024-02-21T12:00:00+04:00"
      },
      {
        "timezone": "Asia/Ho_Chi_Minh",
        "utc_offset": "UTC+07:00",
        "datetime": "2024-02-21T15:00:00+07:00"
      },
      {
        "timezone": "Asia/Hong_Kong",
        "utc_offset": "UTC+08:00",
        "datetime": "2024-02-21T16:00:00+08:00"
      },
      {
        "timezone": "Asia/Jakarta",
        "utc_offset": "UTC+07:00",
        "datetime": "2024-02-21T15:00:00+07:00"
      },
      {
        "timezone": "Asia/Jerusalem",
        "utc_offset": "UTC+02:00",
        "datetime": "2024-02-21T10:00:00+02:00"
      },
      {
        "timezone": "Asia/Kolkata",
        "utc_offset": "UTC+05:30",
        "datetime": "2024-02-21T13:30:00+05:30"
      },
      {
        "timezone": "Asia/Kuala_Lumpur",
        "utc_offset": "UTC+08:00",
        "datetime": "2024-02-21T16:00:00+08:00"
      },
      {
        "timezone": "Asia/Manila",
        "utc_offset": "UTC+08:00",
        "datetime": "2024-02-21T16:00:00+08:00"
      },
      {
        "timezone": "Asia/Riyadh",
        "utc_offset": "UTC+03:00",
        "datetime": "2024-02-21T11:00:00+03:00"
      },
      {
        "timezone": "Asia/Seoul",
        "utc_offset": "UTC+09:00",
        "datetime": "2024-02-21T17:00:00+09:00"
      },
      {
        "timezone": "Asia/Shanghai",
        "utc_offset": "UTC+08:00",
        "datetime": "2024-02-21T16:00:00+08:00"
      },
      {
        "timezone": "Asia/Singapore",
        "utc_offset": "UTC+08:00",
        "datetime": "2024-02-21T16:00:00+08:00"
      },
      {
        "timezone": "Asia/Taipei",
        "utc_offset": "UTC+08:00",
        "datetime": "2024-02-21T16:00:00+08:00"
      },
      {
        "timezone": "Asia/Tehran",
        "utc_offset": "UTC+03:30",
        "datetime": "2024-02-21T11:30:00+03:30"
      },
      {
        "timezone": "Asia/Tokyo",
        "utc_offset": "UTC+09:00",
        "datetime": "2024-02-21T17:00:00+09:00"
      },
      {
        "timezone": "Australia/Adelaide",
        "utc_offset": "UTC+10:30",
        "datetime": "2024-02-21T18:30:00+10:30"
      },
      {
        "timezone": "Australia/Brisbane",
        "utc_offset": "UTC+10:00",
        "datetime": "2024-02-21T18:00:00+10:00"
      },
      {
        "timezone": "Australia/Perth",
        "utc_offset": "UTC+08:00",
        "datetime": "2024-02-21T16:00:00+08:00"
      },
      {
        "timezone": "Europe/Amsterdam",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Athens",
        "utc_offset": "UTC+02:00",
        "datetime": "2024-02-21T10:00:00+02:00"
      },
      {
        "timezone": "Europe/Berlin",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Istanbul",
        "utc_offset": "UTC+03:00",
        "datetime": "2024-02-21T11:00:00+03:00"
      },
      {
        "timezone": "Europe/London",
        "utc_offset": "UTC+00:00",
        "datetime": "2024-02-21T08:00:00+00:00"
      },
      {
        "timezone": "Europe/Madrid",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Moscow",
        "utc_offset": "UTC+03:00",
        "datetime": "2024-02-21T11:00:00+03:00"
      },
      {
        "timezone": "Europe/Paris",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Prague",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Rome",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Stockholm",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Warsaw",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Europe/Zurich",
        "utc_offset": "UTC+01:00",
        "datetime": "2024-02-21T09:00:00+01:00"
      },
      {
        "timezone": "Pacific/Auckland",
        "utc_offset": "UTC+13:00",
        "datetime": "2024-02-21T21:00:00+13:00"
      },
      {
        "timezone": "Pacific/Fiji",
        "utc_offset": "UTC+12:00",
        "datetime": "2024-02-21T20:00:00+12:00"
      },
      {
        "timezone": "Pacific/Guam",
        "utc_offset": "UTC+10:00",
        "datetime": "2024-02-21T18:00:00+10:00"
      },
      {
        "timezone": "Pacific/Honolulu",
        "utc_offset": "UTC-10:00",
        "datetime": "2024-02-20T22:00:00-10:00"
      },
      {
        "timezone": "UTC",
        "utc_offset": "UTC+00:00",
        "datetime": "2024-02-21T08:00:00+00:00"
      }
    ],
    "count": 53
  },
  "runtime": {
    "request_id": "87e881c4-5e1a-4a61-9ea3-715ccb548381",
    "timestamp": "2026-02-21T16:23:50.107078+08:00",
    "duration_ms": 6.925,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

2.4 典型工作流

工作流	命令组合	描述
日志时间戳转可读时间	`eet ts to-datetime -i <日志中的timestamp>`	快速理解日志发生时间
定时任务时间计算	`eet ts to-ts -i "2024-02-21 00:00:00" -z Asia/Shanghai`	将 cron 表达式对应时间转为时间戳
跨时区会议时间对齐	`eet ts list-timezones -i <会议时间戳>`	查看同一时刻在各时区的当地时间
API 时间参数生成	`eet ts to-ts -i "2024-02-21T12:00:00+08:00" --raw`	生成接口所需的秒级时间戳

三、整数与字节序转换（int-to-bytes）

3.1 整数 → 十六进制字节流

场景	命令	描述
将整数转为大端和小端 Hex	`eet int-to-bytes to-hex -i 1234567890`	同时输出两种字节序，便于协议或存储格式对比
32 位整数（4 字节）	`eet int-to-bytes to-hex -i 1234567890 -w 4`	适用于 IPv4、uint32 等场景
64 位整数（8 字节，默认）	`eet int-to-bytes to-hex -i 1234567890 -w 8`	适用于 int64、文件偏移等场景
128 位整数（16 字节）	`eet int-to-bytes to-hex -i 0 -w 16`	适用于 UUID 高位、大整数等场景
仅输出 Hex 便于复制	`eet int-to-bytes to-hex -i 1234567890 --raw`	两行分别输出 big_endian 和 little_endian

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
eet int-to-bytes to-hex -i 1234567890
{
  "metadata": {
    "operation": "int-to-hex",
    "algorithm": "byte-order-convert",
    "encoding": "hex",
    "input": {
      "type": "text",
      "size": 0
    },
    "parameters": {
      "width_bytes": 8,
      "input_value": 1234567890
    }
  },
  "result": {
    "big_endian_hex": "00000000499602d2",
    "little_endian_hex": "d202964900000000",
    "value": 1234567890
  },
  "runtime": {
    "request_id": "e881737e-976a-47b4-87cc-568005337039",
    "timestamp": "2026-02-21T16:24:34.478264+08:00",
    "duration_ms": 0.004,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet int-to-bytes to-hex -i 1234567890 -w 4
{
  "metadata": {
    "operation": "int-to-hex",
    "algorithm": "byte-order-convert",
    "encoding": "hex",
    "input": {
      "type": "text",
      "size": 0
    },
    "parameters": {
      "width_bytes": 4,
      "input_value": 1234567890
    }
  },
  "result": {
    "big_endian_hex": "499602d2",
    "little_endian_hex": "d2029649",
    "value": 1234567890
  },
  "runtime": {
    "request_id": "7eda3370-0a17-4d53-8321-38b46bdec768",
    "timestamp": "2026-02-21T16:25:06.254608+08:00",
    "duration_ms": 0.004,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

3.2 十六进制字节流 → 整数

场景	命令	描述
大端 Hex 转整数	`eet int-to-bytes from-hex -i "00000000499602d2" -e big`	网络字节序、协议字段、大端存储格式
小端 Hex 转整数	`eet int-to-bytes from-hex -i "d202964900000000" -e little`	x86 内存布局、Windows 文件格式、小端存储
仅输出整数值	`eet int-to-bytes from-hex -i "00000000499602d2" -e big --raw`	便于脚本或管道使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
eet int-to-bytes from-hex -i "00000000499602d2" -e big
{
  "metadata": {
    "operation": "hex-to-int",
    "algorithm": "byte-order-convert",
    "encoding": "utf-8",
    "input": {
      "type": "hex",
      "size": 8
    },
    "parameters": {
      "byte_order": "big",
      "input_hex": "00000000499602d2"
    }
  },
  "result": {
    "value": 1234567890,
    "byte_order": "big",
    "input_hex": "00000000499602d2"
  },
  "runtime": {
    "request_id": "b06a030a-c53a-4874-a875-f2dc8c2e4ffb",
    "timestamp": "2026-02-21T16:25:46.751623+08:00",
    "duration_ms": 0.003,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet int-to-bytes from-hex -i "d202964900000000" -e little
{
  "metadata": {
    "operation": "hex-to-int",
    "algorithm": "byte-order-convert",
    "encoding": "utf-8",
    "input": {
      "type": "hex",
      "size": 8
    },
    "parameters": {
      "byte_order": "little",
      "input_hex": "d202964900000000"
    }
  },
  "result": {
    "value": 1234567890,
    "byte_order": "little",
    "input_hex": "d202964900000000"
  },
  "runtime": {
    "request_id": "1084d2c0-afb2-49e4-a06c-a66969e910cb",
    "timestamp": "2026-02-21T16:26:12.950800+08:00",
    "duration_ms": 0.004,
    "host": "192.168.1.103",
    "version": "v2.3.3"
  }
}

eet int-to-bytes from-hex -i "00000000499602d2" -e big --raw
1234567890

3.3 典型工作流

工作流	命令组合	描述
验证字节序转换正确性	`eet int-to-bytes to-hex -i 123` → `eet int-to-bytes from-hex -i "<big_endian_hex>" -e big`	应得到原整数
协议字段解析	`eet int-to-bytes from-hex -i "<协议中的hex>" -e big`	将网络协议中的长度、序号等转为整数
二进制文件字段解读	`xxd -p -l 8 file.bin \| xargs -I {} eet int-to-bytes from-hex -i {} -e little`	读取文件前 8 字节并按小端解析为整数
生成测试数据	`eet int-to-bytes to-hex -i 0xDEADBEEF -w 4`	生成固定整数的字节表示用于单元测试

四、输出格式说明

所有辅助命令均支持以下输出选项：

选项	说明	适用场景
默认	彩色 Pretty JSON	人工查看、调试
`--json`	单行 JSON	脚本解析、jq 处理
`--raw`	仅主结果值	管道、复制、嵌入其他命令
`--pretty-json`	显式指定 Pretty JSON	与默认相同

EET 辅助工具使用场景#

一、字符串格式转换（convert）#

1.1 编码场景#

1.2 解码场景#

1.3 典型工作流#

二、时间戳转换（ts）#

2.1 时间戳 → 可读时间#

2.2 可读时间 → 时间戳#

2.3 时区查阅#

2.4 典型工作流#

三、整数与字节序转换（int-to-bytes）#

3.1 整数 → 十六进制字节流#

3.2 十六进制字节流 → 整数#

3.3 典型工作流#

四、输出格式说明#

EET 辅助工具使用场景

一、字符串格式转换（convert）

1.1 编码场景

1.2 解码场景

1.3 典型工作流

二、时间戳转换（ts）

2.1 时间戳 → 可读时间

2.2 可读时间 → 时间戳

2.3 时区查阅

2.4 典型工作流

三、整数与字节序转换（int-to-bytes）

3.1 整数 → 十六进制字节流

3.2 十六进制字节流 → 整数

3.3 典型工作流

四、输出格式说明