The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
import dayjs from 'dayjs'
import { describe, expect, it } from 'vitest'
import {
findTimezoneByIana,
getTimezoneLabel,
getTimezoneLabelByIana,
TIMEZONES_BY_IANA,
} from '@/lib/constants/timezones'
describe('TIMEZONES_BY_IANA', () => {
it('produces one row per primary IANA name', () => {
const ianas = TIMEZONES_BY_IANA.map((entry) => entry.utc[0])
expect(new Set(ianas).size).toBe(ianas.length)
})
it('prefers the standard-time row when multiple catalog rows share a primary IANA', () => {
// The catalog has both PDT (isdst: true) and PST (isdst: false) pointing
// at America/Los_Angeles. The deduped view should pick the standard one
// so the picker label doesn't flip on DST changes.
const matches = TIMEZONES_BY_IANA.filter((entry) => entry.utc[0] === 'America/Los_Angeles')
expect(matches).toHaveLength(1)
expect(matches[0].isdst).toBe(false)
})
it('has no labels that name a fixed DST state, since the offset in the label is date-aware', () => {
const labels = TIMEZONES_BY_IANA.map((entry) => entry.text)
expect(labels.filter((label) => /Daylight|Standard/.test(label))).toEqual([])
})
it('preserves entries that have no collision', () => {
// Most rows have a unique primary IANA. The UTC catalog row's primary is
// 'America/Danmarkshavn' and survives the dedupe pass unchanged.
const utcRow = TIMEZONES_BY_IANA.find((entry) => entry.value === 'UTC')
expect(utcRow?.text).toContain('Coordinated Universal Time')
expect(utcRow?.utc[0]).toBe('America/Danmarkshavn')
})
})
describe('catalog integrity', () => {
const getOffsetHours = (timeZone: string, date: Date) => {
const value = new Intl.DateTimeFormat('en-US', { timeZone, timeZoneName: 'longOffset' })
.formatToParts(date)
.find((part) => part.type === 'timeZoneName')?.value
const match = value?.match(/GMT([+-])(\d\d):(\d\d)/)
if (!match) return 0
return (match[1] === '-' ? -1 : 1) * (Number(match[2]) + Number(match[3]) / 60)
}
const winter = new Date('2026-01-15T12:00:00Z')
const summer = new Date('2026-07-15T12:00:00Z')
const getLabelOffsetHours = (label: string) => {
const match = label.match(/^\(UTC(?:([+-])(\d\d):(\d\d))?\)/)
if (!match) return undefined
return match[1] ? (match[1] === '-' ? -1 : 1) * (Number(match[2]) + Number(match[3]) / 60) : 0
}
it('every IANA zone has the offset in its label in winter or summer', () => {
const mismatches = TIMEZONES_BY_IANA.flatMap((entry) =>
entry.utc
.filter((iana) => {
const labelOffset = getLabelOffsetHours(entry.text)
return (
labelOffset === undefined ||
![getOffsetHours(iana, winter), getOffsetHours(iana, summer)].includes(labelOffset)
)
})
.map((iana) => `${entry.text}: ${iana}`)
)
expect(mismatches).toEqual([])
})
})
describe('findTimezoneByIana', () => {
it('matches the entry by its primary IANA name', () => {
const entry = findTimezoneByIana('America/Danmarkshavn')
expect(entry?.text).toContain('Coordinated Universal Time')
})
it('matches the entry by any of its secondary IANA names', () => {
// 'Asia/Tokyo' is one of the IANA aliases on the JST row whose primary
// IANA is 'Asia/Dili'. Lookup must walk the full alias list.
const entry = findTimezoneByIana('Asia/Tokyo')
expect(entry?.utc).toContain('Asia/Tokyo')
})
it('returns the deduplicated row when the zone belongs to a collapsed catalog row', () => {
// Europe/Nicosia is only listed on the "E. Europe" row, which collapses into
// "Athens, Bucharest" because both share the primary Asia/Nicosia.
const entry = findTimezoneByIana('Europe/Nicosia')
expect(entry).toBe(TIMEZONES_BY_IANA.find((row) => row.utc[0] === entry?.utc[0]))
expect(entry?.text).toContain('Athens, Bucharest')
})
it('returns undefined for an unknown IANA name', () => {
expect(findTimezoneByIana('Not/A/Real_Zone')).toBeUndefined()
})
})
const getTimezone = (zone: string) => {
const timezone = findTimezoneByIana(zone)
if (!timezone) throw new Error(`Timezone ${zone} not found`)
return timezone
}
describe('getTimezoneLabel', () => {
it.each([
['2026-03-29T00:59:59Z', '(UTC+01:00)'],
['2026-03-29T01:00:00Z', '(UTC+02:00)'],
['2026-10-25T00:59:59Z', '(UTC+02:00)'],
['2026-10-25T01:00:00Z', '(UTC+01:00)'],
])('updates Madrid offset across daylight saving transitions at %s', (date, offset) => {
expect(getTimezoneLabel(getTimezone('Europe/Madrid'), dayjs(date))).toBe(
`${offset} Brussels, Copenhagen, Madrid, Paris`
)
})
it.each([
['America/New_York', '2026-01-09T03:12:00Z', '(UTC-05:00)'],
['America/New_York', '2026-10-09T03:12:00Z', '(UTC-04:00)'],
['Asia/Kolkata', '2026-10-09T03:12:00Z', '(UTC+05:30)'],
['Asia/Kathmandu', '2026-10-09T03:12:00Z', '(UTC+05:45)'],
['Europe/London', '2026-10-09T03:12:00Z', '(UTC+01:00)'],
['America/St_Johns', '2026-01-09T03:12:00Z', '(UTC-03:30)'],
['Etc/GMT', '2026-10-09T03:12:00Z', '(UTC+00:00)'],
])('formats %s offset including its sign and minutes', (zone, date, offset) => {
expect(getTimezoneLabel(getTimezone(zone), dayjs(date)).startsWith(offset)).toBe(true)
})
it('preserves the selected timezone and recovery timestamp', () => {
const timezone = getTimezone('Europe/Madrid')
const originalTimezone = structuredClone(timezone)
const recoveryDate = dayjs('2026-10-09T03:12:00Z').tz(timezone.utc[0])
const recoveryTimestamp = recoveryDate.unix()
expect(recoveryDate.format('HH:mm:ss')).toBe('05:12:00')
expect(recoveryDate.utc().format('HH:mm:ss')).toBe('03:12:00')
expect(getTimezoneLabel(timezone, recoveryDate)).toBe(
'(UTC+02:00) Brussels, Copenhagen, Madrid, Paris'
)
expect(recoveryDate.unix()).toBe(recoveryTimestamp)
expect(timezone).toEqual(originalTimezone)
})
})
describe('getTimezoneLabel at a zero offset', () => {
it('formats it as +00:00 like every other row', () => {
const utc = TIMEZONES_BY_IANA.find((entry) => entry.value === 'UTC')!
expect(getTimezoneLabel(utc, '2026-07-15T12:00:00Z')).toBe(
'(UTC+00:00) Coordinated Universal Time'
)
})
})
describe('getTimezoneLabelByIana', () => {
it('uses the offset in effect at the given date', () => {
expect(getTimezoneLabelByIana('Europe/Madrid', '2026-01-09T03:12:00Z')).toBe(
'(UTC+01:00) Brussels, Copenhagen, Madrid, Paris'
)
expect(getTimezoneLabelByIana('Europe/Madrid', '2026-10-09T03:12:00Z')).toBe(
'(UTC+02:00) Brussels, Copenhagen, Madrid, Paris'
)
})
it('defaults to the current date', () => {
expect(getTimezoneLabelByIana('Europe/Madrid')).toBe(
getTimezoneLabel(getTimezone('Europe/Madrid'), dayjs())
)
})
it('falls back to the IANA name when the zone is not in the catalog', () => {
expect(getTimezoneLabelByIana('Not/A/Real_Zone')).toBe('Not/A/Real_Zone')
})
})