Getting started

Current time endpoint

The current_time endpoint takes a location in the form of a location name, latitude and longitude, or IP address and returns the current time, date, and timezone of that location.

Convert timezones endpoint

The convert_time endpoint makes it easy to convert the time and date of a given location to the time and date of another location. By default it converts the current time, but the conversion can take place in either the past or future with a simple parameter.

REST

The Timezones API, like all of Abstract’s APIs, is organized around REST. It is designed to use predictable, resource-oriented URLs and to use HTTP status codes to indicate errors.

HTTPS

The Timezones API requires all communications to be secured with TLS 1.2 or greater.

API Versions

All of Abstract’s API are versioned. The Timezones API is currently on Version 1.

Your API Key

Your API key is your unique authentication key to be used to access Abstract’s Timezones API. Note that each of Abstract’s APIs has a unique API key, so you will need different keys to access the Timezones and Email Validation APIs, for example. To authenticate your requests, you will need to append your API key to the base URL.

Response and error codes

Whenever you make a request that fails for some reason, an error is returned also in the JSON format. The errors include an error code and description, which you can find in detail below.

CodeTypeDetails
200OKEverything worked as expected.
204OKTheir is no location data for the submitted IP.
400Bad requestBad request.
401UnauthorizedThe request was unacceptable. Typically due to the API key missing or incorrect.
422Quota reachedThe request was aborted due to insufficient API credits. (Free plans)
429Too many requestsThe request was aborted due to the number of allowed requests per second being reached. This happens on free plans as requests are limited to 1 per second.
500Internal server errorThe request could not be completed due to an error on the server side.
503Service unavailableThe server was unavailable.

List of timezones

