@jjlmoya/utils-tools 1.1.0 → 1.3.0

package/src/tests/slug_uniqueness.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+const sharingLocales = ['ja', 'ko', 'zh'];
+
+interface ValidateParams {
+  toolId: string;
+  locale: string;
+  content: ToolLocaleContent;
+  enSlug: string;
+  slugs: Map<string, string>;
+}
+
+const validateLocaleSlug = ({
+  toolId,
+  locale,
+  content,
+  enSlug,
+  slugs,
+}: ValidateParams) => {
+  expect(
+    content.slug,
+    `Tool "${toolId}" locale "${locale}" has an invalid slug ("${content.slug}"). Slugs must be transliterated (only a-z, 0-9, and -).`,
+  ).toMatch(/^[a-z0-9-]+$/);
+
+  if (locale === 'en') {
+    return;
+  }
+
+  if (sharingLocales.includes(locale)) {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" must use the same slug as "en" ("${enSlug}").`,
+    ).toBe(enSlug);
+  } else {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" has the same slug as "en" ("${enSlug}"). Cada slug tiene que estar en su propia idioma`,
+    ).not.toBe(enSlug);
+
+    if (slugs.has(content.slug)) {
+      const previousLocale = slugs.get(content.slug);
+      expect(
+        false,
+        `Tool "${toolId}" locales "${locale}" and "${previousLocale}" share the same slug ("${content.slug}"). Cada slug tiene que estar en su propia idioma`,
+      ).toBe(true);
+    }
+    slugs.set(content.slug, locale);
+  }
+};
+
+describe('Slug Localization and Uniqueness Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      it('every locale should have a unique, translated slug', async () => {
+        const slugs = new Map<string, string>();
+        const locales = Object.keys(tool.entry.i18n);
+
+        let enSlug = '';
+        if (locales.includes('en')) {
+          const enLoader = tool.entry.i18n['en' as keyof typeof tool.entry.i18n];
+          const enContent = (await enLoader?.()) as ToolLocaleContent;
+          enSlug = enContent.slug;
+        }
+
+        for (const locale of locales) {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          const content = (await loader?.()) as ToolLocaleContent;
+          validateLocaleSlug({
+            toolId: tool.entry.id,
+            locale,
+            content,
+            enSlug,
+            slugs,
+          });
+        }
+      });
+    });
+  });
+});

package/src/tests/title_quality.test.ts

