diff --git a/src/tools/index.ts b/src/tools/index.ts index a68c4127..81d4553f 100644 --- a/src/tools/index.ts +++ b/src/tools/index.ts @@ -23,6 +23,7 @@ import { tool as energyConverter } from './energy-converter'; import { tool as areaConverter } from './area-converter'; import { tool as angleConverter } from './angle-converter'; import { tool as floatingPointNumberConverter } from './floating-point-number-converter'; +import { tool as snowflakeIdExtractor } from './snowflake-id-extractor'; import { tool as emailNormalizer } from './email-normalizer'; import { tool as bounceParser } from './bounce-parser'; import { tool as codeHighlighter } from './code-highlighter'; @@ -361,6 +362,7 @@ export const toolsByCategory: ToolCategory[] = [ jsonDiff, softwareLicenceCompatibility, safelinkDecoder, + snowflakeIdExtractor, apiTester, bounceParser, colorWheel, diff --git a/src/tools/snowflake-id-extractor/index.ts b/src/tools/snowflake-id-extractor/index.ts new file mode 100644 index 00000000..0700ec90 --- /dev/null +++ b/src/tools/snowflake-id-extractor/index.ts @@ -0,0 +1,12 @@ +import { Id } from '@vicons/tabler'; +import { defineTool } from '../tool'; + +export const tool = defineTool({ + name: 'Snowflake ID extractor', + path: '/snowflake-id-extractor', + description: 'Extract timestamp, machine ID, and sequence number from a Snowflake ID', + keywords: ['snowflake', 'id', 'extractor'], + component: () => import('./snowflake-id-extractor.vue'), + icon: Id, + createdAt: new Date('2024-07-22'), +}); diff --git a/src/tools/snowflake-id-extractor/snowflake-id-extractor.service.test.ts b/src/tools/snowflake-id-extractor/snowflake-id-extractor.service.test.ts new file mode 100644 index 00000000..eab4b95c --- /dev/null +++ b/src/tools/snowflake-id-extractor/snowflake-id-extractor.service.test.ts @@ -0,0 +1,14 @@ +import { describe, expect, it } from 'vitest'; +import { extractId, extractMachineId, extractTimestamp } from './snowflake-id-extractor.service'; + +describe('snowflake-id-extractor', () => { + it('extract id from Snowflake ID', () => { + expect(extractId(1263785187301658678n)).toBe(54); + }); + it('extract machine id from Snowflake ID', () => { + expect(extractMachineId(1263785187301658678n)).toBe(65); + }); + it('extract timestamp from Snowflake ID', () => { + expect(extractTimestamp(1263785187301658678n, new Date(1420070400000))).toStrictEqual(new Date(1721380268646)); + }); +}); diff --git a/src/tools/snowflake-id-extractor/snowflake-id-extractor.service.ts b/src/tools/snowflake-id-extractor/snowflake-id-extractor.service.ts new file mode 100644 index 00000000..a0875a24 --- /dev/null +++ b/src/tools/snowflake-id-extractor/snowflake-id-extractor.service.ts @@ -0,0 +1,15 @@ +export function extractId(id: bigint) { + return Number(id & 4095n); +} + +export function extractMachineId(id: bigint) { + return Number((id >> 12n) & 127n); +} + +export function extractTimestamp(id: bigint, epoch: bigint | Date) { + return new Date(Number((id >> 22n) + getTimestamp(epoch))); +} + +function getTimestamp(time: bigint | Date) { + return typeof time === 'bigint' ? time : BigInt(new Date(time).getTime()); +} diff --git a/src/tools/snowflake-id-extractor/snowflake-id-extractor.vue b/src/tools/snowflake-id-extractor/snowflake-id-extractor.vue new file mode 100644 index 00000000..c85e08ae --- /dev/null +++ b/src/tools/snowflake-id-extractor/snowflake-id-extractor.vue @@ -0,0 +1,57 @@ + + +