API pro časové zóny
TimeZone API je sada funkcí určených pro práci s časovými zónami. Umožňuje získávat informace o časových pásmech na základě zeměpisných souřadnic nebo IANA kódů (např. Europe/Prague). Tyto funkce jsou potřebné pro vývojáře, kteří pracují s lokálním časem nebo UTC časem po celém světě.
- Vyhledávání podle souřadnic: Získejte časovou zónu a informace o čase v ním zadáním zeměpisné šířky a délky.
- Vyhledávání podle IANA kódu: Získejte detaily časové zóny pomocí jejího IANA názvu.
- Konverze časů: Převádějte časy mezi různými časovými zónami nebo mezi lokálním časem a UTC.
- Aktuální čas: Zjistěte aktuální čas v libovolné časové zóně.
- Plánování a časové rozdíly: Vypočítejte časové rozdíly pro plánování událostí napříč časovými pásmy.
Příklady použití:
– Zjistěte aktuální čas v New Yorku
– Přepočítejte otvírací dobu pobočky v Tokiu na lokální čas v ČR
– Zobrazte lokální čas startu a místní časový posun pro GPX záznamy tras různě po světě.
Na konkrétní příklad použití se podívejte v tomto tutoriálu.
Popis funkcí
- list-timezones – funkce vrátí seznam IANA názvů všech časových zón
- timezone – vrátí podrobné informace o časové zóně – vstupním parametrem je IANA název
- coordinate – vrátí podrobné informace o časové zóně na daných souřadnicích – vstupem jsou souřadnice
Technická dokumentace
https://api.mapy.cz/v1/docs/timezone/
Technická dokumentace obsahuje přesný popis vstupních a výstupních parametrů, výchozích hodnot, chyby a další podrobnosti.
Návratové hodnoty timezone a coordinate
Obě tyto funkce vrací detailní informace o časové zóně
| timezoneName | IANA název časové zóny (např. Europe/Prague) |
| currentTimeAbbreviation | Aktuální zkratka časové zóny (např. CEST) |
| standardTimeAbbreviation | Zkratka standardního času (např. CET) |
| currentLocalTime | Aktuální místní čas ve formátu ISO 8601 (např. 2024-10-16T15:03:51.248) |
| currentUtcTime | Aktuální UTC čas ve formátu ISO 8601 (např. 2024-10-16T13:03:51.248Z) |
| currentUtcOffsetSeconds | Aktuální posun od UTC v sekundách (např. 7200) |
| standardUtcOffsetSeconds | Standardní posun od UTC v sekundách (např. 3600) |
| hasDst | Indikátor, zda časová zóna používá letní čas (true/false) |
| isDstActive | Indikátor, zda je aktuálně aktivní letní čas (true/false) |
| dstInfo.dstAbbreviation | Zkratka letního času (např. CEST) |
| dstInfo.dstStartUtcTime | UTC čas začátku letního času ve formátu ISO 8601 (např. 2024-03-31T01:00:00.000Z) |
| dstInfo.dstStartLocalTime | Místní čas začátku letního času ve formátu ISO 8601 (např. 2024-03-31T03:00:00.000) |
| dstInfo.dstEndUtcTime | UTC čas konce letního času ve formátu ISO 8601 (např. 2024-10-27T01:00:00.000Z) |
| dstInfo.dstEndLocalTime | Místní čas konce letního času ve formátu ISO 8601 (např. 2024-10-27T02:00:00.000) |
| dstInfo.dstOffsetSeconds | Posun letního času od standardního času v sekundách (např. 3600) |
| dstInfo.dstDurationSeconds | Doba trvání letního času v sekundách (např. 18144000) |