fix: timestamp handling for database backup in Web UI

open-api/immich-openapi-specs.json

@@ -17671,11 +17671,15 @@
           },
           "filesize": {
             "type": "number"
+          },
+          "timezone": {
+            "type": "string"
           }
         },
         "required": [
           "filename",
-          "filesize"
+          "filesize",
+          "timezone"
         ],
         "type": "object"
       },

open-api/typescript-sdk/src/fetch-client.ts

@@ -63,6 +63,7 @@ export type DatabaseBackupDeleteDto = {
 export type DatabaseBackupDto = {
     filename: string;
     filesize: number;
+    timezone: string;
 };
 export type DatabaseBackupListResponseDto = {
     backups: DatabaseBackupDto[];

server/src/dtos/database-backup.dto.ts

@@ -4,6 +4,7 @@ import { IsString } from 'class-validator';
 export class DatabaseBackupDto {
   filename!: string;
   filesize!: number;
+  timezone!: string;
 }
 
 export class DatabaseBackupListResponseDto {

server/src/services/database-backup.service.ts

@@ -281,6 +281,7 @@ export class DatabaseBackupService {
   async listBackups(): Promise<DatabaseBackupListResponseDto> {
     const backupsFolder = StorageCore.getBaseFolder(StorageFolder.Backups);
     const files = await this.storageRepository.readdir(backupsFolder);
+    const timezone = DateTime.local().zoneName;
 
     const validFiles = files
       .filter((fn) => isValidDatabaseBackupName(fn))
@@ -290,7 +291,7 @@ export class DatabaseBackupService {
     const backups = await Promise.all(
       validFiles.map(async (filename) => {
         const stats = await this.storageRepository.stat(path.join(backupsFolder, filename));
-        return { filename, filesize: stats.size };
+        return { filename, filesize: stats.size, timezone };
       }),
     );
 

web/src/lib/components/maintenance/MaintenanceBackupEntry.spec.ts

@@ -0,0 +1,54 @@
+import { locale } from '$lib/stores/preferences.store';
+import { renderWithTooltips } from '$tests/helpers';
+import { screen } from '@testing-library/svelte';
+import { DateTime } from 'luxon';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import MaintenanceBackupEntry from './MaintenanceBackupEntry.svelte';
+
+vi.mock('$lib/services/database-backups.service', () => ({
+  getDatabaseBackupActions: () => ({
+    Download: { type: 'command', title: 'Download', onAction: vi.fn() },
+    Delete: { type: 'command', title: 'Delete', onAction: vi.fn() },
+  }),
+  handleRestoreDatabaseBackup: vi.fn(),
+}));
+
+describe('MaintenanceBackupEntry', () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date('2026-03-24T12:00:00Z'));
+    locale.set('en');
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it('renders relative backup time using the user timezone instead of UTC', () => {
+    const backupTimestamp = '20260324T110000';
+
+    const expectedRelativeTime = DateTime.fromFormat(backupTimestamp, "yyyyMMdd'T'HHmmss", {
+      zone: 'Asia/Tokyo',
+    })
+      .toLocal()
+      .toRelative({ locale: 'en' });
+
+    const utcRelativeTime = DateTime.fromFormat(backupTimestamp, "yyyyMMdd'T'HHmmss", {
+      zone: 'UTC',
+    })
+      .toLocal()
+      .toRelative({ locale: 'en' });
+
+    expect(expectedRelativeTime).toBeTruthy();
+    expect(expectedRelativeTime).not.toEqual(utcRelativeTime);
+
+    renderWithTooltips(MaintenanceBackupEntry, {
+      expectedVersion: '1.2.3',
+      filename: 'immich-db-backup-20260324T110000-v1.2.3-snapshot.sql.gz',
+      filesize: 1024,
+      timezone: 'Asia/Tokyo',
+    });
+
+    expect(screen.getByText(expectedRelativeTime!)).toBeInTheDocument();
+  });
+});

web/src/lib/components/maintenance/MaintenanceBackupEntry.svelte

@@ -13,16 +13,17 @@
     filename: string;
     filesize: number;
     expectedVersion: string;
+    timezone?: string;
   };
 
-  const { filename, filesize, expectedVersion }: Props = $props();
+  const { filename, filesize, expectedVersion, timezone }: Props = $props();
 
   const filesizeText = $derived(getBytesWithUnit(filesize, 1));
 
   const backupDateTime = $derived.by(() => {
     const dateMatch = filename.match(/\d+T\d+/);
     if (dateMatch) {
-      return DateTime.fromFormat(dateMatch[0], "yyyyMMdd'T'HHmmss", { zone: 'utc' }).toLocal();
+      return DateTime.fromFormat(dateMatch[0], "yyyyMMdd'T'HHmmss", { zone: timezone }).toLocal();
     }
     return null;
   });

web/src/lib/components/maintenance/MaintenanceBackupsList.svelte

@@ -51,12 +51,13 @@
     const unknownDateKey = $t('unknown_date');
 
     for (const backup of backups) {
+      const timezone = backup.timezone;
       const dateMatch = backup.filename.match(/\d+T\d+/);
       let dateKey: string;
       let dt: DateTime;
 
       if (dateMatch) {
-        dt = DateTime.fromFormat(dateMatch[0], "yyyyMMdd'T'HHmmss", { zone: 'utc' });
+        dt = DateTime.fromFormat(dateMatch[0], "yyyyMMdd'T'HHmmss", { zone: timezone });
         dateKey = dt.toFormat('LLLL d, yyyy');
       } else {
         dt = DateTime.fromMillis(0);
@@ -128,6 +129,7 @@
           filename={backup.filename}
           filesize={backup.filesize}
           expectedVersion={props.expectedVersion}
+          timezone={backup.timezone}
         />
       {/each}
     </Stack>