feat: format date utils

src/utils/format.utils.spec.ts

@@ -1,37 +1,65 @@
-import {formatAmount} from './format.utils';
-
-describe('formatAmount', () => {
-  it('formats amounts with the specified decimals', () => {
-    expect(formatAmount({amount: 123456n, decimals: 2})).toBe('1,234.56');
-    expect(formatAmount({amount: 1000000n, decimals: 6})).toBe('1.0');
-    expect(formatAmount({amount: 123456n, decimals: 1})).toBe('12,345.6');
-    expect(formatAmount({amount: 123456n, decimals: 0})).toBe('123,456');
-  });
+import {formatAmount, formatDate} from './format.utils';
 
-  it('formats zero amount with decimals', () => {
-    expect(formatAmount({amount: 0n, decimals: 2})).toBe('0.0');
-    expect(formatAmount({amount: 0n, decimals: 6})).toBe('0.0');
-  });
+describe('format.utils', () => {
+  describe('formatAmount', () => {
+    it('formats amounts with the specified decimals', () => {
+      expect(formatAmount({amount: 123456n, decimals: 2})).toBe('1,234.56');
+      expect(formatAmount({amount: 1000000n, decimals: 6})).toBe('1.0');
+      expect(formatAmount({amount: 123456n, decimals: 1})).toBe('12,345.6');
+      expect(formatAmount({amount: 123456n, decimals: 0})).toBe('123,456');
+    });
 
-  it('handles large amounts properly', () => {
-    expect(formatAmount({amount: 123456789012345n, decimals: 8})).toBe('1,234,567.89012345');
-  });
+    it('formats zero amount with decimals', () => {
+      expect(formatAmount({amount: 0n, decimals: 2})).toBe('0.0');
+      expect(formatAmount({amount: 0n, decimals: 6})).toBe('0.0');
+    });
+
+    it('handles large amounts properly', () => {
+      expect(formatAmount({amount: 123456789012345n, decimals: 8})).toBe('1,234,567.89012345');
+    });
 
-  it('handles small decimals without rounding errors', () => {
-    expect(formatAmount({amount: 1n, decimals: 8})).toBe('0.00000001');
-    expect(formatAmount({amount: 10n, decimals: 8})).toBe('0.0000001');
-    expect(formatAmount({amount: 100n, decimals: 8})).toBe('0.000001');
-    expect(formatAmount({amount: 100_000_000n, decimals: 8})).toBe('1.0');
-    expect(formatAmount({amount: 1_000_000_000n, decimals: 8})).toBe('10.0');
-    expect(formatAmount({amount: 1_010_000_000n, decimals: 8})).toBe('10.1');
-    expect(formatAmount({amount: 1_012_300_000n, decimals: 8})).toBe('10.123');
-    expect(formatAmount({amount: 20_000_000_000n, decimals: 8})).toBe('200.0');
-    expect(formatAmount({amount: 20_000_000_001n, decimals: 8})).toBe('200.00000001');
-    expect(formatAmount({amount: 200_000_000_000n, decimals: 8})).toBe(`2,000.0`);
-    expect(formatAmount({amount: 200_000_000_000_000n, decimals: 8})).toBe(`2,000,000.0`);
+    it('handles small decimals without rounding errors', () => {
+      expect(formatAmount({amount: 1n, decimals: 8})).toBe('0.00000001');
+      expect(formatAmount({amount: 10n, decimals: 8})).toBe('0.0000001');
+      expect(formatAmount({amount: 100n, decimals: 8})).toBe('0.000001');
+      expect(formatAmount({amount: 100_000_000n, decimals: 8})).toBe('1.0');
+      expect(formatAmount({amount: 1_000_000_000n, decimals: 8})).toBe('10.0');
+      expect(formatAmount({amount: 1_010_000_000n, decimals: 8})).toBe('10.1');
+      expect(formatAmount({amount: 1_012_300_000n, decimals: 8})).toBe('10.123');
+      expect(formatAmount({amount: 20_000_000_000n, decimals: 8})).toBe('200.0');
+      expect(formatAmount({amount: 20_000_000_001n, decimals: 8})).toBe('200.00000001');
+      expect(formatAmount({amount: 200_000_000_000n, decimals: 8})).toBe(`2,000.0`);
+      expect(formatAmount({amount: 200_000_000_000_000n, decimals: 8})).toBe(`2,000,000.0`);
+    });
+
+    it('throws an error for invalid decimals', () => {
+      expect(() => formatAmount({amount: 100n, decimals: -1})).toThrow();
+    });
   });
 
-  it('throws an error for invalid decimals', () => {
-    expect(() => formatAmount({amount: 100n, decimals: -1})).toThrow();
+  describe('formatDate', () => {
+    it('formats a valid date correctly', () => {
+      const input = 1704032400000000000n;
+      const result = formatDate(input);
+      expect(result).toBe('Sun, Dec 31, 2023, 14:20:00 UTC');
+    });
+
+    it('formats a different valid date correctly', () => {
+      const input = 1693526400000000000n;
+      const result = formatDate(input);
+      expect(result).toBe('Fri, Sep 1, 2023, 00:00:00 UTC');
+    });
+
+    it('handles zero timestamp (epoch)', () => {
+      const input = 0n;
+      const result = formatDate(input);
+      expect(result).toBe('Thu, Jan 1, 1970, 00:00:00 UTC');
+    });
+
+    it('handles large timestamps correctly', () => {
+      const input = 253402300799000000000n;
+      const result = formatDate(input);
+      expect(result).toBe('Fri, Dec 31, 9999, 23:59:59 UTC');
+    });
   });
 });

src/utils/format.utils.ts

@@ -9,3 +9,21 @@ export const formatAmount = ({amount, decimals}: {amount: bigint; decimals: numb
     maximumFractionDigits: decimals
   }).format(converted);
 };
+
+export const formatDate = (nanoseconds: bigint): string => {
+  const options: Intl.DateTimeFormatOptions = {
+    weekday: 'short',
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+    timeZone: 'UTC',
+    timeZoneName: 'short'
+  };
+
+  const date = new Date(Number(nanoseconds / 1_000_000n));
+  return date.toLocaleDateString('en', options);
+};