feat: implement unix to date converter (#184)

src/pages/tools/time/convert-unix-to-date/convert-unix-to-date.service.test.ts

@@ -0,0 +1,56 @@
+import { expect, describe, it } from 'vitest';
+import { convertUnixToDate } from './service';
+
+describe('convertUnixToDate', () => {
+  it('should convert a single Unix timestamp with label (UTC)', () => {
+    const input = '0';
+    const result = convertUnixToDate(input, true, false);
+    expect(result).toBe('1970-01-01 00:00:00.000 UTC');
+  });
+
+  it('should convert a single Unix timestamp without label (UTC)', () => {
+    const input = '1234567890';
+    const result = convertUnixToDate(input, false, false);
+    expect(result).toBe('2009-02-13 23:31:30.000');
+  });
+
+  it('should convert a single Unix timestamp in local time', () => {
+    const input = '1234567890';
+    const result = convertUnixToDate(input, true, true);
+    expect(result.endsWith('UTC')).toBe(false);
+  });
+
+  it('should handle multiple lines with label (UTC)', () => {
+    const input = '0\n2147483647';
+    const result = convertUnixToDate(input, true, false);
+    expect(result).toBe(
+      '1970-01-01 00:00:00.000 UTC\n2038-01-19 03:14:07.000 UTC'
+    );
+  });
+
+  it('should handle multiple lines with local time', () => {
+    const input = '1672531199\n1721287227';
+    const result = convertUnixToDate(input, false, true);
+    const lines = result.split('\n');
+    expect(lines.length).toBe(2);
+    expect(lines[0].endsWith('UTC')).toBe(false);
+  });
+
+  it('should return empty string for invalid input', () => {
+    const input = 'not_a_number';
+    const result = convertUnixToDate(input, true, false);
+    expect(result).toBe('');
+  });
+
+  it('should return empty string for empty input', () => {
+    const input = '';
+    const result = convertUnixToDate(input, false, false);
+    expect(result).toBe('');
+  });
+
+  it('should ignore invalid lines in multiline input', () => {
+    const input = 'abc\n1600000000';
+    const result = convertUnixToDate(input, true, false);
+    expect(result).toBe('\n2020-09-13 12:26:40.000 UTC');
+  });
+});

src/pages/tools/time/convert-unix-to-date/index.tsx

@@ -0,0 +1,102 @@
+import { Box } from '@mui/material';
+import { useState } from 'react';
+import ToolContent from '@components/ToolContent';
+import { ToolComponentProps } from '@tools/defineTool';
+import ToolTextInput from '@components/input/ToolTextInput';
+import ToolTextResult from '@components/result/ToolTextResult';
+import { GetGroupsType } from '@components/options/ToolOptions';
+import { CardExampleType } from '@components/examples/ToolExamples';
+import CheckboxWithDesc from '@components/options/CheckboxWithDesc';
+import { convertUnixToDate } from './service';
+import { useTranslation } from 'react-i18next';
+
+const initialValues = {
+  withLabel: true,
+  useLocalTime: false
+};
+type InitialValuesType = typeof initialValues;
+
+const exampleCards: CardExampleType<InitialValuesType>[] = [
+  {
+    title: 'Basic Unix Time to Date',
+    description:
+      'This example shows how Unix timestamps are converted into human-readable dates. Each timestamp represents the number of seconds that have elapsed since January 1, 1970 (UTC).',
+    sampleText: `0
+1721287227
+2147483647`,
+    sampleResult: `1970-01-01 00:00:00:000 UTC
+2024-07-18 10:00:27:000 UTC
+2038-01-19 03:14:07:000 UTC`,
+    sampleOptions: { withLabel: true, useLocalTime: false }
+  },
+  {
+    title: 'Without UTC Suffix',
+    description:
+      'In this example, the UTC suffix is removed from the output. This might be useful for embedding timestamps into other formats or for cleaner display.',
+    sampleText: `1234567890
+1672531199`,
+    sampleResult: `2009-02-13 23:31:30
+2022-12-31 23:59:59:000`,
+    sampleOptions: { withLabel: false, useLocalTime: false }
+  },
+  {
+    title: 'Use Local Time',
+    description:
+      'This example demonstrates how timestamps are shown in your local timezone rather than UTC. The UTC suffix is omitted in this case.',
+    sampleText: `1721287227`,
+    sampleResult: `2024-07-18 12:00:27`,
+    sampleOptions: { withLabel: true, useLocalTime: true }
+  }
+];
+
+export default function ConvertUnixToDate({ title }: ToolComponentProps) {
+  const { t } = useTranslation('time');
+  const [input, setInput] = useState<string>('');
+  const [result, setResult] = useState<string>('');
+
+  const compute = (values: typeof initialValues, input: string) => {
+    setResult(convertUnixToDate(input, values.withLabel, values.useLocalTime));
+  };
+
+  const getGroups: GetGroupsType<InitialValuesType> | null = ({
+    values,
+    updateField
+  }) => [
+    {
+      title: t('convertUnixToDate.withLabel'),
+      component: (
+        <Box>
+          <CheckboxWithDesc
+            onChange={(val) => updateField('withLabel', val)}
+            checked={values.withLabel}
+            title={t('convertUnixToDate.addUtcLabel')}
+            description={t('convertUnixToDate.addUtcLabelDescription')}
+          />
+          <CheckboxWithDesc
+            onChange={(val) => updateField('useLocalTime', val)}
+            checked={values.useLocalTime}
+            title={t('convertUnixToDate.useLocalTime')}
+            description={t('convertUnixToDate.useLocalTimeDescription')}
+          />
+        </Box>
+      )
+    }
+  ];
+  return (
+    <ToolContent
+      title={title}
+      input={input}
+      inputComponent={<ToolTextInput value={input} onChange={setInput} />}
+      resultComponent={<ToolTextResult value={result} />}
+      initialValues={initialValues}
+      exampleCards={exampleCards}
+      getGroups={getGroups}
+      setInput={setInput}
+      compute={compute}
+      toolInfo={{
+        title: t('convertUnixToDate.toolInfo.title'),
+        description: t('convertUnixToDate.toolInfo.description')
+      }}
+    />
+  );
+}

src/pages/tools/time/convert-unix-to-date/meta.ts

@@ -0,0 +1,15 @@
+import { defineTool } from '@tools/defineTool';
+import { lazy } from 'react';
+
+export const tool = defineTool('time', {
+  i18n: {
+    name: 'time:convertUnixToDate.title',
+    description: 'time:convertUnixToDate.description',
+    shortDescription: 'time:convertUnixToDate.shortDescription',
+    longDescription: 'time:convertUnixToDate.longDescription'
+  },
+  path: 'convert-unix-to-date',
+  icon: 'material-symbols:schedule',
+  keywords: ['convert', 'unix', 'to', 'date'],
+  component: lazy(() => import('./index'))
+});

src/pages/tools/time/convert-unix-to-date/service.ts

@@ -0,0 +1,42 @@
+import { containsOnlyDigits } from '@utils/string';
+
+function computeUnixToDate(input: string, useLocalTime: boolean): string {
+  if (!containsOnlyDigits(input)) {
+    return '';
+  }
+  const timestamp = parseInt(input, 10);
+  const date = new Date(timestamp * 1000); // Convert from seconds to milliseconds
+
+  if (useLocalTime) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+  } else {
+    return date.toISOString().replace('T', ' ').replace('Z', '');
+  }
+}
+
+export function convertUnixToDate(
+  input: string,
+  withLabel: boolean,
+  useLocalTime: boolean
+): string {
+  const result: string[] = [];
+
+  const lines = input.split('\n');
+
+  lines.forEach((line) => {
+    const parts = line.split(' ');
+    const timestamp = parts[0];
+    const formattedDate = computeUnixToDate(timestamp, useLocalTime);
+
+    const label = !useLocalTime && withLabel ? ' UTC' : '';
+    result.push(formattedDate ? `${formattedDate}${label}` : '');
+  });
+
+  return result.join('\n');
+}

src/pages/tools/time/index.ts

@@ -1,3 +1,4 @@
+import { tool as timeConvertUnixToDate } from './convert-unix-to-date/meta';
 import { tool as timeCrontabGuru } from './crontab-guru/meta';
 import { tool as timeBetweenDates } from './time-between-dates/meta';
 import { tool as daysDoHours } from './convert-days-to-hours/meta';
@@ -15,5 +16,6 @@ export const timeTools = [
   truncateClockTime,
   timeBetweenDates,
   timeCrontabGuru,
-  checkLeapYear
+  checkLeapYear,
+  timeConvertUnixToDate
 ];