/* * Copyright 2022 Palantir Technologies, Inc. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import type { TimezoneWithNames } from "./timezoneTypes"; export const TimezoneDisplayFormat = { /** * Short name format: "HST", "EDT", etc. * Falls back to "GMT+/-offset" if there is no commonly used abbreviation. */ ABBREVIATION: "abbreviation" as const, /** * IANA timezone code: "Pacific/Honolulu", "America/New_York", etc. */ CODE: "code" as const, /** * Composite format: "Hawaii Time (HST) -10:00", "New York (EDT) -5:00", etc. * Omits abbreviation if there is no short name (it is redundant with offset). */ COMPOSITE: "composite" as const, /** * Long name format: "Hawaii-Aleutian Standard Time", "Eastern Daylight Time", "Coordinated Universal Time", etc. */ LONG_NAME: "long-name" as const, /** * Offset format: "-10:00", "-5:00", etc. */ OFFSET: "offset" as const, }; export type TimezoneDisplayFormat = (typeof TimezoneDisplayFormat)[keyof typeof TimezoneDisplayFormat]; /** * Formats a timezone according to the specified display format to show in the default `