AceTime

Date and time classes for Arduino supporting the IANA TZ Database time zones to convert epoch seconds to date and time components in different time zones.

MIT License

Stars
77
View Code on GitHub
Ecosystems: C++
AceTime - 0.8 - support 1-minute resolution for all Extended timezones and most Basic timezones

Published by bxparks about 5 years ago

  • 0.8
    • Handle Fri<=1 correctly in various python scripts. (#17)
    • Improve resolution of zonedb files and ZoneProcessor classes. (#18)
      • Both BasicZoneProcessor and ExtendedZoneProcessor support 1-minute
        resolutions for the AT and UNTIL fields.
      • BasicZoneProcessor (and zonedb files) support a 15-minute resolution
        for both STDOFF and DST offset fields.
      • ExtendedZoneProcessor (and zonedbx files) support one-minute
        resolution for STDOFF field and 15-minute resolution for DST offset
        (with a range of -01:00 to 02:45). (4 bits of the deltaCode
        field were given to the offsetCode field to give it the
        1-minute resolution.)
      • Regenerate zonedbx using 1-minute resolution.
    • Fix broken BasicZoneProcessor on some timezones between 1975 and
      2000. Did not handle transitions from fixed ZoneEra (RULES='-') to named
      ZoneEra (RULES=reference) or vise versa. Verified against pytz and
      Hinnant date from 1975 to 2050.
AceTime - 0.7.2 - support fixed offset RULES with '/' in FORMAT

Published by bxparks about 5 years ago

  • 0.7.2
    • Support timezones whose FORMAT contains a '/' with a fixed RULES column.
      Seems to make BasicZoneProcessor slightly smaller (20-80 bytes) and
      ExtendedZoneProcessor slightly bigger (50-100 bytes).
    • Split --granularity into --until_at_granularity and
      offset_granularity. Current zonedb files use values of 60 and 900
      respectively.
AceTime - 0.7.1 - replace TimeZone::printAbbrevTo() with getAbbrev()

Published by bxparks about 5 years ago

  • 0.7.1
    • Replace TimeZone::printAbbrevTo() with more
      flexible and useful TimeZone::getAbbrev().
AceTime - 0.7 - support DST transitions at 00:01; validate against Hinnant date library; upgrade to TZ 2019b

Published by bxparks about 5 years ago

  • 0.7
    • Change TimeZoneData to store mStdOffset and mDstOffset in units of
      one minute (instead of 15-minute increments, "code") in the off chance
      that the library supports timezones with one-minute shifts in the future.
    • Implement TimeOffset using 2 bytes (int16_t) instead of one byte
      (int8_t) to give it a resolution of one minute instead of 15 minutes.
    • Generate zoneinfo files containing AT and UNTIL timestamps with
      one-minute resolution (instead of 15-minute resolution). ZoneInfo files
      (zonedb/ and zonedbx/) remain identical in size. Flash memory
      consumption usually increases by 130 to 500 bytes, but sometimes decreases
      by 50-100 bytes. Timezones whose DST transitions occur at 00:01
      (America/Goose_Bay, America/Moncton, America/St_Johns, Asia/Gaza,
      Asia/Hebron) no longer truncate to 00:00.
    • Rename TimeOffset::forHour() to forHours() for consistency with
      forMinutes().
    • Make ExtendedZoneProcessor more memory efficient for 32-bit processors
      by packing internal fields to 4-byte boundaries.
    • Integrate C++11/14/17
      Hinnant Date library by
      creating additional tests/validation tests.
    • Upgrade zonedb and zonedbx zoneinfo files to version 2019b,
      after validating against the Hinnant date library.
    • Upgrade to pytz version 2019.2 to pickup TZ Database 2019b.
AceTime - 0.6.1 - add missing classes to doxygen docs

Published by bxparks about 5 years ago

  • 0.6.1
    • Create a second Jenkins continuous build pipeline file
      tests/JenskinfileUnitHost to use UnitHostDuino to run the unit tests
      natively on Linux. The entire set of unit tests builds and runs in 20
      seconds under UnixHostduino, compared to about 8 minutes for the single
      Nano environemnt, and 32 minutes against 4 boards (Nano, ESP8266, ESP32,
      SAMD21).
    • Fix Doxygen PREPROCESSOR so that it picks up classes which are enabled
      only on some environments (e.g. ESP8266, ESP32).
    • Add circuit schematics to OledClock and WorldClock examples.
    • Simplify logging::printf() used internally for debugging.
    • No functional change from 0.6.
AceTime - 0.6 - simplify Clock classes

Published by bxparks about 5 years ago

  • 0.6
    • Update tests to use UnixHostDuino.
    • Fix broken restore functionality in CommandLineClock. Make it work
      on Unix using UnixHostDuino. Make it work on ESP8266 and ESP32 again.
    • Update flash memory consumption numbers in zonedb/zone_infos.cpp and
      zonedbx/zone_infos.cpp.
    • Lift ace_time::common::DateStrings to just ace_time::DateStrings
      because it was the only data/time class in the common:: namespace so
      it seemed inconsistent and out of place.
    • Breaking Change Large refactoring and simplification of the
      ace_time::clock classes. Merged TimeKeeper and TimeProvider into a
      single Clock class hierarcy. Merged SystemClockSyncLoop (separate
      class) into SystemClockLoop (subclass of SystemClock) and
      SystemClockSyncCoroutine (separate class) into SystemClockCoroutine
      (subclass of SystemClock with mixin of ace_routine::Coroutine). Merged
      keepAlive() into ::loop() and ::runCoroutine() methods, so we don't
      need to worry about it separately anymore. Made SystemClockLoop use the
      non-blocking methods of Clock, making it as responsive as
      SystemClockCoroutine.
    • Add UnixClock.h which provides access to the internal Unix clock
      when using UnixHostDuino.
AceTime - v0.5.2 - support ATmega2560; pack zoneinfo files to save 2.5 - 6 kB of flash

Published by bxparks about 5 years ago

  • 0.5.2
    • Create HelloZoneManager and add it to the README.md.
    • Recommend using "Arduino MKR ZERO" board or "SparkFun SAMD21 Mini
      Breakout" board for the "SAMD21 M0 Mini" boards.
    • Pack basic::ZoneInfo, extended:ZoneInfo and related structs tighter on
      32-bit processors, saving 2.5kB on the Basic zoneinfo files and 5.6kB on
      Extended zoneinfo files.
    • Pack basic::Transition and extended::Transition tighter on 32-bit
      processors, saving 20-32 bytes on BasicZoneProcessor and
      ExtendedZoneProcessor.
    • Test and support ATmega2560 AVR processor.
    • Replace all uses of Serial with SERIAL_PORT_MONITOR for compatibility
      with boards (e.g. SAMD boards) which use SerialUSB as the serial
      monitor.
AceTime - 0.5.1 - Support SAMD21 boards

Published by bxparks over 5 years ago

  • 0.5.1 (2019-07-24, TZ DB version 2019a, beta)
    • Add documentation about the ZoneManager into USER_GUIDE.md.
    • Move DateStrings string pointers into PROGMEM, saving 42 bytes of RAM.
    • Use SERIAL_PORT_MONITOR instead of Serial everywhere for portability
      across different Arduino boards.
    • Support SAMD21 boards except for EEPROM which SAMD21 does not support.
AceTime - 0.5 - ZoneManager allows dynamic creation of TimeZone

Published by bxparks over 5 years ago

  • 0.5 (2019-07-21, TB DB version 2019a, beta)
    • Remove over-engineered SystemClockHeartbeatLoop and
      SystemClockHeartbeatLoop and replace with just a call to
      SystemClock::keepAlive().
    • Remove overly complex ManualZoneProcessor and merge most of its
      functionality directly into the TimeZone using kTypeManual. We lose
      the manual abbreviations provided by ManualZoneProcessor but the
      simplification of using just the TimeZone object without an extra object
      seems worth it.
    • Add a stable zoneId to ZoneInfo that identifies a zone. It is
      formed using a hash of the fully qualified zone name. The
      tzcompiler.py generator script will detect hash collisions and create an
      alternate hash.
    • Rename old ZoneManager as the ZoneRegistrar, and
      repurpose ZoneManager as the TimeZone factory, which keeps an internal
      cache of ZoneProcessor. TimeZone objects can be dynamically bound to
      ZoneProcessor objects using createForZoneInfo(),
      createForZoneName(), `createForZoneId().
    • Add TimeZoneData data struct to allow serialization of a TimeZone object
      as a zoneId so that it can be reconstructed using
      ZoneManger::createForTimeZoneData().
    • Rename ZoneSpecifier to ZoneProcessor to describe its functionality
      better. ZoneInfo is now passed directly into the TimeZone object using
      the TimeZone::forZoneInfo() factory method, with the ZoneProcessor
      acting as a helper object.
AceTime - 0.4 - store zoneinfo files in PROGMEM

Published by bxparks over 5 years ago

  • 0.4 (2019-07-09, TZ DB version 2019a, beta)
    • Support the less-than-or-equal syntax {dayOfWeek}<={dayOfMonth}
      appearing in version 2019b of the TZ Database which contains Rule Zion, 2005 to 20012, IN Apr, ON Fri<=1.
    • Add BasicZoneManager and ExtendedZoneManager to retrieve ZoneInfo
      from TZ Database string identifier (e.g. "America/Los_Angeles").
    • Add configuration options (ACE_TIME_USE_BASIC_PROGMEM and
      ACE_TIME_USE_EXTENDED_PROGMEM) to place zoneinfo
      files into PROGMEM to save static RAM.
AceTime - 0.3.1 - add copyright notices to source files

Published by bxparks over 5 years ago

  • 0.3.1 (2019-06-30, beta)
    • Add copyright notices on source files.
    • Fix typos and formatting of README.md and USER_GUIDE.md.
    • No functional change from 0.3.
AceTime - 0.3 - support Link entries from TZ Database

Published by bxparks over 5 years ago

  • 0.3 (2019-06-28, beta)
    • Support Link entries from TZ Database files as C++ references to
      corresponding Zone entries.
    • Add backward and etctera files from TZ Database to the tzcompiler.py
      processing. ExtendedZoneSpecifier now supports every Zone and Link
      entry in the TZ Database (except those in backzone and systemv).
    • Add better zone and link name normalization. Convert + into _PLUS_,
      all other non-alphanumeric (0-9a-zA-Z_) converted to underscore _.
    • Move validation unit tests into separate tests/validation directory.
      Use Makefiles to generate validation_data.* files dynamically at compile
      time.
AceTime - 0.2 - better handling of gaps and overlaps in wall time with some date normalization

Published by bxparks over 5 years ago

  • 0.2 (2019-06-26, alpha)
    • Reduce flash memory size of WorldClock by removing extra font.
    • Split USER_GUIDE.md from README.md.
    • Rename ace_time::provider to ace_time::clock and rename
      SystemTimeProvider to SystemClock.
    • Add HelloSystemClock example code.
    • Add isValidYear() into various forComponents() methods to check
      int8_t range of year component.
    • Rename DateStrings::weekDay*() methods to dayOfWeek*() for
      consistency.
    • Change ZonedDateTime::printTo() format to match Java Time format.
    • Remove friend declarations not related to unit tests.
    • Remove redundant definitions of kInvalidEpochSeconds, standardize on
      LocalDate::kInvalidEpochSeconds.
    • Make timeOffset a required parameter for constructors and factory
      methods OffsetDateTime instead of defaulting to TimeOffset().
    • Make timeZone a required parameter in constructors and factory methods
      of ZonedDateTime.
    • Fix BasicZoneSpecifier::getOffsetDateTime() to handle gaps and overlaps
      in a reasonable way, and perform some amount of normalization.
AceTime - 0.1 - initial release

Published by bxparks over 5 years ago

  • 0.1 (2019-06-15)
    • Initial release on GitHub to establish a reference point.
Badges
Extracted from project README
AUnit Tests Validation Tests
Related Projects
Time

Time library for Arduino

05 Sep 2014 1,252
EpoxyDuino

Compile and run Arduino programs natively on Linux, MacOS and FreeBSD.

31 Jul 2019 99
AceRoutine

A low-memory, fast-switching, cooperative multitasking library using stackless coroutines on Ardu...

12 May 2018 173