Improved time encoding and decoding

[rbeyer]

• The ODLDecoder:

  • May return a "naive" time object if not timezone specifier is present in the PVL-text
  • Will raise an exception if there is a seconds value of 60

• The ODLEncoder will raise an exception if given a "naive" time object.

• The PDSLabel Decoder:

  • PVL-text Times with a timezone specifier like +HH:MM will raise an exception.
  • PVL-text Times with precision better than milisecond will raise an exception.
  • PVL-text Times with no timezone specifier are assumed to be UTC.
  • Returned time objects will always be "aware" and have a timezone of UTC.

• The PVLEncoder will raise an exception if given a time value with better than milisecond precision.

Fixed so that PDS3 handling will not allow a time string with a timezone offset, and will not deal with time precisions better than miliseconds.

Description

The ODL decoder will now return either "naive" or "aware" time and datetime objects, as appropriate.

Fixed so that PDS3 handling will not allow a time string with a timezone offset, and will properly raise exceptions if asked to deal with time precisions better than miliseconds (although ODL handling still allows microsecond precision).

Related Issue

This would close #80.

How Has This Been Tested?

• make lint
• make docs
• make test-all

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)

Checklist:

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• All new and existing tests passed.

Licensing:

This project is released under the LICENSE.

• I claim copyrights on my contributions in this pull request, and I provide those contributions via this pull request under the same license terms that the pvl project uses.