Skip to content

A better Java library for determining Olson TZ Database time zones from latitude and longitude

License

Notifications You must be signed in to change notification settings

JimHaughwout/java-tzwhere

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

java-tzwhere

A better Java library for determining Olson TZ Database time zones from latitude and longitude.

Rationale

Existing Java implementations of timezone lookup (that we could find) were either inefficient (i.e., not indexed) or not packaged for reproducable builds, updates, and consumption. The goal of this project is to provide an efficient Java timezone lookup using standard Java tools and techniques.

Technique

Currently, the tool loads and indexes the tz_world shapefiles on initialization. It uses Geotools for shapefile handling and JTS for spatial indexing with their Sort-Tile-Recursive R-Tree implementation.

Caveats

Timezones at Sea

The tz_world data is limited to only timezones on land. We'd like to add territorial waters, but we need shapes first.

TODOs

  • Improved documentation and examples
  • Added test coverage and configuration for automated CI
  • Publication to Maven Central

About

A better Java library for determining Olson TZ Database time zones from latitude and longitude

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%