@@ -41,7 +41,6 @@ describe('Project Titles - Separator Validation', () => {
       let match;
       while ((match = pattern.exec(content)) !== null) {
         const title = match[1];
-        if (!title) continue;
         if (title.includes('|') || title.includes('-')) {
           findings.push(title);
         }

package/src/tool/date-diff-calculator/i18n/de.ts

@@ -0,0 +1,132 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { DateDiffCalculatorUI } from '../ui';
+
+const faqData = [
+  {
+    question: 'Ist dieser Datumsdifferenzrechner kostenlos?',
+    answer: 'Ja, es ist ein 100 % kostenloses Tool, das von jedem Browser aus ohne Registrierung oder Downloads zugänglich ist.',
+  },
+  {
+    question: 'Wie werden Schaltjahre in der Gesamtzeit berücksichtigt?',
+    answer: 'Das Tool verwendet die Standard-JavaScript-Chronologie (UTC), die Schaltjahre und die variable Anzahl von Tagen in jedem Monat automatisch berücksichtigt, um ein exaktes Ergebnis zu liefern.',
+  },
+  {
+    question: 'Kann ich auch die Differenz zwischen Stunden und Minuten berechnen?',
+    answer: 'Ja. In den Eingabefeldern können Sie die genaue Zeit auswählen. Das Ergebnis liefert Ihnen eine Aufteilung in Tage, Stunden, Minuten und Sekunden sowie kumulierte Summen.',
+  },
+  {
+    question: 'Werden meine Datumseingaben an einen Server gesendet?',
+    answer: 'Nein. Die gesamte Verarbeitung erfolgt lokal in Ihrem Browser. Wir speichern oder empfangen keine Informationen über die von Ihnen berechneten Daten.',
+  },
+];
+
+const howToData = [
+  { name: 'Startdatum auswählen', text: 'Geben Sie das Startdatum und die Uhrzeit ein oder klicken Sie auf „Heute“, um sie sofort festzulegen.' },
+  { name: 'Enddatum auswählen', text: 'Definieren Sie den Zielzeitpunkt. Verwenden Sie „Jetzt“, um die bis zu diesem exakten Moment verstrichene Zeit zu messen.' },
+  { name: 'Ergebnisse ablesen', text: 'Überprüfen Sie die Aufteilung in Tage, Stunden, Minuten und Sekunden sowie die kumulierten Summen für Wochen und Stunden.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'So berechnen Sie die Differenz zwischen zwei Datumsangaben',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Datumsdifferenz-Rechner',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: 'Berechnen Sie genau, wie viel Zeit zwischen zwei Daten vergangen ist oder wie lange es noch bis zu einem Ereignis dauert. Ergebnisse in Tagen, Stunden und Minuten.',
+};
+
+const ui: DateDiffCalculatorUI = {
+  startLabel: 'Startdatum',
+  endLabel: 'Enddatum',
+  nowBtn: 'Jetzt',
+  todayBtn: 'Heute',
+  tomorrowBtn: 'Morgen',
+  daysLabel: 'Tage',
+  hoursLabel: 'Stunden',
+  minsLabel: 'Min',
+  secsLabel: 'Sek',
+  weeksLabel: 'Gesamtwochen',
+  totalHoursLabel: 'Gesamtstunden',
+  totalMinsLabel: 'Gesamtminuten',
+  elapsed: 'Verstrichene Zeit',
+  past: 'Zeit in der Vergangenheit',
+  invalidDates: 'Ungültige Daten',
+};
+
+export const content: ToolLocaleContent<DateDiffCalculatorUI> = {
+  slug: 'datumsdifferenz-rechner',
+  title: 'Datumsdifferenz Rechner',
+  description: 'Berechnen Sie genau, wie viel Zeit zwischen zwei Daten vergangen ist oder wie lange es noch bis zu einem Ereignis dauert. Kostenloses Tool mit Ergebnissen in Tagen, Stunden und Minuten.',
+  ui,
+  faqTitle: 'Häufig gestellte Fragen',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Referenzen',
+  bibliography: [
+    { name: 'Time and Date: Weltuhr und Zeitzonen-Konverter', url: 'https://www.timeanddate.com/worldclock/' },
+    { name: 'Wikipedia: Geschichte des gregorianischen Kalenders', url: 'https://de.wikipedia.org/wiki/Gregorianischer_Kalender' },
+    { name: 'Wikipedia: Eisenhower-Matrix und Zeitmanagement', url: 'https://de.wikipedia.org/wiki/Zeitmanagement#Die_ Eisenhower-Methode' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: 'Datumsdifferenzrechner mit Tagen, Stunden und Minuten' },
+    {
+      type: 'paragraph',
+      html: 'Die Berechnung der <strong>Differenz zwischen zwei Daten</strong> ist eine der am häufigsten unterschätzten Aufgaben sowohl im Alltag als auch im beruflichen Umfeld. Egal, ob Sie eine Produkteinführung planen, das exakte Alter einer Person berechnen oder die verbleibende Zeit bis zu einem besonderen Ereignis messen – ein präzises Werkzeug ist für ein effizientes Zeitmanagement unerlässlich.',
+    },
+    { type: 'title', level: 3, text: 'Wofür wird der Datumsdifferenzrechner verwendet?' },
+    {
+      type: 'paragraph',
+      html: 'Die Nützlichkeit dieses Tools erstreckt sich auf viele Bereiche. Im Berufsleben nutzen es Projektmanager, um Abgabefristen festzulegen und den Fortschritt von Meilensteinen zu verfolgen. In rechtlichen und administrativen Kontexten ist es für die Berechnung von Verjährungsfristen oder Vertragslaufzeiten von Bedeutung.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Veranstaltungsplanung:</strong> Wissen Sie, wie viele Wochen und Tage bis zu einer Hochzeit, Konferenz oder Reise verbleiben.',
+        '<strong>Projektmanagement:</strong> Berechnen Sie die verstrichene Zeit vom Beginn einer Phase bis zu ihrem Abschluss.',
+        '<strong>Finanzen:</strong> Bestimmen Sie die Anzahl der Tage für Zinsberechnungen oder Rechnungsfälligkeiten.',
+        '<strong>Personalwesen:</strong> Messen Sie die Betriebszugehörigkeit von Mitarbeitern oder angesammelte Urlaubstage.',
+        '<strong>Gesundheit:</strong> Verfolgen Sie den Fortschritt einer Behandlung oder die Erholungszeit nach einem Eingriff.',
+      ],
+    },
+    { type: 'title', level: 3, text: 'Zeitwahrnehmung und digitale Präzision' },
+    {
+      type: 'paragraph',
+      html: 'Oft neigen wir dazu, die Zeit zu runden. Wir sagen „etwa ein Monat“, wenn es tatsächlich noch 27 Tage und 14 Stunden sind. Durch die Verwendung eines digitalen Rechners eliminieren wir die Subjektivität und erhalten klare Daten für eine fundierte Entscheidungsfindung.',
+    },
+    { type: 'title', level: 3, text: 'Kalendertage versus Arbeitstage' },
+    {
+      type: 'paragraph',
+      html: 'Dieses Tool berechnet <strong>Kalendertage</strong>, einschließlich Wochenenden und Feiertagen. Für astronomische und allgemeine zivile Berechnungen wird die Zeit kontinuierlich gemessen. Wenn Sie Projektzeiten schätzen müssen, denken Sie daran, dass die angezeigten Tage den vollen realen Kalender darstellen.',
+    },
+    { type: 'title', level: 3, text: 'Die Auswirkung der Zeit auf die Produktivität' },
+    {
+      type: 'paragraph',
+      html: 'Das Parkinsonsche Gesetz besagt, dass Arbeit sich in genau dem Maße ausdehnt, wie Zeit für ihre Erledigung zur Verfügung steht. Durch die Visualisierung, wie viele Stunden und Minuten bis zu einer Frist verbleiben, neigen Teams dazu, ihre Bemühungen zu optimieren und konzentriert zu bleiben.',
+    },
+    {
+      type: 'tip',
+      title: 'Zukünftige und vergangene Daten',
+      html: 'Sie können den Rechner sowohl für zukünftige als auch für vergangene Daten verwenden. Wenn das Enddatum vor dem Startdatum liegt, erkennt das System automatisch, dass es sich um in der Vergangenheit verstrichene Zeit handelt, und bewahrt die Präzision der absoluten Differenzwerte.',
+    },
+  ],
+};

package/src/tool/date-diff-calculator/i18n/fr.ts

@@ -73,7 +73,7 @@ const ui: DateDiffCalculatorUI = {
 };
 
 export const content: ToolLocaleContent<DateDiffCalculatorUI> = {
-  slug: 'calculateur-difference-dates',
+  slug: 'calculatrice-difference-dates',
   title: 'Calculateur de Différence de Dates',
   description: 'Calculez exactement combien de temps s\'est écoulé entre deux dates ou combien il reste avant un événement. Outil gratuit avec résultats en jours, heures et minutes.',
   ui,

package/src/tool/date-diff-calculator/i18n/id.ts

@@ -0,0 +1,132 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { DateDiffCalculatorUI } from '../ui';
+
+const faqData = [
+  {
+    question: 'Apakah kalkulator selisih tanggal ini gratis?',
+    answer: 'Ya, ini adalah alat 100% gratis yang dapat diakses dari browser apa pun tanpa perlu registrasi atau unduhan.',
+  },
+  {
+    question: 'Bagaimana tahun kabisat ditangani dalam total waktu?',
+    answer: 'Alat ini menggunakan kronologi standar JavaScript (UTC), yang secara otomatis menangani tahun kabisat dan jumlah hari yang bervariasi di setiap bulan untuk memberikan hasil yang tepat.',
+  },
+  {
+    question: 'Dapatkah saya menghitung selisih jam dan menit juga?',
+    answer: 'Ya. Bidang input memungkinkan Anda memilih waktu yang tepat. Hasilnya memberi Anda rincian dalam hari, jam, menit, dan detik, serta total akumulasi.',
+  },
+  {
+    question: 'Apakah input tanggal saya dikirim ke server mana pun?',
+    answer: 'Tidak. Semua pemrosesan dilakukan secara lokal di browser Anda. Kami tidak menyimpan atau menerima informasi apa pun tentang tanggal yang Anda hitung.',
+  },
+];
+
+const howToData = [
+  { name: 'Pilih tanggal mulai', text: "Masukkan tanggal dan waktu mulai, atau klik 'Hari Ini' untuk mengaturnya secara instan." },
+  { name: 'Pilih tanggal akhir', text: "Tentukan momen target. Gunakan 'Sekarang' untuk mengukur waktu yang telah berlalu hingga saat ini secara tepat." },
+  { name: 'Baca hasilnya', text: 'Periksa rincian hari, jam, menit, dan detik, ditambah total akumulasi untuk minggu dan jam.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Cara menghitung selisih antara dua tanggal',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Kalkulator Selisih Tanggal',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: 'Hitung secara tepat berapa lama waktu yang telah berlalu antara dua tanggal atau berapa lama hingga suatu acara terjadi. Hasil dalam hari, jam, dan menit.',
+};
+
+const ui: DateDiffCalculatorUI = {
+  startLabel: 'Tanggal Mulai',
+  endLabel: 'Tanggal Selesai',
+  nowBtn: 'Sekarang',
+  todayBtn: 'Hari Ini',
+  tomorrowBtn: 'Besok',
+  daysLabel: 'Hari',
+  hoursLabel: 'Jam',
+  minsLabel: 'Menit',
+  secsLabel: 'Detik',
+  weeksLabel: 'Total Minggu',
+  totalHoursLabel: 'Total Jam',
+  totalMinsLabel: 'Total Menit',
+  elapsed: 'Waktu yang Telah Berlalu',
+  past: 'Waktu di Masa Lalu',
+  invalidDates: 'Tanggal tidak valid',
+};
+
+export const content: ToolLocaleContent<DateDiffCalculatorUI> = {
+  slug: 'kalkulator-selisih-tanggal',
+  title: 'Kalkulator Selisih Tanggal',
+  description: 'Hitung secara tepat berapa lama waktu yang telah berlalu antara dua tanggal atau berapa lama hingga suatu acara terjadi. Alat gratis dengan hasil dalam hari, jam, dan menit.',
+  ui,
+  faqTitle: 'Pertanyaan yang Sering Diajukan',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Referensi',
+  bibliography: [
+    { name: 'Time and Date: World Clock and Time Zone Converter', url: 'https://www.timeanddate.com/worldclock/' },
+    { name: 'Wikipedia: Sejarah Kalender Gregorian', url: 'https://id.wikipedia.org/wiki/Kalender_Gregorius' },
+    { name: 'Wikipedia: Manajemen Waktu — Matriks Eisenhower', url: 'https://id.wikipedia.org/wiki/Manajemen_waktu' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: 'Kalkulator selisih tanggal dengan hari, jam, dan menit' },
+    {
+      type: 'paragraph',
+      html: 'Menghitung <strong>selisih antara dua tanggal</strong> adalah salah satu tugas yang paling umum tetapi sering diremehkan, baik dalam kehidupan sehari-hari maupun lingkungan profesional. Baik Anda merencanakan peluncuran produk, menghitung usia tepat seseorang, atau mengukur waktu yang tersisa hingga acara spesial, memiliki alat yang presisi sangat penting untuk manajemen waktu yang efisien.',
+    },
+    { type: 'title', level: 3, text: 'Untuk apa kalkulator selisih tanggal digunakan?' },
+    {
+      type: 'paragraph',
+      html: 'Kegunaan alat ini mencakup berbagai bidang. Di tempat kerja, manajer proyek menggunakannya untuk menentukan batas waktu pengiriman dan melacak kemajuan pencapaian (milestone). Dalam konteks hukum dan administratif, alat ini penting untuk menghitung masa kedaluwarsa atau durasi kontrak.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Perencanaan acara:</strong> Ketahui berapa minggu dan hari yang tersisa hingga pernikahan, konferensi, atau perjalanan.',
+        '<strong>Manajemen proyek:</strong> Hitung waktu yang telah berlalu dari dimulainya suatu fase hingga penyelesaiannya.',
+        '<strong>Keuangan:</strong> Tentukan jumlah hari untuk perhitungan bunga atau tanggal jatuh tempo faktur.',
+        '<strong>Sumber Daya Manusia:</strong> Ukur masa kerja karyawan atau akumulasi hari libur.',
+        '<strong>Kesehatan:</strong> Pantau kemajuan pengobatan atau waktu pemulihan setelah prosedur medis.',
+      ],
+    },
+    { type: 'title', level: 3, text: 'Persepsi waktu dan presisi digital' },
+    {
+      type: 'paragraph',
+      html: 'Kita sering cenderung membulatkan waktu. Kita mengatakan "sekitar satu bulan" padahal sebenarnya masih 27 hari dan 14 jam lagi. Dengan menggunakan kalkulator digital, kita menghilangkan subjektivitas dan memperoleh data yang bersih untuk pengambilan keputusan yang tepat.',
+    },
+    { type: 'title', level: 3, text: 'Hari kalender vs hari kerja' },
+    {
+      type: 'paragraph',
+      html: 'Alat ini menghitung <strong>hari kalender</strong>, termasuk akhir pekan dan hari libur nasional. Untuk perhitungan astronomi dan sipil umum, waktu diukur secara berkelanjutan. Jika Anda perlu memperkirakan waktu proyek, ingatlah bahwa hari yang ditampilkan mewakili kalender nyata secara penuh.',
+    },
+    { type: 'title', level: 3, text: 'Dampak waktu pada produktivitas' },
+    {
+      type: 'paragraph',
+      html: 'Hukum Parkinson menyatakan bahwa pekerjaan akan berkembang untuk mengisi waktu yang tersedia untuk penyelesaiannya. Dengan memvisualisasikan secara tepat berapa jam dan menit yang tersisa hingga batas waktu, tim cenderung mengoptimalkan upaya mereka dan tetap fokus.',
+    },
+    {
+      type: 'tip',
+      title: 'Tanggal masa depan dan masa lalu',
+      html: 'Anda dapat menggunakan kalkulator ini untuk tanggal masa depan maupun masa lalu. Jika tanggal akhir lebih awal dari tanggal mulai, sistem secara otomatis mendeteksi bahwa itu adalah waktu yang telah berlalu di masa lalu, dengan tetap menjaga presisi dalam nilai selisih absolut.',
+    },
+  ],
+};

package/src/tool/date-diff-calculator/i18n/it.ts

@@ -0,0 +1,132 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { DateDiffCalculatorUI } from '../ui';
+
+const faqData = [
+  {
+    question: 'Questo calcolatore di differenza tra date è gratuito?',
+    answer: 'Sì, è uno strumento gratuito al 100% accessibile da qualsiasi browser senza necessità di registrazione o download.',
+  },
+  {
+    question: 'Come vengono gestiti gli anni bisestili nel tempo totale?',
+    answer: 'Lo strumento utilizza la cronologia standard di JavaScript (UTC), che gestisce automaticamente gli anni bisestili e il numero variabile di giorni in ogni mese per fornire un risultato esatto.',
+  },
+  {
+    question: 'Posso calcolare anche la differenza tra ore e minuti?',
+    answer: 'Sì. I campi di input consentono di selezionare l\'ora esatta. Il risultato fornisce una ripartizione in giorni, ore, minuti e secondi, nonché i totali accumulati.',
+  },
+  {
+    question: 'Le mie date vengono inviate a qualche server?',
+    answer: 'No. Tutte le elaborazioni vengono eseguite localmente nel browser. Non memorizziamo né riceviamo alcuna informazione sulle date calcolate.',
+  },
+];
+
+const howToData = [
+  { name: 'Seleziona la data di inizio', text: "Inserisci la data e l'ora di inizio, oppure fai clic su 'Oggi' per impostarla istantaneamente." },
+  { name: 'Seleziona la data di fine', text: "Definisci il momento di arrivo. Usa 'Adesso' per misurare il tempo trascorso fino a questo preciso istante." },
+  { name: 'Leggi i risultati', text: 'Controlla la ripartizione in giorni, ore, minuti e secondi, oltre ai totali accumulati per settimane e ore.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Come calcolare la differenza tra due date',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Calcolatore di Differenza tra Date',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: 'Calcola esattamente quanto tempo è passato tra due date o quanto manca a un evento. Risultati in giorni, ore e minuti.',
+};
+
+const ui: DateDiffCalculatorUI = {
+  startLabel: 'Data di Inizio',
+  endLabel: 'Data di Fine',
+  nowBtn: 'Adesso',
+  todayBtn: 'Oggi',
+  tomorrowBtn: 'Domani',
+  daysLabel: 'Giorni',
+  hoursLabel: 'Ore',
+  minsLabel: 'Min',
+  secsLabel: 'Sec',
+  weeksLabel: 'Settimane Totali',
+  totalHoursLabel: 'Ore Totali',
+  totalMinsLabel: 'Minuti Totali',
+  elapsed: 'Tempo Trascorso',
+  past: 'Tempo nel Passato',
+  invalidDates: 'Date non valide',
+};
+
+export const content: ToolLocaleContent<DateDiffCalculatorUI> = {
+  slug: 'calcolatrice-differenza-date',
+  title: 'Calcolatore di Differenza tra Date',
+  description: 'Calcola esattamente quanto tempo è passato tra due date o quanto manca a un evento. Strumento gratuito con risultati in giorni, ore e minuti.',
+  ui,
+  faqTitle: 'Domande Frequenti',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Riferimenti',
+  bibliography: [
+    { name: 'Time and Date: World Clock and Time Zone Converter', url: 'https://www.timeanddate.com/worldclock/' },
+    { name: 'Wikipedia: History of the Gregorian Calendar', url: 'https://it.wikipedia.org/wiki/Calendario_gregoriano' },
+    { name: 'Wikipedia: Eisenhower Matrix and Time Management', url: 'https://it.wikipedia.org/wiki/Gestione_del_tempo#Metodo_di_Eisenhower' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: 'Calcolatore di differenza tra date con giorni, ore e minuti' },
+    {
+      type: 'paragraph',
+      html: 'Calcolare la <strong>differenza tra due date</strong> è uno dei compiti più comuni e sottovalutati sia nella vita quotidiana che in contesti professionali. Che si tratti di pianificare il lancio di un prodotto, calcolare l\'età esatta di una persona o misurare il tempo rimanente a un evento speciale, disporre di uno strumento preciso è essenziale per un\'efficiente gestione del tempo.',
+    },
+    { type: 'title', level: 3, text: 'A cosa serve il calcolatore di differenza tra date?' },
+    {
+      type: 'paragraph',
+      html: 'L\'utilità di questo strumento si estende a molteplici settori. Nel lavoro, i project manager lo usano per definire le scadenze di consegna e tracciare i progressi dei traguardi. In contesti legali e amministrativi, è fondamentale per calcolare i termini di prescrizione o la durata dei contratti.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Pianificazione di eventi:</strong> Scopri quante settimane e giorni mancano a un matrimonio, una conferenza o un viaggio.',
+        '<strong>Gestione dei progetti:</strong> Calcola il tempo trascorso dall\'inizio di una fase fino al suo completamento.',
+        '<strong>Finanza:</strong> Determina il numero di giorni per il calcolo degli interessi o le scadenze delle fatture.',
+        '<strong>Risorse Umane:</strong> Misura l\'anzianità dei dipendenti o i giorni di vacanza accumulati.',
+        '<strong>Salute:</strong> Monitora i progressi di un trattamento o il tempo di recupero dopo un intervento.',
+      ],
+    },
+    { type: 'title', level: 3, text: 'Percezione del tempo e precisione digitale' },
+    {
+      type: 'paragraph',
+      html: 'Spesso tendiamo ad arrotondare il tempo. Diciamo "circa un mese" quando mancano effettivamente 27 giorni e 14 ore. Utilizzando un calcolatore digitale, eliminiamo la soggettività e otteniamo dati puliti per un processo decisionale informato.',
+    },
+    { type: 'title', level: 3, text: 'Giorni naturali contro giorni lavorativi' },
+    {
+      type: 'paragraph',
+      html: 'Questo strumento calcola i <strong>giorni di calendario</strong>, inclusi i fine settimana e i giorni festivi. Per i calcoli astronomici e civili generali, il tempo viene misurato in modo continuo. Se devi stimare i tempi di un progetto, ricorda che i giorni mostrati rappresentano l\'intero calendario reale.',
+    },
+    { type: 'title', level: 3, text: 'L\'impatto del tempo sulla produttività' },
+    {
+      type: 'paragraph',
+      html: 'La Legge di Parkinson afferma che il lavoro si espande fino a occupare tutto il tempo disponibile per il suo completamento. Visualizzando esattamente quante ore e minuti mancano a una scadenza, i team tendono a ottimizzare i propri sforzi e a mantenere la concentrazione.',
+    },
+    {
+      type: 'tip',
+      title: 'Date future e passate',
+      html: 'Puoi usare il calcolatore sia per date future che passate. Se la data di fine è precedente alla data di inizio, il sistema rileva automaticamente che si tratta di tempo trascorso nel passato, mantenendo la precisione nei valori di differenza assoluta.',
+    },
+  ],
+};

package/src/tool/date-diff-calculator/i18n/ja.ts

@@ -0,0 +1,132 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { DateDiffCalculatorUI } from '../ui';
+
+const faqData = [
+  {
+    question: 'この日付差計算機は無料ですか？',
+    answer: 'はい、登録やダウンロードは一切不要で、どのブラウザからでもアクセスできる100%無料のツールです。',
+  },
+  {
+    question: '合計時間において、うるう年はどのように処理されますか？',
+    answer: 'このツールは標準的なJavaScriptの年代測定法（UTC）を使用しており、うるう年や各月の不規則な日数を自動的に処理して、正確な結果を提供します。',
+  },
+  {
+    question: '時や分の差も計算できますか？',
+    answer: 'はい。入力フィールドで正確な時刻を選択できます。結果は、日・時・分・秒の構成だけでなく、累積された合計時間も表示します。',
+  },
+  {
+    question: '入力した日付データはサーバーに送信されますか？',
+    answer: 'いいえ。すべての処理はブラウザ内でローカルに行われます。計算された日付に関する情報を保存したり、受信したりすることはありません。',
+  },
+];
+
+const howToData = [
+  { name: '開始日を選択', text: '開始する日付と時刻を入力してください。「今日」をクリックすると瞬時に設定できます。' },
+  { name: '終了日を選択', text: '目標とする時点を定義します。「現在」を使用すると、今この瞬間までに経過した時間を測定できます。' },
+  { name: '結果を確認', text: '日・時・分・秒の構成に加えて、週や時間の累積合計を確認してください。' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: '2つの日付の差を計算する方法',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: '日付差計算機',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'JPY' },
+  description: '2つの日付の間にどれだけの時間が経過したか、あるいはイベントまであとどれくらいかを正確に計算します。日、時、分で結果を表示。',
+};
+
+const ui: DateDiffCalculatorUI = {
+  startLabel: '開始日',
+  endLabel: '終了日',
+  nowBtn: '現在',
+  todayBtn: '今日',
+  tomorrowBtn: '明日',
+  daysLabel: '日',
+  hoursLabel: '時間',
+  minsLabel: '分',
+  secsLabel: '秒',
+  weeksLabel: '合計週数',
+  totalHoursLabel: '合計時間',
+  totalMinsLabel: '合計分数',
+  elapsed: '経過時間',
+  past: '過去の時間',
+  invalidDates: '無効な日付',
+};
+
+export const content: ToolLocaleContent<DateDiffCalculatorUI> = {
+  slug: 'date-difference-calculator',
+  title: '日付差計算機',
+  description: '2つの日付の間にどれだけの時間が経過したか、あるいはイベントまであとどれくらいかを正確に計算します。日、時、分で結果を表示する無料ツール。',
+  ui,
+  faqTitle: 'よくある質問',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: '参考文献',
+  bibliography: [
+    { name: 'Time and Date: 世界時計とタイムゾーン変換器', url: 'https://www.timeanddate.com/worldclock/' },
+    { name: 'Wikipedia: グレゴリオ暦の歴史', url: 'https://ja.wikipedia.org/wiki/グレゴリオ暦' },
+    { name: 'Wikipedia: アイゼンハワー・マトリクスと時間管理', url: 'https://ja.wikipedia.org/wiki/時間管理' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: '日、時、分でわかる日付差計算機' },
+    {
+      type: 'paragraph',
+      html: '<strong>2つの日付の差</strong>を計算することは、日常生活と仕事の両方において、最も一般的でありながら過小評価されているタスクの1つです。製品の発売計画を立てる際でも、誰かの正確な年齢を計算する際でも、あるいは特別なイベントまでの残り時間を測る際でも、効率的な時間管理には正確なツールが不可欠です。',
+    },
+    { type: 'title', level: 3, text: '日付差計算機は何に使われますか？' },
+    {
+      type: 'paragraph',
+      html: 'このツールの有用性は多くの分野に及びます。職場では、プロジェクトマネージャーが納品期限を定め、マイルストーンの進捗を追跡するために使用します。法的または行政的な文脈では、時効期間や契約期間を計算するために不可欠です。',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>イベント計画：</strong>結婚式、会議、または旅行まであと何週間と何日あるかを知る。',
+        '<strong>プロジェクト管理：</strong>あるフェーズの開始から完了までに経過した時間を計算する。',
+        '<strong>財務：</strong>利息計算や請求書の支払期限のための日数を決定する。',
+        '<strong>人事：</strong>従業員の勤続年数や累積休暇日数を測定する。',
+        '<strong>健康：</strong>治療の進捗や、処置後の回復時間を追跡する。',
+      ],
+    },
+    { type: 'title', level: 3, text: '時間の知覚とデジタルの正確性' },
+    {
+      type: 'paragraph',
+      html: '私たちはしばしば時間を切り捨てる傾向があります。実際には27日と14時間あるのに「約1ヶ月」と言ったりします。デジタル計算機を使用することで、主観を排除し、情報に基づいた意思決定のための明確なデータを得ることができます。',
+    },
+    { type: 'title', level: 3, text: '暦日対営業日' },
+    {
+      type: 'paragraph',
+      html: 'このツールは、週末や祝日を含む<strong>暦日</strong>を計算します。天文学的および一般的な市民生活の計算では、時間は継続的に測定されます。プロジェクト時間を推定する必要がある場合は、表示される日数が実際のカレンダーのフル期間を表していることを忘れないでください。',
+    },
+    { type: 'title', level: 3, text: '時間が生産性に与える影響' },
+    {
+      type: 'paragraph',
+      html: 'パーキンソンの法則によれば、仕事の量は、完成のために割り当てられた時間を満たすまで膨張します。締め切りまでにあと何時間、何分残っているかを正確に可視化することで、チームは努力を最適化し、集中力を維持する傾向があります。',
+    },
+    {
+      type: 'tip',
+      title: '未来と過去の日付',
+      html: 'この計算機は、未来と過去の両方の日付に使用できます。終了日が開始日よりも早い場合、システムは自動的にそれが過去に経過した時間であることを検出し、絶対的な差の値の正確性を維持します。',
+    },
+  ],
+};