Timezone codeDetails
ACDTAustralian Central Daylight Saving Time
ACSTAustralian Central Standard Time
ACTAcre Time
ACTASEAN Common Time
ACWSTAustralian Central Western Standard Time
ADTAtlantic Daylight Time
AEDTAustralian Eastern Daylight Saving Time
AESTAustralian Eastern Standard Time
AETAustralian Eastern Time
AFTAfghanistan Time
AKDTAlaska Daylight Time
AKSTAlaska Standard Time
ALMTAlma-Ata Time
AMSTAmazon Summer Time
AMTAmazon Time
AMTArmenia Time
ANATAnadyr Time
AQTTAqtobe Time
ARTArgentina Time
ASTArabia Standard Time
ASTAtlantic Standard Time
AWSTAustralian Western Standard Time
AZOSTAzores Summer Time
AZOTAzores Standard Time
AZTAzerbaijan Time
BDTBrunei Time
BIOTBritish Indian Ocean Time
BITBaker Island Time
BOTBolivia Time
BRSTBrasília Summer Time
BRTBrasília Time
BSTBangladesh Standard Time
BSTBougainville Standard Time
BSTBritish Summer Time
BTTBhutan Time
CATCentral Africa Time
CCTCocos Islands Time
CDTCentral Daylight Time
CDTCuba Daylight Time
CESTCentral European Summer Time
CETCentral European Time
CHADTChatham Daylight Time
CHASTChatham Standard Time
CHOTChoibalsan Standard Time
CHOSTChoibalsan Summer Time
CHSTChamorro Standard Time
CHUTChuuk Time
CISTClipperton Island Standard Time
CITCentral Indonesia Time
CKTCook Island Time
CLSTChile Summer Time
CLTChile Standard Time
COSTColombia Summer Time
COTColombia Time
CSTCentral Standard Time
CSTChina Standard Time
CSTCuba Standard Time
CTChina Time
CVTCape Verde Time
CWSTCentral Western Standard Time
CXTChristmas Island Time
DAVTDavis Time
DDUTDumont d’Urville Time
DFTAIX-specific equivalent of Central European Time
EASSTEaster Island Summer Time
EASTEaster Island Standard Time
EATEast Africa Time
ECTEastern Caribbean Time
ECTEcuador Time
EDTEastern Daylight Time
EESTEastern European Summer Time
EETEastern European Time
EGSTEastern Greenland Summer Time
EGTEastern Greenland Time
EITEastern Indonesian Time
ESTEastern Standard Time
FETFurther-eastern European Time
FJTFiji Time
FKSTFalkland Islands Summer Time
FKTFalkland Islands Time
FNTFernando de Noronha Time
GALTGalápagos Time
GAMTGambier Islands Time
GETGeorgia Standard Time
GFTFrench Guiana Time
GILTGilbert Island Time
GITGambier Island Time
GMTGreenwich Mean Time
GSTSouth Georgia and the South Sandwich Islands Time
GSTGulf Standard Time
GYTGuyana Time
HDTHawaii–Aleutian Daylight Time
HAECHeure Avancée d’Europe Centrale French-language name for CEST
HSTHawaii–Aleutian Standard Time
HKTHong Kong Time
HMTHeard and McDonald Islands Time
HOVSTHovd Summer Time
HOVTHovd Time
ICTIndochina Time
IDLWInternational Day Line West time zone
IDTIsrael Daylight Time
IOTIndian Ocean Time
IRDTIran Daylight Time
IRKTIrkutsk Time
IRSTIran Standard Time
ISTIndian Standard Time
ISTIrish Standard Time
ISTIsrael Standard Time
JSTJapan Standard Time
KALTKaliningrad Time
KGTKyrgyzstan Time
KOSTKosrae Time
KRATKrasnoyarsk Time
KSTKorea Standard Time
LHSTLord Howe Standard Time
LHSTLord Howe Summer Time
LINTLine Islands Time
MAGTMagadan Time
MARTMarquesas Islands Time
MAWTMawson Station Time
MDTMountain Daylight Time
METMiddle European Time Same zone as CET
MESTMiddle European Summer Time Same zone as CEST
MHTMarshall Islands Time
MISTMacquarie Island Station Time
MITMarquesas Islands Time
MMTMyanmar Standard Time
MSKMoscow Time
MSTMalaysia Standard Time
MSTMountain Standard Time
MUTMauritius Time
MVTMaldives Time
MYTMalaysia Time
NCTNew Caledonia Time
NDTNewfoundland Daylight Time
NFTNorfolk Island Time
NOVTNovosibirsk Time
NPTNepal Time
NSTNewfoundland Standard Time
NTNewfoundland Time
NUTNiue Time
NZDTNew Zealand Daylight Time
NZSTNew Zealand Standard Time
OMSTOmsk Time
ORATOral Time
PDTPacific Daylight Time
PETPeru Time
PETTKamchatka Time
PGTPapua New Guinea Time
PHOTPhoenix Island Time
PHTPhilippine Time
PKTPakistan Standard Time
PMDTSaint Pierre and Miquelon Daylight Time
PMSTSaint Pierre and Miquelon Standard Time
PONTPohnpei Standard Time
PSTPacific Standard Time
PSTPhilippine Standard Time
PYSTParaguay Summer Time
PYTParaguay Time
RETRéunion Time
ROTTRothera Research Station Time
SAKTSakhalin Island Time
SAMTSamara Time
SASTSouth African Standard Time
SBTSolomon Islands Time
SCTSeychelles Time
SDTSamoa Daylight Time
SGTSingapore Time
SLSTSri Lanka Standard Time
SRETSrednekolymsk Time
SRTSuriname Time
SSTSamoa Standard Time
SSTSingapore Standard Time
SYOTShowa Station Time
TAHTTahiti Time
THAThailand Standard Time
TFTFrench Southern and Antarctic Time
TJTTajikistan Time
TKTTokelau Time
TLTTimor Leste Time
TMTTurkmenistan Time
TRTTurkey Time
TOTTonga Time
TVTTuvalu Time
ULASTUlaanbaatar Summer Time
ULATUlaanbaatar Standard Time
UTCCoordinated Universal Time
UYSTUruguay Summer Time
UYTUruguay Standard Time
UZTUzbekistan Time
VETVenezuelan Standard Time
VLATVladivostok Time
VOLTVolgograd Time
VOSTVostok Station Time
VUTVanuatu Time
WAKTWake Island Time
WASTWest Africa Summer Time
WATWest Africa Time
WESTWestern European Summer Time
WETWestern European Time
WITWestern Indonesian Time
WGSTWest Greenland Summer Time
WGTWest Greenland Time
WSTWestern Standard Time
YAKTYakutsk Time
YEKTYekaterinburg Time